cj-tauri 1.1.2 → 2.1.0

package/cli/templates/app-vue/{ui → assets/ui}/src/App.vue

@@ -1,176 +1,176 @@
-<script setup>
-import { onMounted, ref } from 'vue';
-
-const name = ref('world');
-const result = ref('等待 invoke…');
-const tick = ref('');
-const menuMsg = ref('');
-const sidebar = ref(true);
-const href = ref('');
-const bridgeOk = ref(false);
-
-// 桥（window.__CJ_TAURI__）由宿主注入，注入时机随平台/页面来源而异：Linux 宿主注入在文档开始，
-// 但发行态单文件里的内联 <script type="module"> 解析完就执行，谁先谁后与加载方式有关。
-// 所以统一「等桥出现再初始化」，不要在模块作用域直接读。
-let bridge = null;
-
-function waitForBridge(timeoutMs = 3000) {
-  return new Promise((resolve) => {
-    const t0 = Date.now();
-    const tick = () => {
-      if (window.__CJ_TAURI__) return resolve(window.__CJ_TAURI__);
-      if (Date.now() - t0 >= timeoutMs) return resolve(null);
-      setTimeout(tick, 20);
-    };
-    tick();
-  });
-}
-
-onMounted(async () => {
-  href.value = location.href;
-  bridge = await waitForBridge();
-  if (!bridge) {
-    result.value = '未找到 window.__CJ_TAURI__';
-    return;
-  }
-  bridgeOk.value = true;
-  bridge.listen('tick', (payload) => {
-    tick.value = '事件 tick #' + payload.n + ' 来自仓颉后端';
-  });
-  // 原生菜单 → 页面（capabilities 里要声明 menu:click）
-  bridge.listen('menu:click', (p) => {
-    menuMsg.value = '菜单被点: ' + p.id + '（enabled=' + p.enabled + ', checked=' + p.checked + '）';
-  });
-});
-
-async function greet() {
-  if (!bridge) {
-    result.value = '桥未就绪';
-    return;
-  }
-  try {
-    const data = await bridge.invoke('greet', { name: name.value });
-    result.value = 'invoke OK: ' + data;
-  } catch (err) {
-    result.value = 'invoke FAIL: ' + err.message;
-  }
-}
-
-async function startTimer() {
-  if (bridge) await bridge.invoke('timer');
-}
-
-function reload() {
-  if (bridge) bridge.reload();
-}
-
-// 页面 → 原生菜单：menu 插件的前端 shim（window.__CJ_TAURI__.menu，注入在 document start）
-async function toggleSidebar(e) {
-  const checked = e.target.checked;
-  if (!bridge || !bridge.menu) {
-    result.value = '未注入 menu 插件 shim（页面来自 runUrl 时插件 JS 不在本进程）';
-    return;
-  }
-  try {
-    await bridge.menu.setChecked({ id: 'view.sidebar', checked });
-    result.value = '原生菜单「侧边栏」已同步为 ' + checked;
-  } catch (err) {
-    result.value = 'menu.setChecked FAIL: ' + err.message;
-  }
-}
-</script>
-
-<template>
-  <h1>cj-tauri · Vue 3 + Vite</h1>
-  <p class="hint">
-    页面来源：<code>{{ href }}</code><br />
-    桥状态：{{ bridgeOk ? '已注入 __CJ_TAURI__' : '未注入' }}
-  </p>
-
-  <div class="card">
-    <div class="row">
-      <input v-model="name" placeholder="输入名字" />
-      <button @click="greet">greet</button>
-      <button class="ghost" @click="startTimer">timer</button>
-      <button class="ghost" @click="reload">reload</button>
-    </div>
-    <div class="out">{{ result }}</div>
-    <div class="tick">{{ tick }}</div>
-    <div class="tick">{{ menuMsg }}</div>
-    <div class="chk">
-      <input type="checkbox" :checked="sidebar" @change="toggleSidebar" />
-      <span>侧边栏（对应原生菜单「视图 → 侧边栏」）</span>
-    </div>
-    <p class="tip">
-      改这个文件（<code>ui/src/App.vue</code>）保存，页面会在不重启应用的情况下更新。
-    </p>
-  </div>
-</template>
-
-<style scoped>
-h1 {
-  color: #7ce7ff;
-}
-.hint {
-  font-size: 13px;
-  opacity: 0.8;
-}
-.card {
-  background: #16213e;
-  border-radius: 12px;
-  padding: 20px 24px;
-  width: 560px;
-  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.4);
-}
-.row {
-  display: flex;
-  gap: 8px;
-}
-input {
-  flex: 1;
-  padding: 8px 12px;
-  border: none;
-  border-radius: 8px;
-  background: #0f3460;
-  color: #eee;
-}
-button {
-  padding: 8px 14px;
-  border: none;
-  border-radius: 8px;
-  background: #e94560;
-  color: #fff;
-  cursor: pointer;
-}
-button.ghost {
-  background: #24476e;
-}
-button:hover {
-  opacity: 0.85;
-}
-.out {
-  margin-top: 14px;
-  font-size: 16px;
-}
-.tick {
-  margin-top: 6px;
-  font-size: 13px;
-  color: #8be9fd;
-}
-.chk {
-  margin-top: 12px;
-  font-size: 13px;
-  opacity: 0.85;
-  display: flex;
-  align-items: center;
-  gap: 6px;
-}
-.chk input {
-  flex: none;
-}
-.tip {
-  margin-top: 14px;
-  font-size: 12px;
-  opacity: 0.7;
-}
-</style>
+<script setup>
+import { onMounted, ref } from 'vue';
+
+const name = ref('world');
+const result = ref('等待 invoke…');
+const tick = ref('');
+const menuMsg = ref('');
+const sidebar = ref(true);
+const href = ref('');
+const bridgeOk = ref(false);
+
+// 桥（window.__CJ_TAURI__）由宿主注入，注入时机随平台/页面来源而异：Linux 宿主注入在文档开始，
+// 但发行态单文件里的内联 <script type="module"> 解析完就执行，谁先谁后与加载方式有关。
+// 所以统一「等桥出现再初始化」，不要在模块作用域直接读。
+let bridge = null;
+
+function waitForBridge(timeoutMs = 3000) {
+  return new Promise((resolve) => {
+    const t0 = Date.now();
+    const tick = () => {
+      if (window.__CJ_TAURI__) return resolve(window.__CJ_TAURI__);
+      if (Date.now() - t0 >= timeoutMs) return resolve(null);
+      setTimeout(tick, 20);
+    };
+    tick();
+  });
+}
+
+onMounted(async () => {
+  href.value = location.href;
+  bridge = await waitForBridge();
+  if (!bridge) {
+    result.value = '未找到 window.__CJ_TAURI__';
+    return;
+  }
+  bridgeOk.value = true;
+  bridge.listen('tick', (payload) => {
+    tick.value = '事件 tick #' + payload.n + ' 来自仓颉后端';
+  });
+  // 原生菜单 → 页面（capabilities 里要声明 menu:click）
+  bridge.listen('menu:click', (p) => {
+    menuMsg.value = '菜单被点: ' + p.id + '（enabled=' + p.enabled + ', checked=' + p.checked + '）';
+  });
+});
+
+async function greet() {
+  if (!bridge) {
+    result.value = '桥未就绪';
+    return;
+  }
+  try {
+    const data = await bridge.invoke('greet', { name: name.value });
+    result.value = 'invoke OK: ' + data;
+  } catch (err) {
+    result.value = 'invoke FAIL: ' + err.message;
+  }
+}
+
+async function startTimer() {
+  if (bridge) await bridge.invoke('timer');
+}
+
+function reload() {
+  if (bridge) bridge.reload();
+}
+
+// 页面 → 原生菜单：menu 插件的前端 shim（window.__CJ_TAURI__.menu，注入在 document start）
+async function toggleSidebar(e) {
+  const checked = e.target.checked;
+  if (!bridge || !bridge.menu) {
+    result.value = '未注入 menu 插件 shim（页面来自 runUrl 时插件 JS 不在本进程）';
+    return;
+  }
+  try {
+    await bridge.menu.setChecked({ id: 'view.sidebar', checked });
+    result.value = '原生菜单「侧边栏」已同步为 ' + checked;
+  } catch (err) {
+    result.value = 'menu.setChecked FAIL: ' + err.message;
+  }
+}
+</script>
+
+<template>
+  <h1>cj-tauri · Vue 3 + Vite</h1>
+  <p class="hint">
+    页面来源：<code>{{ href }}</code><br />
+    桥状态：{{ bridgeOk ? '已注入 __CJ_TAURI__' : '未注入' }}
+  </p>
+
+  <div class="card">
+    <div class="row">
+      <input v-model="name" placeholder="输入名字" />
+      <button @click="greet">greet</button>
+      <button class="ghost" @click="startTimer">timer</button>
+      <button class="ghost" @click="reload">reload</button>
+    </div>
+    <div class="out">{{ result }}</div>
+    <div class="tick">{{ tick }}</div>
+    <div class="tick">{{ menuMsg }}</div>
+    <div class="chk">
+      <input type="checkbox" :checked="sidebar" @change="toggleSidebar" />
+      <span>侧边栏（对应原生菜单「视图 → 侧边栏」）</span>
+    </div>
+    <p class="tip">
+      改这个文件（<code>ui/src/App.vue</code>）保存，页面会在不重启应用的情况下更新。
+    </p>
+  </div>
+</template>
+
+<style scoped>
+h1 {
+  color: #7ce7ff;
+}
+.hint {
+  font-size: 13px;
+  opacity: 0.8;
+}
+.card {
+  background: #16213e;
+  border-radius: 12px;
+  padding: 20px 24px;
+  width: 560px;
+  box-shadow: 0 8px 24px rgba(0, 0, 0, 0.4);
+}
+.row {
+  display: flex;
+  gap: 8px;
+}
+input {
+  flex: 1;
+  padding: 8px 12px;
+  border: none;
+  border-radius: 8px;
+  background: #0f3460;
+  color: #eee;
+}
+button {
+  padding: 8px 14px;
+  border: none;
+  border-radius: 8px;
+  background: #e94560;
+  color: #fff;
+  cursor: pointer;
+}
+button.ghost {
+  background: #24476e;
+}
+button:hover {
+  opacity: 0.85;
+}
+.out {
+  margin-top: 14px;
+  font-size: 16px;
+}
+.tick {
+  margin-top: 6px;
+  font-size: 13px;
+  color: #8be9fd;
+}
+.chk {
+  margin-top: 12px;
+  font-size: 13px;
+  opacity: 0.85;
+  display: flex;
+  align-items: center;
+  gap: 6px;
+}
+.chk input {
+  flex: none;
+}
+.tip {
+  margin-top: 14px;
+  font-size: 12px;
+  opacity: 0.7;
+}
+</style>

package/cli/templates/app-vue/cj-tauri.toml

@@ -0,0 +1,33 @@
+# cj-tauri 应用清单——整个工程的单一真相（RFC-002 §7）。
+# cj-tauri sync 从这里派生 targets/ 骨架（desktop/ohos）；cj-tauri check 校验它并检测骨架漂移。
+[app]
+  name = "{{PROJECT_NAME}}"
+  version = "0.1.0"
+  # 应用标识：桌面是安装 ID，鸿蒙直接是 bundleName（每段须字母开头、只含字母数字下划线）
+  id = "{{BUNDLE_NAME}}"
+  # 业务包名（cjpm 约束①：toml 模块名必须等于源包名）
+  package = "{{PACKAGE_NAME}}"
+
+[[windows]]
+  label = "main"
+  title = "{{PROJECT_NAME}}"
+  width = 1000
+  height = 700
+
+[assets]
+  # 骨架 launcher 加载的页面：Vite 打出来的单文件产物（vite-plugin-singlefile 内联 js/css）。
+  # dev 模式自动改写到 Vite dev server（热更新）；发布构建才用这个产物。
+  page = "ui/dist/index.html"
+
+[capabilities]
+  dir = "assets/capabilities"
+
+[links]
+  # 各目标端**追加**的链接选项（拼在框架默认值之后；留空 = 只用默认）。
+  # 什么时候需要它：要调的原生能力在仓颉 SDK 里没有绑定，只能 FFI 直连系统库——
+  # 符号必须出现在最终链接那一侧，而那份 cjpm.toml 是 sync 生成的、不能手改。
+  # 例：鸿蒙读设备电量走系统 C API（ohbattery_info.h），写 ohos = "-lohbattery_info"
+  # 三端分开写是因为同一个库在三端上名字通常不同（-lfoo / foo.lib / -lfoo_ndk.z）。
+  desktop-linux = ""
+  desktop-windows = ""
+  ohos = ""

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

@@ -1,17 +1,34 @@
+# 业务包：业务代码的唯一真相（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 应用（Vue 3 + Vite 前端）"
+  description = "{{PROJECT_NAME}} - cj-tauri 业务包"
   version = "0.1.0"
   target-dir = ""
-  output-type = "executable"
+  output-type = "static"
   compile-option = ""
   override-compile-option = ""
   link-option = ""
   package-configuration = {}
 
 [dependencies]
-  # cj-tauri 框架本体（由 cj-tauri create 写入的本机路径）
+  # cj-tauri 框架本体（由 cj-tauri create 写入的本机路径；换机器重跑 create 或手改）
   cjTauri = { path = "{{FRAMEWORK_ROOT_TOML}}" }
 
-{{TARGET_SECTION}}
+[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,8 +1,8 @@
 package {{PACKAGE_NAME}}
 
 import cjTauri.*
+import cjTauri.plugins.menu.*
 import stdx.encoding.json.*
-import std.fs.*
 import std.collection.*
 
 /**
@@ -25,7 +25,7 @@ public class GreetCommand <: CommandHandler {
 }
 
 /**
- * 定时器命令：启动后台线程，每秒向后端推一个 tick 事件（验证 仓颉 → JS 通道）
+ * 定时器命令：启动后台线程，每秒向前端推一个 tick 事件（验证 仓颉 → JS 通道）
  * 前端：tauri.listen("tick", cb) + tauri.invoke("timer")
  */
 public class TimerCommand <: CommandHandler {
@@ -67,36 +67,25 @@ func demoMenu(): MenuModel {
     return MenuModel(items)
 }
 
-main(): Int64 {
-    // 1) 装配应用（对标 tauri::Builder）：窗口配置 + 注册命令
-    //    能力清单由框架在 run() 时自动扫描 capabilities/ 目录（对标 Tauri 的 capabilities 目录）
-    let app = TauriApp()
+/**
+ * 业务装配点（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))
-        .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
+        .wire({ app =>
+            app.register("greet", GreetCommand())
+            app.register("timer", TimerCommand())
+            // 菜单栏必须在 run 之前挂：预置类宿主能力要赶在页面加载前定稿
+            app.setMenu(demoMenu())
+        })
 }

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

@@ -46,6 +46,11 @@ bash build-hap.sh --install
 
 改了鸿蒙侧仓颉代码却没生效时：`bash build-hap.sh --clean`（hvigor 与框架 cjpm 各有一份增量缓存）。
 
+**DevEco IDE 内点 Build 不经过 build-hap.sh**：assets 自动同步段（工程根 assets/ → rawfile）在
+命令行入口里，IDE 构建不会执行——在 IDE 里改了 `assets/ui` 或 `assets/capabilities` 后，
+要么回命令行跑一次 `bash build-hap.sh`，要么重跑 `cj-tauri sync ohos`；直接 IDE 构建装出来的是旧页
+（判据：hap 内 `unzip -p *.hap resources/rawfile/ui/index.html` 不含你的改动）。
+
 ## 签名
 
 模板**不带证书**（调试证书由每台机器的 DevEco 本机生成、与华为账号绑定，不该入库）。

package/cli/templates/{ohos-pc → ohos-skeleton}/build-hap.sh

@@ -154,6 +154,21 @@ if [ "$do_clean" = "1" ]; then
     rm -rf "$ROOT_DIR/entry/build"
 fi
 
+# assets 同步：唯一真相在工程根 assets/（RFC-002 §7），构建前拷进骨架 rawfile——
+# 页面与能力清单是 hap 的 rawfile 真文件，只改 assets 不 sync 直接构建会装出**旧页**：
+# 页面自检照跑、改动静默丢失（2026-10-25 真机实测，探针行全无、又无失败行）。
+# 有 sync 生成的工程根（cj-tauri.toml 在上三级）才做这一步；手工工程自行维护 rawfile。
+APP_ROOT="$ROOT_DIR/../.."
+if [ -f "$APP_ROOT/cj-tauri.toml" ] && [ -d "$APP_ROOT/assets" ]; then
+    RAWFILE="$ROOT_DIR/entry/src/main/resources/rawfile"
+    mkdir -p "$RAWFILE/ui" "$RAWFILE/capabilities"
+    # 先清再拷：cp -r src dst 在 dst 已存在时会把 src 拷成 dst/ui/ui/（嵌套目录），页面静默变旧
+    rm -rf "$RAWFILE/ui" "$RAWFILE/capabilities"
+    cp -r "$APP_ROOT/assets/ui" "$RAWFILE/ui"
+    cp -r "$APP_ROOT/assets/capabilities" "$RAWFILE/capabilities"
+    echo "[ohos] assets 已从工程根同步到 rawfile（ui/ + capabilities/）"
+fi
+
 # **必须 `--no-daemon`**：hvigor 的常驻 daemon 里 CompileCangjie 用的是它启动时那份 env，
 # 本脚本 export 的 PATH / CANGJIE_HOME 根本进不去（表现是「手跑 cjpm 成功、hvigor 一跑就 opt 崩」）。
 mkdir -p .buildlog

package/cli/templates/{ohos-pc → ohos-skeleton}/entry/cjpm.toml

@@ -25,6 +25,14 @@
 
 [target.aarch64-linux-ohos]
   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\""
+  # -lpasteboard -ludmf：框架的剪贴板宿主能力（`src/clipboard_bridge.cj` 鸿蒙段）用原生
+  # `OH_Pasteboard_*` / `OH_Udmf*` / `OH_UdsPlainText_*` C API。两组符号分属两个库
+  # （`OH_Pasteboard_*` 在 libpasteboard、其余在 libudmf），所以两个都要给。
+  # 最终链接发生在**本模块**（output-type = dynamic），所以开关必须在这儿落地——
+  # 只写在框架自己的 cjpm.toml 里不生效，缺了模块里就留一堆 `U OH_Pasteboard_*`，
+  # 表现是应用启动即 SIGSEGV（模块加载期解析不到符号）。
+  # 库在同 sysroot 的 `usr/lib/aarch64-linux-ohos`，上面 compile-option 的 `-L` 已指着它。
+  link-option = "-lpasteboard -ludmf"
 [target.aarch64-linux-ohos.bin-dependencies]
   # 鸿蒙版 stdx：这里写**相对路径**，指向工程根上的 `stdx` 联接（build-hap.sh 用
   # CANGJIE_STDX_OHOS 建，不入库）。两条实测依据：