cj-tauri 1.1.2 → 2.0.0

package/cli/templates/app-vue/cjpm.toml

@@ -1,17 +1,34 @@
-[package]
-  cjc-version = "{{CJC_VERSION}}"
-  name = "{{PACKAGE_NAME}}"
-  description = "{{PROJECT_NAME}} - cj-tauri 应用（Vue 3 + Vite 前端）"
-  version = "0.1.0"
-  target-dir = ""
-  output-type = "executable"
-  compile-option = ""
-  override-compile-option = ""
-  link-option = ""
-  package-configuration = {}
-
-[dependencies]
-  # cj-tauri 框架本体（由 cj-tauri create 写入的本机路径）
-  cjTauri = { path = "{{FRAMEWORK_ROOT_TOML}}" }
-
-{{TARGET_SECTION}}
+# 业务包：业务代码的唯一真相（RFC-002 §7.3——骨架永远是外壳，业务只有一份）。
+# output-type = "static"：桌面骨架（targets/desktop）与鸿蒙入口（targets/ohos/entry）
+# 都以 path 依赖引用本包——同一份业务代码，多个目标各编各的产物。
+[package]
+  cjc-version = "{{CJC_VERSION}}"
+  name = "{{PACKAGE_NAME}}"
+  description = "{{PROJECT_NAME}} - cj-tauri 业务包"
+  version = "0.1.0"
+  target-dir = ""
+  output-type = "static"
+  compile-option = ""
+  override-compile-option = ""
+  link-option = ""
+  package-configuration = {}
+
+[dependencies]
+  # cj-tauri 框架本体（由 cj-tauri create 写入的本机路径；换机器重跑 create 或手改）
+  cjTauri = { path = "{{FRAMEWORK_ROOT_TOML}}" }
+
+[target.x86_64-unknown-linux-gnu.bin-dependencies]
+    path-option = ["${CANGJIE_STDX}"]
+
+[target.x86_64-w64-mingw32.bin-dependencies]
+    path-option = ["${CANGJIE_STDX}"]
+
+[target.aarch64-linux-ohos]
+  # 鸿蒙目标：交叉编译工具链与 sysroot 由 DevEco 仓颉套件提供，路径全部走环境变量
+  # （与框架根 cjpm.toml 同口径；末尾 --dy-std 不可省，原因见框架根 toml 的鸿蒙段注释）
+  compile-option = "-B \"${DEVECO_CANGJIE_HOME}/build-tools/third_party/llvm/bin\" -B \"${DEVECO_OH_NATIVE_HOME}/sysroot/usr/lib/aarch64-linux-ohos\" -L \"${DEVECO_OH_NATIVE_HOME}/sysroot/usr/lib/aarch64-linux-ohos\" -L \"${DEVECO_OH_NATIVE_HOME}/llvm/lib/clang/15.0.4/lib/aarch64-linux-ohos\" -L \"${DEVECO_OH_NATIVE_HOME}/llvm/lib/aarch64-linux-ohos\" --sysroot \"${DEVECO_OH_NATIVE_HOME}/sysroot\" --dy-std"
+
+[target.aarch64-linux-ohos.bin-dependencies]
+    # stdx 必须用鸿蒙版（CANGJIE_STDX_OHOS，桌面版 ABI 不通）；CANGJIE_OHOS_LIBS 指 DevEco
+    # 套件的 api/lib/linux_ohos_aarch64_cjnative/ohos（仓颉标准库 + ohos API 绑定）
+    path-option = ["${CANGJIE_STDX_OHOS}", "${CANGJIE_OHOS_LIBS}", "${AARCH64_MACRO_LIBS}", "${AARCH64_KIT_LIBS}"]

package/cli/templates/app-vue/src/main.cj

@@ -1,102 +1,91 @@
-package {{PACKAGE_NAME}}
-
-import cjTauri.*
-import stdx.encoding.json.*
-import std.fs.*
-import std.collection.*
-
-/**
- * greet 命令（对标 tauri command）
- * 前端：tauri.invoke("greet", { name: "..." })
- */
-public class GreetCommand <: CommandHandler {
-    public init() {}
-
-    public func handle(cmd: String, args: JsonObject, ipc: IpcContext): JsonValue {
-        var name = "world"
-        if (let Some(n) <- args.get("name")) {
-            match (n.kind()) {
-                case JsonKind.JsString => name = n.asString().getValue()
-                case _ => ()
-            }
-        }
-        return JsonString("Hello, ${name}! 来自仓颉后端")
-    }
-}
-
-/**
- * 定时器命令：启动后台线程，每秒向后端推一个 tick 事件（验证 仓颉 → JS 通道）
- * 前端：tauri.listen("tick", cb) + tauri.invoke("timer")
- */
-public class TimerCommand <: CommandHandler {
-    private var counter: Int64 = 0
-    private var started: Bool = false
-
-    public init() {}
-
-    public func handle(cmd: String, args: JsonObject, ipc: IpcContext): JsonValue {
-        if (!this.started) {
-            this.started = true
-            spawn {
-                while (true) {
-                    sleep(Duration.second)
-                    this.counter += 1
-                    var payload = JsonObject()
-                    payload.put("n", JsonInt(this.counter))
-                    ipc.emit("tick", payload)
-                }
-            }
-        }
-        return JsonString("timer started")
-    }
-}
-
-/**
- * 演示菜单：一个普通项 + 一个带勾选项的子菜单
- *
- * 两个方向都在页面上看得到：
- *   菜单 → 页面：点「打个招呼」，宿主把事件推给前端（页面 listen("menu:click") 显示 id）
- *   页面 → 菜单：勾选页面上的复选框，走 menu 插件改「侧边栏」这一项的勾选状态
- */
-func demoMenu(): MenuModel {
-    var view = ArrayList<MenuItem>()
-    view.add(MenuItem.checkbox("view.sidebar", "侧边栏", true))
-    var items = ArrayList<MenuItem>()
-    items.add(MenuItem.normal("file.hello", "打个招呼"))
-    items.add(MenuItem.submenu("视图", view))
-    return MenuModel(items)
-}
-
-main(): Int64 {
-    // 1) 装配应用（对标 tauri::Builder）：窗口配置 + 注册命令
-    //    能力清单由框架在 run() 时自动扫描 capabilities/ 目录（对标 Tauri 的 capabilities 目录）
-    let app = TauriApp()
-        .window(WindowConfig("{{PROJECT_NAME}}", 1000, 700))
-        .register("greet", GreetCommand())
-        .register("timer", TimerCommand())
-        // menu 插件：给前端挂 window.__CJ_TAURI__.menu.setEnabled / setChecked
-        // （插件只声明「我提供什么」，**不自动放行**——要能调，就在 capabilities 里引用
-        //   permissions: ["menu:state"]，或逐条写 commands）
-        .plugin(MenuPlugin())
-        // 菜单栏必须在 run() / runUrl() 之前挂：预置类宿主能力要赶在页面加载前定稿
-        .setMenu(demoMenu())
-
-    // 2) 页面来源二选一，对应本模板的两种跑法：
-    //    dev  : cj-tauri dev 起了 Vite dev server 并注入 CJ_TAURI_DEV_URL
-    //           → 页面来自真实 URL，改 .vue 保存即热更新，应用不用重启
-    //    发布 : 读 Vite 打出来的单文件 ui/dist/index.html（js/css 已内联，无外部依赖）
-    if (let Some(url) <- TauriApp.devUrl()) {
-        eprintln("[app] dev 模式，页面来自 ${url}")
-        app.runUrl(url)
-    } else {
-        let dist = "ui/dist/index.html"
-        if (!exists(dist)) {
-            eprintln("[app] 找不到 ${dist}")
-            eprintln("      开发: 在项目根跑 cj-tauri dev（会自动 npm install + 起 dev server）")
-            eprintln("      发布: cd ui && npm run build")
-            return 1
-        }
-        app.run(String.fromUtf8(File.readFrom(dist)))
-    }
-    return 0
-}
+package {{PACKAGE_NAME}}
+
+import cjTauri.*
+import cjTauri.plugins.menu.*
+import stdx.encoding.json.*
+import std.collection.*
+
+/**
+ * greet 命令（对标 tauri command）
+ * 前端：tauri.invoke("greet", { name: "..." })
+ */
+public class GreetCommand <: CommandHandler {
+    public init() {}
+
+    public func handle(cmd: String, args: JsonObject, ipc: IpcContext): JsonValue {
+        var name = "world"
+        if (let Some(n) <- args.get("name")) {
+            match (n.kind()) {
+                case JsonKind.JsString => name = n.asString().getValue()
+                case _ => ()
+            }
+        }
+        return JsonString("Hello, ${name}! 来自仓颉后端")
+    }
+}
+
+/**
+ * 定时器命令：启动后台线程，每秒向前端推一个 tick 事件（验证 仓颉 → JS 通道）
+ * 前端：tauri.listen("tick", cb) + tauri.invoke("timer")
+ */
+public class TimerCommand <: CommandHandler {
+    private var counter: Int64 = 0
+    private var started: Bool = false
+
+    public init() {}
+
+    public func handle(cmd: String, args: JsonObject, ipc: IpcContext): JsonValue {
+        if (!this.started) {
+            this.started = true
+            spawn {
+                while (true) {
+                    sleep(Duration.second)
+                    this.counter += 1
+                    var payload = JsonObject()
+                    payload.put("n", JsonInt(this.counter))
+                    ipc.emit("tick", payload)
+                }
+            }
+        }
+        return JsonString("timer started")
+    }
+}
+
+/**
+ * 演示菜单：一个普通项 + 一个带勾选项的子菜单
+ *
+ * 两个方向都在页面上看得到：
+ *   菜单 → 页面：点「打个招呼」，宿主把事件推给前端（页面 listen("menu:click") 显示 id）
+ *   页面 → 菜单：勾选页面上的复选框，走 menu 插件改「侧边栏」这一项的勾选状态
+ */
+func demoMenu(): MenuModel {
+    var view = ArrayList<MenuItem>()
+    view.add(MenuItem.checkbox("view.sidebar", "侧边栏", true))
+    var items = ArrayList<MenuItem>()
+    items.add(MenuItem.normal("file.hello", "打个招呼"))
+    items.add(MenuItem.submenu("视图", view))
+    return MenuModel(items)
+}
+
+/**
+ * 业务装配点（RFC-002 §4.1）：骨架的 launcher（targets/ 下各目标的 src）调用它取 AppSpec。
+ *
+ * 零平台知识：不碰宿主、不知道页面文件路径、不知道能力目录——那些由清单
+ * （cj-tauri.toml）决定，launcher 按清单覆盖（page/window/assets/capabilities）。
+ * dev 模式页面来自 Vite dev server（框架按 CJ_TAURI_DEV_URL 自动改写），
+ * 发布构建加载 assets/ui/dist 的单文件产物——两种跑法业务代码完全一致。
+ */
+public func build(): AppSpec {
+    return AppSpec()
+        .window(WindowConfig("{{PROJECT_NAME}}", 1000, 700))
+        // menu 插件：给前端挂 window.__CJ_TAURI__.menu.setEnabled / setChecked
+        // （插件只声明「我提供什么」，**不自动放行**——要能调，就在 capabilities 里引用
+        //   permissions: ["menu:state"]，或逐条写 commands）
+        .plugin(MenuPlugin())
+        .wire({ app =>
+            app.register("greet", GreetCommand())
+            app.register("timer", TimerCommand())
+            // 菜单栏必须在 run 之前挂：预置类宿主能力要赶在页面加载前定稿
+            app.setMenu(demoMenu())
+        })
+}

package/cli/templates/{ohos-pc → ohos-skeleton}/AppScope/app.json5

@@ -1,13 +1,13 @@
-{
-  "app": {
-    /* bundleName 是应用在设备上的唯一 ID：两个应用写同一个 bundleName 会互相覆盖安装。
-       改它必须重新签名——DevEco 的「自动签名」会按新包名重新申请 profile。 */
-    "bundleName": "{{BUNDLE_NAME}}",
-    "vendor": "{{PROJECT_NAME}}",
-    "versionCode": 1000000,
-    "versionName": "1.0.0",
-    "buildVersion": "1",
-    "icon": "$media:layered_image",
-    "label": "$string:app_name"
-  }
-}
+{
+  "app": {
+    /* bundleName 是应用在设备上的唯一 ID：两个应用写同一个 bundleName 会互相覆盖安装。
+       改它必须重新签名——DevEco 的「自动签名」会按新包名重新申请 profile。 */
+    "bundleName": "{{BUNDLE_NAME}}",
+    "vendor": "{{PROJECT_NAME}}",
+    "versionCode": 1000000,
+    "versionName": "1.0.0",
+    "buildVersion": "1",
+    "icon": "$media:layered_image",
+    "label": "$string:app_name"
+  }
+}

package/cli/templates/{ohos-pc → ohos-skeleton}/AppScope/resources/base/element/string.json

@@ -1,8 +1,8 @@
-{
-  "string": [
-    {
-      "name": "app_name",
-      "value": "{{APP_LABEL}}"
-    }
-  ]
-}
+{
+  "string": [
+    {
+      "name": "app_name",
+      "value": "{{APP_LABEL}}"
+    }
+  ]
+}

package/cli/templates/{ohos-pc → ohos-skeleton}/AppScope/resources/base/media/layered_image.json

@@ -1,6 +1,6 @@
-{
-  "layered-image": {
-    "background": "$media:background",
-    "foreground": "$media:foreground"
-  }
-}
+{
+  "layered-image": {
+    "background": "$media:background",
+    "foreground": "$media:foreground"
+  }
+}

package/cli/templates/{ohos-pc → ohos-skeleton}/README.md

@@ -1,79 +1,79 @@
-# {{PROJECT_NAME}} — 仓颉 + ArkWeb 鸿蒙 PC 应用
-
-用 [cj-tauri](https://atomgit.com/qq8864/cj-tauri) 生成的鸿蒙 PC（2in1）应用工程：
-**仓颉后端（静态编译）+ 系统 ArkWeb 前端（HTML/CSS/JS）**，IPC、能力校验、命令分发与桌面版同一套框架代码。
-
-## 目录
-
-```
-{{PROJECT_NAME}}/
-├─ AppScope/app.json5               应用级配置（bundleName = {{BUNDLE_NAME}}）
-├─ build-profile.json5              工程级构建配置（签名留空，见下）
-├─ build-hap.sh                     构建入口（编 hap / 装到设备）
-├─ entry/
-│  ├─ cjpm.toml                     cjTauri 依赖 + aarch64-linux-ohos 目标段
-│  ├─ build-profile.json5           cangjieOptions.checkDeviceTypes=false（放行 2in1）
-│  └─ src/main/
-│     ├─ module.json5               deviceTypes: 2in1 / tablet / phone
-│     ├─ cangjie/
-│     │  ├─ ability_stage.cj        AbilityStage
-│     │  ├─ main_ability.cj         UIAbility：沙箱、rawfile 读取、窗口尺寸、loadContent
-│     │  ├─ index.cj                ArkWeb 宿主组件（javaScriptProxy 双向桥）
-│     │  └─ app_host.cj             框架装配 + demo 命令（greet / timer）
-│     └─ resources/rawfile/
-│        ├─ index.html              页面（改这里）
-│        └─ capabilities.json       能力清单（改这里）
-```
-
-页面与能力清单是 **hap 里的真文件**（rawfile），运行期由 Ability 读成字符串交给框架——
-所以 DevEco 里直接点 Build 也能编过，不需要先跑生成脚本。
-
-## 构建 / 装到设备
-
-```bash
-# 1) 鸿蒙版 stdx（构建期要链它）
-export CANGJIE_STDX_OHOS=<stdx>/linux_ohos_aarch64_cjnative/dynamic/stdx
-
-# 2) DevEco 安装根（脚本会自动探测几个常见位置，探测不到就自己给）
-export DEVECO_WIN='D:\Program Files\Huawei\DevEco Studio'
-
-# 3) 编 hap
-bash build-hap.sh
-
-# 4) 编完装到设备并拉起（需要设备已连上、应用已签名）
-bash build-hap.sh --install
-```
-
-改了鸿蒙侧仓颉代码却没生效时：`bash build-hap.sh --clean`（hvigor 与框架 cjpm 各有一份增量缓存）。
-
-## 签名
-
-模板**不带证书**（调试证书由每台机器的 DevEco 本机生成、与华为账号绑定，不该入库）。
-首次打开请在 DevEco 里 File → Project Structure → Signing Configs，
-勾上「Automatically generate signature」。不签名也能编（产物是 `*-unsigned.hap`），但装不进设备。
-
-## 改应用
-
-- **加命令**：在 `app_host.cj` 里写 `CommandHandler` → `.register("名字", XxxCommand())` →
-  在 `entry/src/main/resources/rawfile/capabilities.json` 的 `commands` 里声明。三处缺一处就用不了
-  （只缺注册 → `command not registered`；只缺清单 → `command not allowed`）。
-- **改页面**：`entry/src/main/resources/rawfile/index.html`，前端只经 `window.__CJ_TAURI__`
-  的 `invoke` / `listen`，并且要**等桥出现**（ArkWeb 没有 document-start 注入）。
-- **联网**：`module.json5` 已声明 `ohos.permission.INTERNET`；用不到就删掉。
-- **窗口尺寸**：`main_ability.cj` **默认不动窗口**——鸿蒙 PC 按桌面形态给的那扇窗（本机 3120×2080 屏上
-  `2090×1394 px`，约屏宽 2/3）就是合适的大小，`logDefaultWindowRect()` 只把它读出来打一行 hilog 当凭证。
-  别在 `onWindowStageCreate` 里 `resize()`：系统先按默认尺寸建窗、你的 resize 紧接着改它，用户看到的是
-  「先弹一个尺寸、随即变成另一个」，观感就是窗口莫名跳一下（这是本模板撤掉两版自定尺寸的原因）。
-  **真要固定尺寸**就自己调 `windowStage.getMainWindow().resize(w, h)`，两个坑记着：`resize()` 收的是**像素**
-  不是 vp（写 vp 量级会得到一扇很小的窗）；`densityPixels` 是 **Float32**，跟 `Float64` 直接相乘编不过，
-  先化成整数百分比再算。
-  上述「系统给的就是桌面窗」的前提是 `entry/build-profile.json5` 的 `deviceTypes` 为 `2in1` 且
-  `cangjieOptions.checkDeviceTypes=false`——写成 phone/tablet 时系统按手机应用塞进竖屏兼容窗（约 600 宽）。
-
-## 已知边界
-
-- 只做了单窗口：`index.cj` 的 `EntryView` 挂一扇窗（label = `main`）。多窗口要按 label 各挂一个宿主。
-- 鸿蒙侧 `javaScriptProxy` 的**返回值传不回页面**，回投靠页面心跳 + `runJavaScript` 推送
-  （已在 `index.cj` 的 `onProxyPost` 里做好，业务代码不用管）。
-- `app.run(html)` 的 `quit()` 只置退出意图，进程仍归系统管（需要真退就 `hdc shell aa force-stop`）。
-- 更多平台细节与踩坑：`docs/鸿蒙ArkWeb接入踩坑.md`（框架仓库内）。
+# {{PROJECT_NAME}} — 仓颉 + ArkWeb 鸿蒙 PC 应用
+
+用 [cj-tauri](https://atomgit.com/qq8864/cj-tauri) 生成的鸿蒙 PC（2in1）应用工程：
+**仓颉后端（静态编译）+ 系统 ArkWeb 前端（HTML/CSS/JS）**，IPC、能力校验、命令分发与桌面版同一套框架代码。
+
+## 目录
+
+```
+{{PROJECT_NAME}}/
+├─ AppScope/app.json5               应用级配置（bundleName = {{BUNDLE_NAME}}）
+├─ build-profile.json5              工程级构建配置（签名留空，见下）
+├─ build-hap.sh                     构建入口（编 hap / 装到设备）
+├─ entry/
+│  ├─ cjpm.toml                     cjTauri 依赖 + aarch64-linux-ohos 目标段
+│  ├─ build-profile.json5           cangjieOptions.checkDeviceTypes=false（放行 2in1）
+│  └─ src/main/
+│     ├─ module.json5               deviceTypes: 2in1 / tablet / phone
+│     ├─ cangjie/
+│     │  ├─ ability_stage.cj        AbilityStage
+│     │  ├─ main_ability.cj         UIAbility：沙箱、rawfile 读取、窗口尺寸、loadContent
+│     │  ├─ index.cj                ArkWeb 宿主组件（javaScriptProxy 双向桥）
+│     │  └─ app_host.cj             框架装配 + demo 命令（greet / timer）
+│     └─ resources/rawfile/
+│        ├─ index.html              页面（改这里）
+│        └─ capabilities.json       能力清单（改这里）
+```
+
+页面与能力清单是 **hap 里的真文件**（rawfile），运行期由 Ability 读成字符串交给框架——
+所以 DevEco 里直接点 Build 也能编过，不需要先跑生成脚本。
+
+## 构建 / 装到设备
+
+```bash
+# 1) 鸿蒙版 stdx（构建期要链它）
+export CANGJIE_STDX_OHOS=<stdx>/linux_ohos_aarch64_cjnative/dynamic/stdx
+
+# 2) DevEco 安装根（脚本会自动探测几个常见位置，探测不到就自己给）
+export DEVECO_WIN='D:\Program Files\Huawei\DevEco Studio'
+
+# 3) 编 hap
+bash build-hap.sh
+
+# 4) 编完装到设备并拉起（需要设备已连上、应用已签名）
+bash build-hap.sh --install
+```
+
+改了鸿蒙侧仓颉代码却没生效时：`bash build-hap.sh --clean`（hvigor 与框架 cjpm 各有一份增量缓存）。
+
+## 签名
+
+模板**不带证书**（调试证书由每台机器的 DevEco 本机生成、与华为账号绑定，不该入库）。
+首次打开请在 DevEco 里 File → Project Structure → Signing Configs，
+勾上「Automatically generate signature」。不签名也能编（产物是 `*-unsigned.hap`），但装不进设备。
+
+## 改应用
+
+- **加命令**：在 `app_host.cj` 里写 `CommandHandler` → `.register("名字", XxxCommand())` →
+  在 `entry/src/main/resources/rawfile/capabilities.json` 的 `commands` 里声明。三处缺一处就用不了
+  （只缺注册 → `command not registered`；只缺清单 → `command not allowed`）。
+- **改页面**：`entry/src/main/resources/rawfile/index.html`，前端只经 `window.__CJ_TAURI__`
+  的 `invoke` / `listen`，并且要**等桥出现**（ArkWeb 没有 document-start 注入）。
+- **联网**：`module.json5` 已声明 `ohos.permission.INTERNET`；用不到就删掉。
+- **窗口尺寸**：`main_ability.cj` **默认不动窗口**——鸿蒙 PC 按桌面形态给的那扇窗（本机 3120×2080 屏上
+  `2090×1394 px`，约屏宽 2/3）就是合适的大小，`logDefaultWindowRect()` 只把它读出来打一行 hilog 当凭证。
+  别在 `onWindowStageCreate` 里 `resize()`：系统先按默认尺寸建窗、你的 resize 紧接着改它，用户看到的是
+  「先弹一个尺寸、随即变成另一个」，观感就是窗口莫名跳一下（这是本模板撤掉两版自定尺寸的原因）。
+  **真要固定尺寸**就自己调 `windowStage.getMainWindow().resize(w, h)`，两个坑记着：`resize()` 收的是**像素**
+  不是 vp（写 vp 量级会得到一扇很小的窗）；`densityPixels` 是 **Float32**，跟 `Float64` 直接相乘编不过，
+  先化成整数百分比再算。
+  上述「系统给的就是桌面窗」的前提是 `entry/build-profile.json5` 的 `deviceTypes` 为 `2in1` 且
+  `cangjieOptions.checkDeviceTypes=false`——写成 phone/tablet 时系统按手机应用塞进竖屏兼容窗（约 600 宽）。
+
+## 已知边界
+
+- 只做了单窗口：`index.cj` 的 `EntryView` 挂一扇窗（label = `main`）。多窗口要按 label 各挂一个宿主。
+- 鸿蒙侧 `javaScriptProxy` 的**返回值传不回页面**，回投靠页面心跳 + `runJavaScript` 推送
+  （已在 `index.cj` 的 `onProxyPost` 里做好，业务代码不用管）。
+- `app.run(html)` 的 `quit()` 只置退出意图，进程仍归系统管（需要真退就 `hdc shell aa force-stop`）。
+- 更多平台细节与踩坑：`docs/鸿蒙ArkWeb接入踩坑.md`（框架仓库内）。

package/cli/templates/{ohos-pc → ohos-skeleton}/build-profile.json5

@@ -1,46 +1,46 @@
-{
-  "app": {
-    /* 签名留空：模板不随包分发证书（调试证书由每台机器的 DevEco 本机生成、与华为账号绑定，
-       既不该入库也无法跨机器通用）。
-       在 DevEco 里 File → Project Structure → Signing Configs 勾上
-       「Automatically generate signature」，那一步会把 signingConfigs 填满。
-       不签名也能 `assembleHap`（产物是 *-unsigned.hap），但装不进设备。 */
-    "signingConfigs": [],
-    "products": [
-      {
-        "name": "default",
-        "targetSdkVersion": "6.1.1(24)",
-        "compatibleSdkVersion": "6.1.1(24)",
-        "runtimeOS": "HarmonyOS",
-        "buildOption": {
-          "strictMode": {
-            "caseSensitiveCheck": true,
-            "useNormalizedOHMUrl": true
-          }
-        }
-      }
-    ],
-    "buildModeSet": [
-      {
-        "name": "debug",
-      },
-      {
-        "name": "release"
-      }
-    ]
-  },
-  "modules": [
-    {
-      "name": "entry",
-      "srcPath": "./entry",
-      "targets": [
-        {
-          "name": "default",
-          "applyToProducts": [
-            "default"
-          ]
-        }
-      ]
-    }
-  ]
-}
+{
+  "app": {
+    /* 签名留空：模板不随包分发证书（调试证书由每台机器的 DevEco 本机生成、与华为账号绑定，
+       既不该入库也无法跨机器通用）。
+       在 DevEco 里 File → Project Structure → Signing Configs 勾上
+       「Automatically generate signature」，那一步会把 signingConfigs 填满。
+       不签名也能 `assembleHap`（产物是 *-unsigned.hap），但装不进设备。 */
+    "signingConfigs": [],
+    "products": [
+      {
+        "name": "default",
+        "targetSdkVersion": "6.1.1(24)",
+        "compatibleSdkVersion": "6.1.1(24)",
+        "runtimeOS": "HarmonyOS",
+        "buildOption": {
+          "strictMode": {
+            "caseSensitiveCheck": true,
+            "useNormalizedOHMUrl": true
+          }
+        }
+      }
+    ],
+    "buildModeSet": [
+      {
+        "name": "debug",
+      },
+      {
+        "name": "release"
+      }
+    ]
+  },
+  "modules": [
+    {
+      "name": "entry",
+      "srcPath": "./entry",
+      "targets": [
+        {
+          "name": "default",
+          "applyToProducts": [
+            "default"
+          ]
+        }
+      ]
+    }
+  ]
+}

package/cli/templates/{ohos-pc → ohos-skeleton}/entry/build-profile.json5

@@ -1,26 +1,26 @@
-{
-  "apiType": "stageMode",
-  "buildOption": {
-    "cangjieOptions": {
-      "path": "./cjpm.toml",
-      /* 关掉「deviceTypes 只能写 phone/tablet」这条门禁（DevEco 仓颉插件的
-         cangjie-pre-build.js 里 `cangjieOptions?.checkDeviceTypes !== false` 才校验）。
-         不关的话 module.json5 写 "2in1" 会直接判 01103012（Only phone and tablet devices
-         are supported）——而只有声明 2in1，鸿蒙 PC 才按桌面应用开窗，否则塞进手机形态的
-         竖屏兼容窗（实测约 600 宽）。 */
-      "checkDeviceTypes": false
-    },
-    "nativeLib": {
-      "filter": {
-        "enableOverride": true
-      }
-    }
-  },
-  "buildOptionSet": [
-  ],
-  "targets": [
-    {
-      "name": "default"
-    }
-  ]
-}
+{
+  "apiType": "stageMode",
+  "buildOption": {
+    "cangjieOptions": {
+      "path": "./cjpm.toml",
+      /* 关掉「deviceTypes 只能写 phone/tablet」这条门禁（DevEco 仓颉插件的
+         cangjie-pre-build.js 里 `cangjieOptions?.checkDeviceTypes !== false` 才校验）。
+         不关的话 module.json5 写 "2in1" 会直接判 01103012（Only phone and tablet devices
+         are supported）——而只有声明 2in1，鸿蒙 PC 才按桌面应用开窗，否则塞进手机形态的
+         竖屏兼容窗（实测约 600 宽）。 */
+      "checkDeviceTypes": false
+    },
+    "nativeLib": {
+      "filter": {
+        "enableOverride": true
+      }
+    }
+  },
+  "buildOptionSet": [
+  ],
+  "targets": [
+    {
+      "name": "default"
+    }
+  ]
+}