cj-tauri 2.0.0 → 2.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (158) hide show
  1. package/README.md +113 -99
  2. package/bin/cj-tauri.js +287 -287
  3. package/cjpm.toml +63 -52
  4. package/cli/cjpm.toml +22 -22
  5. package/cli/src/doctor.cj +308 -306
  6. package/cli/src/main.cj +129 -129
  7. package/cli/src/manifest.cj +632 -558
  8. package/cli/src/manifest_test.cj +87 -0
  9. package/cli/src/project.cj +770 -770
  10. package/cli/src/resolve.cj +348 -348
  11. package/cli/src/scaffold.cj +369 -369
  12. package/cli/src/sync.cj +526 -526
  13. package/cli/src/util.cj +168 -168
  14. package/cli/templates/app/README.md +51 -48
  15. package/cli/templates/app/assets/capabilities/default.json +7 -7
  16. package/cli/templates/app/assets/ui/index.html +120 -118
  17. package/cli/templates/app/cj-tauri.toml +32 -22
  18. package/cli/templates/app/cjpm.toml +34 -34
  19. package/cli/templates/app/src/main.cj +101 -90
  20. package/cli/templates/app-react/README.md +56 -56
  21. package/cli/templates/app-react/assets/capabilities/default.json +7 -7
  22. package/cli/templates/app-react/assets/ui/index.html +25 -25
  23. package/cli/templates/app-react/assets/ui/package.json +19 -19
  24. package/cli/templates/app-react/assets/ui/src/App.css +67 -67
  25. package/cli/templates/app-react/assets/ui/src/App.jsx +124 -124
  26. package/cli/templates/app-react/assets/ui/src/main.jsx +6 -6
  27. package/cli/templates/app-react/assets/ui/vite.config.js +24 -24
  28. package/cli/templates/app-react/cj-tauri.toml +33 -23
  29. package/cli/templates/app-react/cjpm.toml +34 -34
  30. package/cli/templates/app-react/src/main.cj +91 -91
  31. package/cli/templates/app-vue/README.md +56 -56
  32. package/cli/templates/app-vue/assets/capabilities/default.json +7 -7
  33. package/cli/templates/app-vue/assets/ui/index.html +25 -25
  34. package/cli/templates/app-vue/assets/ui/package.json +18 -18
  35. package/cli/templates/app-vue/assets/ui/src/App.vue +176 -176
  36. package/cli/templates/app-vue/assets/ui/src/main.js +4 -4
  37. package/cli/templates/app-vue/assets/ui/vite.config.js +24 -24
  38. package/cli/templates/app-vue/cj-tauri.toml +33 -23
  39. package/cli/templates/app-vue/cjpm.toml +34 -34
  40. package/cli/templates/app-vue/src/main.cj +91 -91
  41. package/cli/templates/ohos-skeleton/AppScope/app.json5 +13 -13
  42. package/cli/templates/ohos-skeleton/AppScope/resources/base/element/string.json +8 -8
  43. package/cli/templates/ohos-skeleton/AppScope/resources/base/media/layered_image.json +6 -6
  44. package/cli/templates/ohos-skeleton/README.md +84 -79
  45. package/cli/templates/ohos-skeleton/build-hap.sh +15 -0
  46. package/cli/templates/ohos-skeleton/build-profile.json5 +46 -46
  47. package/cli/templates/ohos-skeleton/entry/build-profile.json5 +26 -26
  48. package/cli/templates/ohos-skeleton/entry/cjpm.toml +51 -43
  49. package/cli/templates/ohos-skeleton/entry/hvigorfile.ts +6 -6
  50. package/cli/templates/ohos-skeleton/entry/oh-package.json5 +9 -9
  51. package/cli/templates/ohos-skeleton/entry/src/main/cangjie/ability_stage.cj +17 -17
  52. package/cli/templates/ohos-skeleton/entry/src/main/cangjie/app_host.cj +94 -94
  53. package/cli/templates/ohos-skeleton/entry/src/main/cangjie/dialog_host.cj +217 -0
  54. package/cli/templates/ohos-skeleton/entry/src/main/cangjie/index.cj +527 -167
  55. package/cli/templates/ohos-skeleton/entry/src/main/cangjie/main_ability.cj +139 -139
  56. package/cli/templates/ohos-skeleton/entry/src/main/module.json5 +57 -49
  57. package/cli/templates/ohos-skeleton/entry/src/main/resources/base/element/color.json +8 -8
  58. package/cli/templates/ohos-skeleton/entry/src/main/resources/base/element/string.json +16 -16
  59. package/cli/templates/ohos-skeleton/entry/src/main/resources/base/media/layered_image.json +6 -6
  60. package/cli/templates/ohos-skeleton/entry/src/main/resources/base/profile/main_pages.json +2 -2
  61. package/cli/templates/ohos-skeleton/entry/src/main/resources/rawfile/capabilities.json +6 -6
  62. package/cli/templates/ohos-skeleton/entry/src/main/resources/rawfile/index.html +92 -92
  63. package/cli/templates/ohos-skeleton/hvigor/hvigor-config.json5 +5 -5
  64. package/cli/templates/ohos-skeleton/hvigorfile.ts +6 -6
  65. package/cli/templates/ohos-skeleton/oh-package.json5 +10 -10
  66. package/native/build_win.bat +62 -62
  67. package/native/core/bridge_core.c +1681 -1626
  68. package/native/core/bridge_core.h +675 -618
  69. package/native/core/bridge_js.h +108 -108
  70. package/native/platforms/harmonyos/README.md +115 -6
  71. package/native/platforms/linux/bridge_linux.c +2787 -2485
  72. package/native/platforms/windows/bridge_win.c +3740 -3248
  73. package/native/tests/gtk_threading_probe.c +143 -143
  74. package/native/tests/test_bridge_core.c +1339 -1228
  75. package/package.json +53 -53
  76. package/prebuilt/linux-x64/cj-tauri +0 -0
  77. package/src/api_system.cj +67 -67
  78. package/src/app.cj +325 -969
  79. package/src/app_events.cj +166 -0
  80. package/src/app_host_ops.cj +287 -0
  81. package/src/app_run.cj +283 -0
  82. package/src/app_spec.cj +76 -76
  83. package/src/arkweb_menu.cj +216 -0
  84. package/src/arkweb_script.cj +142 -142
  85. package/src/capability.cj +409 -409
  86. package/src/clipboard_bridge.cj +178 -0
  87. package/src/dialog_spec.cj +79 -0
  88. package/src/dragdrop.cj +26 -26
  89. package/src/embedded_assets.cj +98 -98
  90. package/src/host.cj +752 -607
  91. package/src/host_arkweb.cj +924 -778
  92. package/src/host_webkit.cj +663 -570
  93. package/src/host_webview2.cj +663 -570
  94. package/src/hotkey.cj +66 -66
  95. package/src/ipc_hub.cj +337 -337
  96. package/src/ipc_message.cj +286 -286
  97. package/src/launch.cj +62 -62
  98. package/src/logging.cj +127 -127
  99. package/src/menu.cj +197 -197
  100. package/src/platform/platform_app_context.cj +77 -77
  101. package/src/platform/platform_assets.cj +33 -33
  102. package/src/platform/platform_discover.cj +176 -176
  103. package/src/platform/platform_env.cj +29 -29
  104. package/src/platform/platform_feature.cj +31 -31
  105. package/src/platform/platform_page_source.cj +87 -87
  106. package/src/platform/platform_target_info.cj +32 -32
  107. package/src/platform_host_provider.cj +87 -87
  108. package/src/plugin.cj +333 -333
  109. package/src/plugins/clipboard/plugin_clipboard.cj +152 -152
  110. package/src/plugins/dialog/plugin_dialog.cj +209 -209
  111. package/src/plugins/fs/plugin_fs.cj +105 -1
  112. package/src/plugins/http/http_backend.cj +131 -0
  113. package/src/plugins/http/http_desktop.cj +195 -0
  114. package/src/plugins/http/http_ohos.cj +204 -0
  115. package/src/plugins/http/plugin_http.cj +310 -459
  116. package/src/plugins/log/plugin_log.cj +105 -105
  117. package/src/plugins/menu/plugin_menu.cj +158 -158
  118. package/src/plugins/notification/plugin_notification.cj +154 -154
  119. package/src/plugins/serial/plugin_serial.cj +458 -454
  120. package/src/plugins/serial/serial_bridge.cj +194 -194
  121. package/src/plugins/serial/serial_manager_ohos.cj +92 -0
  122. package/src/plugins/serial/serial_ohos.cj +529 -0
  123. package/src/plugins/shell/plugin_shell.cj +258 -258
  124. package/src/plugins/sqlite/plugin_sqlite.cj +705 -710
  125. package/src/plugins/sqlite/sqlite_ffi.cj +206 -211
  126. package/src/plugins/ws/plugin_ws.cj +488 -470
  127. package/src/process_hidden.cj +174 -174
  128. package/src/scope.cj +391 -391
  129. package/src/shell_event.cj +69 -69
  130. package/src/tests/app_spec_test.cj +126 -127
  131. package/src/tests/capability_test.cj +243 -243
  132. package/src/tests/dialog_spec_test.cj +73 -0
  133. package/src/tests/fake_host.cj +201 -201
  134. package/src/tests/ipc_hub_test.cj +487 -487
  135. package/src/tests/logging_test.cj +62 -62
  136. package/src/tests/platform_contract_test.cj +251 -251
  137. package/src/tests/plugin_clipboard_test.cj +222 -222
  138. package/src/tests/plugin_dialog_test.cj +237 -237
  139. package/src/tests/plugin_fs_test.cj +207 -0
  140. package/src/tests/plugin_http_test.cj +124 -124
  141. package/src/tests/plugin_notification_test.cj +205 -205
  142. package/src/tests/plugin_serial_test.cj +48 -0
  143. package/src/tests/plugin_test.cj +605 -585
  144. package/src/tests/plugin_ws_test.cj +40 -40
  145. package/src/tests/process_hidden_test.cj +129 -129
  146. package/src/tests/scope_test.cj +350 -350
  147. package/src/tests/system_host_test.cj +99 -81
  148. package/src/tests/urlutil_test.cj +53 -53
  149. package/src/tests/version_test.cj +75 -75
  150. package/src/tests/window_registry_test.cj +123 -123
  151. package/src/tray.cj +90 -90
  152. package/src/urlutil.cj +159 -159
  153. package/src/version.cj +44 -44
  154. package/src/window.cj +51 -51
  155. package/src/window_registry.cj +116 -116
  156. package/prebuilt/win32-x64/cj-tauri.exe +0 -0
  157. package/src/plugins/serial/serial_ohos_stub.cj +0 -61
  158. package/src/plugins/sqlite/sqlite_ohos_stub.cj +0 -91
@@ -1,24 +1,24 @@
1
- import { defineConfig } from 'vite';
2
- import react from '@vitejs/plugin-react';
3
- import { viteSingleFile } from 'vite-plugin-singlefile';
4
-
5
- // 两件事很重要:
6
- // 1) dev server 固定 127.0.0.1:5173 —— cj-tauri dev 就是按这个地址探活并注入 CJ_TAURI_DEV_URL 的;
7
- // strictPort 让它端口被占时直接报错,而不是悄悄换一个导致应用连不上。
8
- // 2) 构建产物必须是**单个** index.html —— 后端用 File.readFrom 读它,与 app 模板的单文件模式一致;
9
- // assetsInlineLimit 调大是为了让图片等资源也内联进 HTML。
10
- export default defineConfig({
11
- plugins: [react(), viteSingleFile()],
12
- base: './',
13
- server: {
14
- host: '127.0.0.1',
15
- port: 5173,
16
- strictPort: true
17
- },
18
- build: {
19
- outDir: 'dist',
20
- emptyOutDir: true,
21
- cssCodeSplit: false,
22
- assetsInlineLimit: 104857600
23
- }
24
- });
1
+ import { defineConfig } from 'vite';
2
+ import react from '@vitejs/plugin-react';
3
+ import { viteSingleFile } from 'vite-plugin-singlefile';
4
+
5
+ // 两件事很重要:
6
+ // 1) dev server 固定 127.0.0.1:5173 —— cj-tauri dev 就是按这个地址探活并注入 CJ_TAURI_DEV_URL 的;
7
+ // strictPort 让它端口被占时直接报错,而不是悄悄换一个导致应用连不上。
8
+ // 2) 构建产物必须是**单个** index.html —— 后端用 File.readFrom 读它,与 app 模板的单文件模式一致;
9
+ // assetsInlineLimit 调大是为了让图片等资源也内联进 HTML。
10
+ export default defineConfig({
11
+ plugins: [react(), viteSingleFile()],
12
+ base: './',
13
+ server: {
14
+ host: '127.0.0.1',
15
+ port: 5173,
16
+ strictPort: true
17
+ },
18
+ build: {
19
+ outDir: 'dist',
20
+ emptyOutDir: true,
21
+ cssCodeSplit: false,
22
+ assetsInlineLimit: 104857600
23
+ }
24
+ });
@@ -1,23 +1,33 @@
1
- # cj-tauri 应用清单——整个工程的单一真相(RFC-002 §7)。
2
- # cj-tauri sync 从这里派生 targets/ 骨架(desktop/ohos);cj-tauri check 校验它并检测骨架漂移。
3
- [app]
4
- name = "{{PROJECT_NAME}}"
5
- version = "0.1.0"
6
- # 应用标识:桌面是安装 ID,鸿蒙直接是 bundleName(每段须字母开头、只含字母数字下划线)
7
- id = "{{BUNDLE_NAME}}"
8
- # 业务包名(cjpm 约束①:toml 模块名必须等于源包名)
9
- package = "{{PACKAGE_NAME}}"
10
-
11
- [[windows]]
12
- label = "main"
13
- title = "{{PROJECT_NAME}}"
14
- width = 1000
15
- height = 700
16
-
17
- [assets]
18
- # 骨架 launcher 加载的页面:Vite 打出来的单文件产物(vite-plugin-singlefile 内联 js/css)。
19
- # dev 模式自动改写到 Vite dev server(热更新);发布构建才用这个产物。
20
- page = "ui/dist/index.html"
21
-
22
- [capabilities]
23
- dir = "assets/capabilities"
1
+ # cj-tauri 应用清单——整个工程的单一真相(RFC-002 §7)。
2
+ # cj-tauri sync 从这里派生 targets/ 骨架(desktop/ohos);cj-tauri check 校验它并检测骨架漂移。
3
+ [app]
4
+ name = "{{PROJECT_NAME}}"
5
+ version = "0.1.0"
6
+ # 应用标识:桌面是安装 ID,鸿蒙直接是 bundleName(每段须字母开头、只含字母数字下划线)
7
+ id = "{{BUNDLE_NAME}}"
8
+ # 业务包名(cjpm 约束①:toml 模块名必须等于源包名)
9
+ package = "{{PACKAGE_NAME}}"
10
+
11
+ [[windows]]
12
+ label = "main"
13
+ title = "{{PROJECT_NAME}}"
14
+ width = 1000
15
+ height = 700
16
+
17
+ [assets]
18
+ # 骨架 launcher 加载的页面:Vite 打出来的单文件产物(vite-plugin-singlefile 内联 js/css)。
19
+ # dev 模式自动改写到 Vite dev server(热更新);发布构建才用这个产物。
20
+ page = "ui/dist/index.html"
21
+
22
+ [capabilities]
23
+ dir = "assets/capabilities"
24
+
25
+ [links]
26
+ # 各目标端**追加**的链接选项(拼在框架默认值之后;留空 = 只用默认)。
27
+ # 什么时候需要它:要调的原生能力在仓颉 SDK 里没有绑定,只能 FFI 直连系统库——
28
+ # 符号必须出现在最终链接那一侧,而那份 cjpm.toml 是 sync 生成的、不能手改。
29
+ # 例:鸿蒙读设备电量走系统 C API(ohbattery_info.h),写 ohos = "-lohbattery_info"
30
+ # 三端分开写是因为同一个库在三端上名字通常不同(-lfoo / foo.lib / -lfoo_ndk.z)。
31
+ desktop-linux = ""
32
+ desktop-windows = ""
33
+ ohos = ""
@@ -1,34 +1,34 @@
1
- # 业务包:业务代码的唯一真相(RFC-002 §7.3——骨架永远是外壳,业务只有一份)。
2
- # output-type = "static":桌面骨架(targets/desktop)与鸿蒙入口(targets/ohos/entry)
3
- # 都以 path 依赖引用本包——同一份业务代码,多个目标各编各的产物。
4
- [package]
5
- cjc-version = "{{CJC_VERSION}}"
6
- name = "{{PACKAGE_NAME}}"
7
- description = "{{PROJECT_NAME}} - cj-tauri 业务包"
8
- version = "0.1.0"
9
- target-dir = ""
10
- output-type = "static"
11
- compile-option = ""
12
- override-compile-option = ""
13
- link-option = ""
14
- package-configuration = {}
15
-
16
- [dependencies]
17
- # cj-tauri 框架本体(由 cj-tauri create 写入的本机路径;换机器重跑 create 或手改)
18
- cjTauri = { path = "{{FRAMEWORK_ROOT_TOML}}" }
19
-
20
- [target.x86_64-unknown-linux-gnu.bin-dependencies]
21
- path-option = ["${CANGJIE_STDX}"]
22
-
23
- [target.x86_64-w64-mingw32.bin-dependencies]
24
- path-option = ["${CANGJIE_STDX}"]
25
-
26
- [target.aarch64-linux-ohos]
27
- # 鸿蒙目标:交叉编译工具链与 sysroot 由 DevEco 仓颉套件提供,路径全部走环境变量
28
- # (与框架根 cjpm.toml 同口径;末尾 --dy-std 不可省,原因见框架根 toml 的鸿蒙段注释)
29
- 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"
30
-
31
- [target.aarch64-linux-ohos.bin-dependencies]
32
- # stdx 必须用鸿蒙版(CANGJIE_STDX_OHOS,桌面版 ABI 不通);CANGJIE_OHOS_LIBS 指 DevEco
33
- # 套件的 api/lib/linux_ohos_aarch64_cjnative/ohos(仓颉标准库 + ohos API 绑定)
34
- path-option = ["${CANGJIE_STDX_OHOS}", "${CANGJIE_OHOS_LIBS}", "${AARCH64_MACRO_LIBS}", "${AARCH64_KIT_LIBS}"]
1
+ # 业务包:业务代码的唯一真相(RFC-002 §7.3——骨架永远是外壳,业务只有一份)。
2
+ # output-type = "static":桌面骨架(targets/desktop)与鸿蒙入口(targets/ohos/entry)
3
+ # 都以 path 依赖引用本包——同一份业务代码,多个目标各编各的产物。
4
+ [package]
5
+ cjc-version = "{{CJC_VERSION}}"
6
+ name = "{{PACKAGE_NAME}}"
7
+ description = "{{PROJECT_NAME}} - cj-tauri 业务包"
8
+ version = "0.1.0"
9
+ target-dir = ""
10
+ output-type = "static"
11
+ compile-option = ""
12
+ override-compile-option = ""
13
+ link-option = ""
14
+ package-configuration = {}
15
+
16
+ [dependencies]
17
+ # cj-tauri 框架本体(由 cj-tauri create 写入的本机路径;换机器重跑 create 或手改)
18
+ cjTauri = { path = "{{FRAMEWORK_ROOT_TOML}}" }
19
+
20
+ [target.x86_64-unknown-linux-gnu.bin-dependencies]
21
+ path-option = ["${CANGJIE_STDX}"]
22
+
23
+ [target.x86_64-w64-mingw32.bin-dependencies]
24
+ path-option = ["${CANGJIE_STDX}"]
25
+
26
+ [target.aarch64-linux-ohos]
27
+ # 鸿蒙目标:交叉编译工具链与 sysroot 由 DevEco 仓颉套件提供,路径全部走环境变量
28
+ # (与框架根 cjpm.toml 同口径;末尾 --dy-std 不可省,原因见框架根 toml 的鸿蒙段注释)
29
+ 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"
30
+
31
+ [target.aarch64-linux-ohos.bin-dependencies]
32
+ # stdx 必须用鸿蒙版(CANGJIE_STDX_OHOS,桌面版 ABI 不通);CANGJIE_OHOS_LIBS 指 DevEco
33
+ # 套件的 api/lib/linux_ohos_aarch64_cjnative/ohos(仓颉标准库 + ohos API 绑定)
34
+ path-option = ["${CANGJIE_STDX_OHOS}", "${CANGJIE_OHOS_LIBS}", "${AARCH64_MACRO_LIBS}", "${AARCH64_KIT_LIBS}"]
@@ -1,91 +1,91 @@
1
- package {{PACKAGE_NAME}}
2
-
3
- import cjTauri.*
4
- import cjTauri.plugins.menu.*
5
- import stdx.encoding.json.*
6
- import std.collection.*
7
-
8
- /**
9
- * greet 命令(对标 tauri command)
10
- * 前端:tauri.invoke("greet", { name: "..." })
11
- */
12
- public class GreetCommand <: CommandHandler {
13
- public init() {}
14
-
15
- public func handle(cmd: String, args: JsonObject, ipc: IpcContext): JsonValue {
16
- var name = "world"
17
- if (let Some(n) <- args.get("name")) {
18
- match (n.kind()) {
19
- case JsonKind.JsString => name = n.asString().getValue()
20
- case _ => ()
21
- }
22
- }
23
- return JsonString("Hello, ${name}! 来自仓颉后端")
24
- }
25
- }
26
-
27
- /**
28
- * 定时器命令:启动后台线程,每秒向前端推一个 tick 事件(验证 仓颉 → JS 通道)
29
- * 前端:tauri.listen("tick", cb) + tauri.invoke("timer")
30
- */
31
- public class TimerCommand <: CommandHandler {
32
- private var counter: Int64 = 0
33
- private var started: Bool = false
34
-
35
- public init() {}
36
-
37
- public func handle(cmd: String, args: JsonObject, ipc: IpcContext): JsonValue {
38
- if (!this.started) {
39
- this.started = true
40
- spawn {
41
- while (true) {
42
- sleep(Duration.second)
43
- this.counter += 1
44
- var payload = JsonObject()
45
- payload.put("n", JsonInt(this.counter))
46
- ipc.emit("tick", payload)
47
- }
48
- }
49
- }
50
- return JsonString("timer started")
51
- }
52
- }
53
-
54
- /**
55
- * 演示菜单:一个普通项 + 一个带勾选项的子菜单
56
- *
57
- * 两个方向都在页面上看得到:
58
- * 菜单 → 页面:点「打个招呼」,宿主把事件推给前端(页面 listen("menu:click") 显示 id)
59
- * 页面 → 菜单:勾选页面上的复选框,走 menu 插件改「侧边栏」这一项的勾选状态
60
- */
61
- func demoMenu(): MenuModel {
62
- var view = ArrayList<MenuItem>()
63
- view.add(MenuItem.checkbox("view.sidebar", "侧边栏", true))
64
- var items = ArrayList<MenuItem>()
65
- items.add(MenuItem.normal("file.hello", "打个招呼"))
66
- items.add(MenuItem.submenu("视图", view))
67
- return MenuModel(items)
68
- }
69
-
70
- /**
71
- * 业务装配点(RFC-002 §4.1):骨架的 launcher(targets/ 下各目标的 src)调用它取 AppSpec。
72
- *
73
- * 零平台知识:不碰宿主、不知道页面文件路径、不知道能力目录——那些由清单
74
- * (cj-tauri.toml)决定,launcher 按清单覆盖(page/window/assets/capabilities)。
75
- * dev 模式页面来自 Vite dev server(框架按 CJ_TAURI_DEV_URL 自动改写),
76
- * 发布构建加载 assets/ui/dist 的单文件产物——两种跑法业务代码完全一致。
77
- */
78
- public func build(): AppSpec {
79
- return AppSpec()
80
- .window(WindowConfig("{{PROJECT_NAME}}", 1000, 700))
81
- // menu 插件:给前端挂 window.__CJ_TAURI__.menu.setEnabled / setChecked
82
- // (插件只声明「我提供什么」,**不自动放行**——要能调,就在 capabilities 里引用
83
- // permissions: ["menu:state"],或逐条写 commands)
84
- .plugin(MenuPlugin())
85
- .wire({ app =>
86
- app.register("greet", GreetCommand())
87
- app.register("timer", TimerCommand())
88
- // 菜单栏必须在 run 之前挂:预置类宿主能力要赶在页面加载前定稿
89
- app.setMenu(demoMenu())
90
- })
91
- }
1
+ package {{PACKAGE_NAME}}
2
+
3
+ import cjTauri.*
4
+ import cjTauri.plugins.menu.*
5
+ import stdx.encoding.json.*
6
+ import std.collection.*
7
+
8
+ /**
9
+ * greet 命令(对标 tauri command)
10
+ * 前端:tauri.invoke("greet", { name: "..." })
11
+ */
12
+ public class GreetCommand <: CommandHandler {
13
+ public init() {}
14
+
15
+ public func handle(cmd: String, args: JsonObject, ipc: IpcContext): JsonValue {
16
+ var name = "world"
17
+ if (let Some(n) <- args.get("name")) {
18
+ match (n.kind()) {
19
+ case JsonKind.JsString => name = n.asString().getValue()
20
+ case _ => ()
21
+ }
22
+ }
23
+ return JsonString("Hello, ${name}! 来自仓颉后端")
24
+ }
25
+ }
26
+
27
+ /**
28
+ * 定时器命令:启动后台线程,每秒向前端推一个 tick 事件(验证 仓颉 → JS 通道)
29
+ * 前端:tauri.listen("tick", cb) + tauri.invoke("timer")
30
+ */
31
+ public class TimerCommand <: CommandHandler {
32
+ private var counter: Int64 = 0
33
+ private var started: Bool = false
34
+
35
+ public init() {}
36
+
37
+ public func handle(cmd: String, args: JsonObject, ipc: IpcContext): JsonValue {
38
+ if (!this.started) {
39
+ this.started = true
40
+ spawn {
41
+ while (true) {
42
+ sleep(Duration.second)
43
+ this.counter += 1
44
+ var payload = JsonObject()
45
+ payload.put("n", JsonInt(this.counter))
46
+ ipc.emit("tick", payload)
47
+ }
48
+ }
49
+ }
50
+ return JsonString("timer started")
51
+ }
52
+ }
53
+
54
+ /**
55
+ * 演示菜单:一个普通项 + 一个带勾选项的子菜单
56
+ *
57
+ * 两个方向都在页面上看得到:
58
+ * 菜单 → 页面:点「打个招呼」,宿主把事件推给前端(页面 listen("menu:click") 显示 id)
59
+ * 页面 → 菜单:勾选页面上的复选框,走 menu 插件改「侧边栏」这一项的勾选状态
60
+ */
61
+ func demoMenu(): MenuModel {
62
+ var view = ArrayList<MenuItem>()
63
+ view.add(MenuItem.checkbox("view.sidebar", "侧边栏", true))
64
+ var items = ArrayList<MenuItem>()
65
+ items.add(MenuItem.normal("file.hello", "打个招呼"))
66
+ items.add(MenuItem.submenu("视图", view))
67
+ return MenuModel(items)
68
+ }
69
+
70
+ /**
71
+ * 业务装配点(RFC-002 §4.1):骨架的 launcher(targets/ 下各目标的 src)调用它取 AppSpec。
72
+ *
73
+ * 零平台知识:不碰宿主、不知道页面文件路径、不知道能力目录——那些由清单
74
+ * (cj-tauri.toml)决定,launcher 按清单覆盖(page/window/assets/capabilities)。
75
+ * dev 模式页面来自 Vite dev server(框架按 CJ_TAURI_DEV_URL 自动改写),
76
+ * 发布构建加载 assets/ui/dist 的单文件产物——两种跑法业务代码完全一致。
77
+ */
78
+ public func build(): AppSpec {
79
+ return AppSpec()
80
+ .window(WindowConfig("{{PROJECT_NAME}}", 1000, 700))
81
+ // menu 插件:给前端挂 window.__CJ_TAURI__.menu.setEnabled / setChecked
82
+ // (插件只声明「我提供什么」,**不自动放行**——要能调,就在 capabilities 里引用
83
+ // permissions: ["menu:state"],或逐条写 commands)
84
+ .plugin(MenuPlugin())
85
+ .wire({ app =>
86
+ app.register("greet", GreetCommand())
87
+ app.register("timer", TimerCommand())
88
+ // 菜单栏必须在 run 之前挂:预置类宿主能力要赶在页面加载前定稿
89
+ app.setMenu(demoMenu())
90
+ })
91
+ }
@@ -1,56 +1,56 @@
1
- # {{PROJECT_NAME}}
2
-
3
- 基于 [cj-tauri]({{FRAMEWORK_ROOT}})(仓颉版 Tauri)+ Vue 3 + Vite 的应用:**仓颉后端 + 系统 WebView 前端**,
4
- 通过 `window.__CJ_TAURI__` 做 invoke/listen 双向 IPC,并由 capabilities 清单做最小权限管控。
5
-
6
- ## 目录结构(一份业务代码,骨架按目标派生)
7
-
8
- ```
9
- {{PROJECT_NAME}}/
10
- ├── cj-tauri.toml # 应用清单——单一真相(id/version/窗口/资产/能力目录)
11
- ├── cjpm.toml # 业务包(static 库;骨架以 path 依赖引用)
12
- ├── src/main.cj # 业务装配点 build(): AppSpec(零平台知识)
13
- ├── assets/
14
- │ ├── ui/ # Vue 3 + Vite 前端工程(package.json / vite.config.js / src/)
15
- │ └── capabilities/default.json # 能力白名单(命令 / 事件 / 权限集)
16
- └── targets/ # cj-tauri sync 生成的骨架(勿手改;check 判漂移)
17
- ├── desktop/ # 桌面可执行(launcher 调 build())
18
- └── ohos/ # 鸿蒙 hap 工程(DevEco + build-hap.sh)
19
- ```
20
-
21
- ## 首次运行(dev,热更新)
22
-
23
- ```bash
24
- cd assets/ui && npm install # 前端依赖(需要 Node.js)
25
- cd ../.. && cj-tauri sync # 派生 targets/ 骨架
26
- cj-tauri dev # 起 Vite dev server(改 .vue 保存即刷新)+ 编译 + 启动窗口
27
- ```
28
-
29
- ## 发布构建
30
-
31
- ```bash
32
- cj-tauri build # 先在 assets/ui 跑 npm run build,再编后端
33
- cj-tauri run
34
- ```
35
-
36
- `vite.config.js` 用 vite-plugin-singlefile:产物是 `assets/ui/dist/index.html`
37
- (js/css 内联、无外部依赖)——正是清单 `[assets] page` 指向的页面。
38
-
39
- ## 鸿蒙端(PC / 2in1)
40
-
41
- ```bash
42
- export CANGJIE_STDX_OHOS=<鸿蒙版 stdx>/linux_ohos_aarch64_cjnative/dynamic/stdx
43
- cd targets/ohos && bash build-hap.sh # 编 hap
44
- cd targets/ohos && bash build-hap.sh --install # 编完装到设备并拉起
45
- ```
46
-
47
- 提示:模板不带签名证书——首次在 DevEco 里 File → Project Structure → Signing Configs
48
- 勾「Automatically generate signature」(要登录华为账号);不签名只能编出
49
- *-unsigned.hap,装不进设备。
50
-
51
- ## 命令与能力
52
-
53
- 命令在 `src/main.cj`(`greet` / `timer` + 演示菜单),白名单在 `assets/capabilities/default.json`——
54
- 两边必须对齐:`cj-tauri check` 的三方比对会交叉核对「能力声明 × 插件自描述 × 实际装配」。
55
- 插件在某端没有实现时(如 shell/sqlite 在鸿蒙端),骨架照样编得过,运行期调用得到
56
- 可照做的「端不支持」错误(RFC-002 §4.6.4 的 P-1 桩)。
1
+ # {{PROJECT_NAME}}
2
+
3
+ 基于 [cj-tauri]({{FRAMEWORK_ROOT}})(仓颉版 Tauri)+ Vue 3 + Vite 的应用:**仓颉后端 + 系统 WebView 前端**,
4
+ 通过 `window.__CJ_TAURI__` 做 invoke/listen 双向 IPC,并由 capabilities 清单做最小权限管控。
5
+
6
+ ## 目录结构(一份业务代码,骨架按目标派生)
7
+
8
+ ```
9
+ {{PROJECT_NAME}}/
10
+ ├── cj-tauri.toml # 应用清单——单一真相(id/version/窗口/资产/能力目录)
11
+ ├── cjpm.toml # 业务包(static 库;骨架以 path 依赖引用)
12
+ ├── src/main.cj # 业务装配点 build(): AppSpec(零平台知识)
13
+ ├── assets/
14
+ │ ├── ui/ # Vue 3 + Vite 前端工程(package.json / vite.config.js / src/)
15
+ │ └── capabilities/default.json # 能力白名单(命令 / 事件 / 权限集)
16
+ └── targets/ # cj-tauri sync 生成的骨架(勿手改;check 判漂移)
17
+ ├── desktop/ # 桌面可执行(launcher 调 build())
18
+ └── ohos/ # 鸿蒙 hap 工程(DevEco + build-hap.sh)
19
+ ```
20
+
21
+ ## 首次运行(dev,热更新)
22
+
23
+ ```bash
24
+ cd assets/ui && npm install # 前端依赖(需要 Node.js)
25
+ cd ../.. && cj-tauri sync # 派生 targets/ 骨架
26
+ cj-tauri dev # 起 Vite dev server(改 .vue 保存即刷新)+ 编译 + 启动窗口
27
+ ```
28
+
29
+ ## 发布构建
30
+
31
+ ```bash
32
+ cj-tauri build # 先在 assets/ui 跑 npm run build,再编后端
33
+ cj-tauri run
34
+ ```
35
+
36
+ `vite.config.js` 用 vite-plugin-singlefile:产物是 `assets/ui/dist/index.html`
37
+ (js/css 内联、无外部依赖)——正是清单 `[assets] page` 指向的页面。
38
+
39
+ ## 鸿蒙端(PC / 2in1)
40
+
41
+ ```bash
42
+ export CANGJIE_STDX_OHOS=<鸿蒙版 stdx>/linux_ohos_aarch64_cjnative/dynamic/stdx
43
+ cd targets/ohos && bash build-hap.sh # 编 hap
44
+ cd targets/ohos && bash build-hap.sh --install # 编完装到设备并拉起
45
+ ```
46
+
47
+ 提示:模板不带签名证书——首次在 DevEco 里 File → Project Structure → Signing Configs
48
+ 勾「Automatically generate signature」(要登录华为账号);不签名只能编出
49
+ *-unsigned.hap,装不进设备。
50
+
51
+ ## 命令与能力
52
+
53
+ 命令在 `src/main.cj`(`greet` / `timer` + 演示菜单),白名单在 `assets/capabilities/default.json`——
54
+ 两边必须对齐:`cj-tauri check` 的三方比对会交叉核对「能力声明 × 插件自描述 × 实际装配」。
55
+ 插件在某端没有实现时(如 shell/sqlite 在鸿蒙端),骨架照样编得过,运行期调用得到
56
+ 可照做的「端不支持」错误(RFC-002 §4.6.4 的 P-1 桩)。
@@ -1,7 +1,7 @@
1
- {
2
- "identifier": "default",
3
- "windows": ["main"],
4
- "commands": ["greet", "timer", "system:version", "system:ping", "system:echo", "system:devtools"],
5
- "permissions": ["menu:state"],
6
- "events": ["tick", "menu:click"]
7
- }
1
+ {
2
+ "identifier": "default",
3
+ "windows": ["main"],
4
+ "commands": ["greet", "timer", "system:version", "system:ping", "system:echo", "system:devtools"],
5
+ "permissions": ["menu:state"],
6
+ "events": ["tick", "menu:click"]
7
+ }
@@ -1,25 +1,25 @@
1
- <!DOCTYPE html>
2
- <html lang="zh-CN">
3
- <head>
4
- <meta charset="utf-8" />
5
- <meta name="viewport" content="width=device-width, initial-scale=1" />
6
- <title>{{PROJECT_NAME}}</title>
7
- <style>
8
- /* 整页基础样式:组件样式在各组件里(App.vue),这里给页面底色 + 让内容整列居中,
9
- 调色板与零 Node 模板、examples/hello 一致(#16161d 深色底)。 */
10
- :root { color-scheme: dark; }
11
- /* min-height(不是 height)+ 居中:内容比视口高时 body 跟着长,顶部不会被裁掉。 */
12
- body { box-sizing: border-box; margin: 0; padding: 24px; min-height: 100vh;
13
- display: flex; flex-direction: column; align-items: center; justify-content: center;
14
- background: #16161d; color: #e6e6e6;
15
- font-family: system-ui, -apple-system, "Segoe UI", sans-serif; }
16
- /* 标题 / 提示 / 卡片同一列居中:光靠 body 的 align-items 不够——挂载点只有一个子节点,
17
- 提示行(页面来源、桥状态)很长时会把整列撑宽,卡片反而贴在左边。 */
18
- #app { width: 100%; display: flex; flex-direction: column; align-items: center; }
19
- </style>
20
- </head>
21
- <body>
22
- <div id="app"></div>
23
- <script type="module" src="/src/main.js"></script>
24
- </body>
25
- </html>
1
+ <!DOCTYPE html>
2
+ <html lang="zh-CN">
3
+ <head>
4
+ <meta charset="utf-8" />
5
+ <meta name="viewport" content="width=device-width, initial-scale=1" />
6
+ <title>{{PROJECT_NAME}}</title>
7
+ <style>
8
+ /* 整页基础样式:组件样式在各组件里(App.vue),这里给页面底色 + 让内容整列居中,
9
+ 调色板与零 Node 模板、examples/hello 一致(#16161d 深色底)。 */
10
+ :root { color-scheme: dark; }
11
+ /* min-height(不是 height)+ 居中:内容比视口高时 body 跟着长,顶部不会被裁掉。 */
12
+ body { box-sizing: border-box; margin: 0; padding: 24px; min-height: 100vh;
13
+ display: flex; flex-direction: column; align-items: center; justify-content: center;
14
+ background: #16161d; color: #e6e6e6;
15
+ font-family: system-ui, -apple-system, "Segoe UI", sans-serif; }
16
+ /* 标题 / 提示 / 卡片同一列居中:光靠 body 的 align-items 不够——挂载点只有一个子节点,
17
+ 提示行(页面来源、桥状态)很长时会把整列撑宽,卡片反而贴在左边。 */
18
+ #app { width: 100%; display: flex; flex-direction: column; align-items: center; }
19
+ </style>
20
+ </head>
21
+ <body>
22
+ <div id="app"></div>
23
+ <script type="module" src="/src/main.js"></script>
24
+ </body>
25
+ </html>
@@ -1,18 +1,18 @@
1
- {
2
- "name": "cj-tauri-ui",
3
- "private": true,
4
- "version": "0.1.0",
5
- "type": "module",
6
- "scripts": {
7
- "dev": "vite",
8
- "build": "vite build"
9
- },
10
- "dependencies": {
11
- "vue": "^3.5.13"
12
- },
13
- "devDependencies": {
14
- "@vitejs/plugin-vue": "^5.2.1",
15
- "vite": "^6.0.11",
16
- "vite-plugin-singlefile": "^2.1.0"
17
- }
18
- }
1
+ {
2
+ "name": "cj-tauri-ui",
3
+ "private": true,
4
+ "version": "0.1.0",
5
+ "type": "module",
6
+ "scripts": {
7
+ "dev": "vite",
8
+ "build": "vite build"
9
+ },
10
+ "dependencies": {
11
+ "vue": "^3.5.13"
12
+ },
13
+ "devDependencies": {
14
+ "@vitejs/plugin-vue": "^5.2.1",
15
+ "vite": "^6.0.11",
16
+ "vite-plugin-singlefile": "^2.1.0"
17
+ }
18
+ }