cj-tauri 2.0.0 → 2.1.0

package/cli/templates/app-vue/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/assets/ui/src/main.js

@@ -1,4 +1,4 @@
-import { createApp } from 'vue';
-import App from './App.vue';
-
-createApp(App).mount('#app');
+import { createApp } from 'vue';
+import App from './App.vue';
+
+createApp(App).mount('#app');

package/cli/templates/app-vue/assets/ui/vite.config.js

@@ -1,24 +1,24 @@
-import { defineConfig } from 'vite';
-import vue from '@vitejs/plugin-vue';
-import { viteSingleFile } from 'vite-plugin-singlefile';
-
-// 两件事很重要：
-//   1) dev server 固定 127.0.0.1:5173 —— cj-tauri dev 就是按这个地址探活并注入 CJ_TAURI_DEV_URL 的；
-//      strictPort 让它端口被占时直接报错，而不是悄悄换一个导致应用连不上。
-//   2) 构建产物必须是**单个** index.html —— 后端用 File.readFrom 读它，与 app 模板的单文件模式一致；
-//      assetsInlineLimit 调大是为了让图片等资源也内联进 HTML。
-export default defineConfig({
-  plugins: [vue(), viteSingleFile()],
-  base: './',
-  server: {
-    host: '127.0.0.1',
-    port: 5173,
-    strictPort: true
-  },
-  build: {
-    outDir: 'dist',
-    emptyOutDir: true,
-    cssCodeSplit: false,
-    assetsInlineLimit: 104857600
-  }
-});
+import { defineConfig } from 'vite';
+import vue from '@vitejs/plugin-vue';
+import { viteSingleFile } from 'vite-plugin-singlefile';
+
+// 两件事很重要：
+//   1) dev server 固定 127.0.0.1:5173 —— cj-tauri dev 就是按这个地址探活并注入 CJ_TAURI_DEV_URL 的；
+//      strictPort 让它端口被占时直接报错，而不是悄悄换一个导致应用连不上。
+//   2) 构建产物必须是**单个** index.html —— 后端用 File.readFrom 读它，与 app 模板的单文件模式一致；
+//      assetsInlineLimit 调大是为了让图片等资源也内联进 HTML。
+export default defineConfig({
+  plugins: [vue(), viteSingleFile()],
+  base: './',
+  server: {
+    host: '127.0.0.1',
+    port: 5173,
+    strictPort: true
+  },
+  build: {
+    outDir: 'dist',
+    emptyOutDir: true,
+    cssCodeSplit: false,
+    assetsInlineLimit: 104857600
+  }
+});

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

@@ -1,23 +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"
+# 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,34 +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 业务包"
-  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}"]
+# 业务包：业务代码的唯一真相（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}"]