update docs

Author: waruqi

docs/api/description/builtin-policies.md

@@ -268,6 +268,14 @@ We can also turn it on quickly via the command line option.
 $ xmake f --policies=build.optimization.lto
 ```
 
+## build.c++.dynamic_debugging <Badge type="tip" text="v3.0.6" />
+
+Enable C++ Dynamic Debugging for MSVC (requires MSVC toolset 14.44+, x64 only, incompatible with LTCG/PGO/OPT-ICF).
+
+```lua
+set_policy("build.c++.dynamic_debugging", true)
+```
+
 ## build.cuda.devlink <Badge type="tip" text="v2.7.7" />
 
 Version 2.7.7 can be configured to show that device links to specific targets are turned on.

docs/api/description/builtin-rules.md

@@ -324,11 +324,49 @@ Used to compile and generate ios/macos applications
 
 ```lua
 target("test")
-     add_rules("xcode.application")
-     add_files("src/*.m", "src/**.storyboard", "src/*.xcassets")
-     add_files("src/Info.plist")
+    add_rules("xcode.application")
+    add_files("src/*.m", "src/**.storyboard", "src/*.xcassets")
+    add_files("src/Info.plist")
 ```
 
+## android.native_app
+
+Used to build Android Native applications.
+
+```lua
+add_rules("mode.debug", "mode.release")
+
+add_requires("raylib 5.5.0")
+
+target("raydemo_custom_glue")
+    set_kind("binary")
+    set_languages("c++17")
+    add_files("src/main.cpp", "src/android_native_app_glue.c")
+    add_syslinks("log")
+    add_packages("raylib")
+    add_rules("android.native_app", {
+        android_sdk_version = "35",
+        android_manifest = "android/AndroidManifest.xml",
+        android_res = "android/res",
+        keystore = "android/debug.jks",
+        keystore_pass = "123456",
+        package_name = "com.raylib.custom_glue",
+        native_app_glue = false, -- Disable default glue
+        logcat_filters = {"raydemo_custom_glue", "raylib"}
+    })
+```
+
+### Parameter Description
+
+- `android_sdk_version`: Set Android SDK version
+- `android_manifest`: Set AndroidManifest.xml file path
+- `android_res`: Set resource directory
+- `keystore`: Set signing keystore file
+- `keystore_pass`: Set signing keystore password
+- `package_name`: Set package name
+- `native_app_glue`: Whether to use the default `android_native_app_glue` library, default is true. If set to false, you need to handle the entry and event loop yourself.
+- `logcat_filters`: Set logcat filter keywords
+
 ## wdk.env.kmdf
 
 Application of the compilation environment setting of kmdf under WDK, need to cooperate with: `wdk.[driver|binary|static|shared]` and other rules to use.
@@ -616,6 +654,52 @@ cat build/.gens/test/macosx/x86_64/release/rules/c++/bin2c/image.png.h
 If you are using a compiler that supports the C23 `#embed` feature (such as clang or gcc), you can also use the `#embed` directive directly to embed binary files. You need to set the C23 language standard first via `set_languages("c23")`, and then use [add_embeddirs](project-target.md#add_embeddirs) to set the search path. This approach is more aligned with the C23 standard and does not require generating additional header files.
 :::
 
+## utils.bin2obj
+
+New rule added in v3.0.6 to convert binary files to object files and link them into the target program.
+
+Compared to `utils.bin2c`, it generates object files directly, skipping the generation of C header files, so it is faster when dealing with large files.
+
+For example, embedding a 120MB file:
+- `utils.bin2c`: 354s
+- `utils.bin2obj`: 1.8s
+
+### Usage
+
+```lua
+target("myapp")
+    set_kind("binary")
+    add_rules("utils.bin2obj", {extensions = {".bin", ".ico"}})
+    add_files("src/*.c")
+    -- Embed data.bin and ensure it is zero-terminated
+    add_files("assets/data.bin", {zeroend = true})
+```
+
+### Access Data
+
+In C/C++ code, we can access the embedded data via symbols. The symbol name generation rule is: `_binary_<filename>_start` and `_binary_<filename>_end`.
+Non-alphanumeric characters in the filename are replaced with underscores.
+
+```c
+#include <stdio.h>
+#include <stdint.h>
+
+extern const uint8_t _binary_data_bin_start[];
+extern const uint8_t _binary_data_bin_end[];
+
+int main() {
+    // Calculate size
+    const uint32_t size = (uint32_t)(_binary_data_bin_end - _binary_data_bin_start);
+    
+    // Access data
+    printf("Data size: %u bytes\n", size);
+    for (uint32_t i = 0; i < size; i++) {
+        printf("%02x ", _binary_data_bin_start[i]);
+    }
+    return 0;
+}
+```
+
 ## utils.glsl2spv
 
 This rule can be used in v2.6.1 and above. Import glsl shader files such as `*.vert/*.frag` into the project, and then realize automatic compilation to generate `*.spv` files.

docs/api/scripts/extension-modules/core/base/tty.md

@@ -442,6 +442,37 @@ local term = tty.term()
 print("Terminal:", term)  -- Output: "xterm", "vscode", etc.
 ```
 
+## tty.session_id
+
+- Get terminal session ID
+
+#### Function Prototype
+
+::: tip API
+```lua
+tty.session_id()
+```
+:::
+
+#### Parameter Description
+
+No parameters
+
+#### Return Value
+
+| Type | Description |
+|------|-------------|
+| string | Returns the terminal session ID |
+
+#### Usage
+
+```lua
+import("core.base.tty")
+
+local session_id = tty.session_id()
+print("Session ID:", session_id)
+```
+
 ## tty.has_emoji
 
 - Check if terminal supports emoji

docs/guide/extensions/builtin-plugins.md

@@ -722,6 +722,9 @@ This plug-in can help users quickly generate installation packages and source co
 - RPM binary installation package
 - SRPM source code installation package
 - DEB binary installation package
+- MacOS App Bundle (Dmg)
+- Linux AppImage installation package
+- Qt installation package
 
 Here is a complete example, we can take a brief look at it first:
 
@@ -1033,6 +1036,58 @@ xpack("test")
      -- TODO
 ```
 
+### Generate MacOS App Bundle (Dmg) <Badge type="tip" text="v3.0.6" />
+
+```lua
+xpack("test")
+    set_formats("dmg")
+    add_targets("demo")
+```
+
+### Generate AppImage installation package <Badge type="tip" text="v3.0.6" />
+
+Requires `appimagetool` to be installed.
+
+```lua
+xpack("test")
+    set_formats("appimage")
+    add_targets("demo")
+```
+
+### Generate Qt installation package <Badge type="tip" text="v3.0.6" />
+
+We support generating Qt installation packages, such as `qtinstaller`, `qtdmg`, `qtzip`, etc. It will automatically call `windeployqt`/`macdeployqt`/`linuxdeployqt` to deploy the required Qt libraries.
+
+#### Open Installer Framework (Qt)
+
+Requires `Qt` SDK to be installed.
+
+```lua
+xpack("test")
+    set_formats("qtinstaller")
+    add_targets("demo")
+```
+
+#### Drag-and-Drop (Qt)
+
+Requires `Qt` SDK to be installed.
+
+```lua
+xpack("test")
+    set_formats("qtdmg")
+    add_targets("demo")
+```
+
+#### Zip (Qt)
+
+Requires `Qt` SDK to be installed.
+
+```lua
+xpack("test")
+    set_formats("qtzip")
+    add_targets("demo")
+```
+
 ### Packaging command
 
 #### Specify packaging format

docs/posts/xmake-update-v3.0.6.md

@@ -165,6 +165,16 @@ $ xmake check syntax
 
 If there are syntax errors, it will report the specific file and line number.
 
+### MSVC C++ Dynamic Debugging
+
+We have added support for C++ dynamic debugging in MSVC (requires MSVC toolset 14.44+, x64 only).
+
+It is incompatible with LTCG/PGO/OPT-ICF.
+
+```lua
+set_policy("build.c++.dynamic_debugging", true)
+```
+
 ---
 
 ## Changelog

docs/zh/api/description/builtin-policies.md

@@ -261,6 +261,14 @@ set_policy("build.optimization.lto", true)
 $ xmake f --policies=build.optimization.lto
 ```
 
+## build.c++.dynamic_debugging <Badge type="tip" text="v3.0.6" />
+
+启用 MSVC 的 C++ 动态调试功能（需要 MSVC 工具集 14.44+，仅 x64，与 LTCG/PGO/OPT-ICF 不兼容）。
+
+```lua
+set_policy("build.c++.dynamic_debugging", true)
+```
+
 ## build.cuda.devlink <Badge type="tip" text="v2.7.7" />
 
 2.7.7 版本可以通过这个配置，显示开启对特定目标的设备链接。

docs/zh/api/description/builtin-rules.md

@@ -332,6 +332,44 @@ target("test")
     add_files("src/Info.plist")
 ```
 
+## android.native_app
+
+用于构建 Android Native 应用程序。
+
+```lua
+add_rules("mode.debug", "mode.release")
+
+add_requires("raylib 5.5.0")
+
+target("raydemo_custom_glue")
+    set_kind("binary")
+    set_languages("c++17")
+    add_files("src/main.cpp", "src/android_native_app_glue.c")
+    add_syslinks("log")
+    add_packages("raylib")
+    add_rules("android.native_app", {
+        android_sdk_version = "35",
+        android_manifest = "android/AndroidManifest.xml",
+        android_res = "android/res",
+        keystore = "android/debug.jks",
+        keystore_pass = "123456",
+        package_name = "com.raylib.custom_glue",
+        native_app_glue = false, -- 禁用默认 glue
+        logcat_filters = {"raydemo_custom_glue", "raylib"}
+    })
+```
+
+### 参数说明
+
+- `android_sdk_version`: 设置 Android SDK 版本
+- `android_manifest`: 设置 AndroidManifest.xml 文件路径
+- `android_res`: 设置资源目录
+- `keystore`: 设置签名密钥文件
+- `keystore_pass`: 设置签名密钥密码
+- `package_name`: 设置包名
+- `native_app_glue`: 是否使用默认的 `android_native_app_glue` 库，默认为 true。如果设置为 false，则需要自己处理入口和事件循环。
+- `logcat_filters`: 设置 logcat 过滤关键字
+
 ## wdk.env.kmdf
 
 应用WDK下kmdf的编译环境设置，需要配合：`wdk.[driver|binary|static|shared]`等规则来使用。
@@ -605,6 +643,53 @@ cat build/.gens/test/macosx/x86_64/release/rules/c++/bin2c/image.png.h
 如果你使用支持 C23 `#embed` 特性的编译器（如 clang 或 gcc），也可以直接使用 `#embed` 指令来嵌入二进制文件。需要先通过 `set_languages("c23")` 设置 C23 语言标准，然后使用 [add_embeddirs](project-target.md#add_embeddirs) 来设置搜索路径。这种方式更符合 C23 标准，无需生成额外的头文件。
 :::
 
+## utils.bin2obj
+
+v3.0.6 以上版本可以使用此规则，相比 `utils.bin2c` 具有极快的构建速度。因为它跳过了 C 代码生成和编译步骤，直接生成对象文件（COFF, ELF, Mach-O）参与链接。
+
+**性能对比 (120MB 文件):**
+- **bin2obj**: ~1.8s
+- **bin2c**: ~354s
+
+它支持多种架构（x86, ARM, RISC-V 等）和格式（Windows COFF, Linux/Android ELF, macOS/iOS Mach-O）。
+
+**基本用法**
+
+```lua
+target("myapp")
+    set_kind("binary")
+    add_rules("utils.bin2obj", {extensions = {".bin", ".ico"}})
+    add_files("src/*.c")
+    -- 嵌入 data.bin，并确保以零结尾
+    add_files("assets/data.bin", {zeroend = true})
+```
+
+**在 C/C++ 中访问数据**
+
+符号名称会根据文件名自动生成（例如 `_binary_<filename>_start` 和 `_binary_<filename>_end`）。
+
+```c
+#include <stdio.h>
+#include <stdint.h>
+
+extern const uint8_t _binary_data_bin_start[];
+extern const uint8_t _binary_data_bin_end[];
+
+int main() {
+    // 计算大小
+    const uint32_t size = (uint32_t)(_binary_data_bin_end - _binary_data_bin_start);
+    
+    // 访问数据
+    printf("Data size: %u bytes\n", size);
+    for (uint32_t i = 0; i < size; i++) {
+        printf("%02x ", _binary_data_bin_start[i]);
+    }
+    return 0;
+}
+```
+
+此外，`glsl2spv` 和 `hlsl2spv` 规则也新增了对 `bin2obj` 的支持，可以直接将编译后的 SPIR-V 文件作为对象文件嵌入。
+
 ## utils.glsl2spv
 
 v2.6.1 以上版本可以使用此规则，在项目中引入 `*.vert/*.frag` 等 glsl shader 文件，然后实现自动编译生成 `*.spv` 文件。

docs/zh/api/scripts/extension-modules/core/base/tty.md

@@ -442,6 +442,37 @@ local term = tty.term()
 print("终端:", term)  -- 输出: "xterm"、"vscode" 等
 ```
 
+## tty.session_id
+
+- 获取终端会话 ID
+
+#### 函数原型
+
+::: tip API
+```lua
+tty.session_id()
+```
+:::
+
+#### 参数说明
+
+无参数
+
+#### 返回值说明
+
+| 类型 | 描述 |
+|------|------|
+| string | 返回终端会话 ID |
+
+#### 用法说明
+
+```lua
+import("core.base.tty")
+
+local session_id = tty.session_id()
+print("会话 ID:", session_id)
+```
+
 ## tty.has_emoji
 
 - 检查终端是否支持表情符号