cj-tauri 1.1.2 → 2.0.0

package/cli/src/util.cj

@@ -1,159 +1,168 @@
-/**
- * cj-tauri CLI：通用工具层
- *
- * 路径与字符串处理统一按 UTF-8 字节做 ASCII 分隔符扫描，切分点都在 ASCII 边界上，
- * 对含中文的路径安全（仓颉迭代 String 得到的是码点，这里显式走字节以避免码点/字节混淆）。
- */
-package cli
-
-import std.fs.*
-
-// ===== 字节级字符判定 =====
-
-func isPathSep(b: UInt8): Bool {
-    return b == 0x2F || b == 0x5C // '/' or '\'
-}
-
-func isSpaceByte(b: UInt8): Bool {
-    return b == 0x20 || b == 0x09 || b == 0x0D || b == 0x0A
-}
-
-func isAsciiDigit(b: UInt8): Bool {
-    return b >= 0x30 && b <= 0x39
-}
-
-func isAsciiAlpha(b: UInt8): Bool {
-    return (b >= 0x41 && b <= 0x5A) || (b >= 0x61 && b <= 0x7A)
-}
-
-func toUpperByte(b: UInt8): UInt8 {
-    if (b >= 0x61 && b <= 0x7A) {
-        return b - 0x20
-    }
-    return b
-}
-
-func toLowerByte(b: UInt8): UInt8 {
-    if (b >= 0x41 && b <= 0x5A) {
-        return b + 0x20
-    }
-    return b
-}
-
-// ===== 路径 =====
-
-/** 拼接路径（统一用 '/'，Windows 亦兼容） */
-func joinPath(a: String, b: String): String {
-    let ab = a.toArray()
-    if (ab.size == 0) {
-        return b
-    }
-    if (isPathSep(ab[ab.size - 1])) {
-        return a + b
-    }
-    return a + "/" + b
-}
-
-/** 去掉末尾的路径分隔符 */
-func stripTrailingSep(p: String): String {
-    let b = p.toArray()
-    var n = b.size
-    while (n > 1 && isPathSep(b[n - 1])) {
-        n--
-    }
-    return String.fromUtf8(b[0..n])
-}
-
-/** 父目录；已到根或无法解析时返回 None */
-func parentDir(p: String): Option<String> {
-    let s = stripTrailingSep(p)
-    let b = s.toArray()
-    var i = b.size
-    while (i > 0) {
-        i--
-        if (isPathSep(b[i])) {
-            if (i == 0) {
-                return Some(String.fromUtf8(b[0..1])) // "/"
-            }
-            // Windows 盘符根 "C:/"
-            if (i == 2 && b[1] == 0x3A) {
-                return Some(String.fromUtf8(b[0..3]))
-            }
-            return Some(String.fromUtf8(b[0..i]))
-        }
-    }
-    return None
-}
-
-/** 最后一段（文件/目录名） */
-func baseName(p: String): String {
-    let s = stripTrailingSep(p)
-    let b = s.toArray()
-    var i = b.size
-    while (i > 0) {
-        i--
-        if (isPathSep(b[i])) {
-            return String.fromUtf8(b[i + 1..b.size])
-        }
-    }
-    return s
-}
-
-/** 去掉首尾 ASCII 空白（含 \r） */
-func trimAscii(s: String): String {
-    let b = s.toArray()
-    var start = 0
-    var end = b.size
-    while (start < end && isSpaceByte(b[start])) {
-        start++
-    }
-    while (end > start && isSpaceByte(b[end - 1])) {
-        end--
-    }
-    if (start == 0 && end == b.size) {
-        return s
-    }
-    return String.fromUtf8(b[start..end])
-}
-
-/** 路径含空格时给出告警（cjpm 的 link-option 以空格分隔，无法转义） */
-func warnIfSpacey(label: String, p: String): Unit {
-    let b = p.toArray()
-    for (x in b) {
-        if (x == 0x20) {
-            eprintln("[cj-tauri] 告警: ${label} 路径含空格，cjpm 的 link-option 可能解析失败: ${p}")
-            return
-        }
-    }
-}
-
-// ===== 文件 =====
-
-func readText(p: String): String {
-    return String.fromUtf8(File.readFrom(p))
-}
-
-/** 覆盖写（File.create 对已存在文件会抛异常，故先删） */
-func writeText(p: String, content: String): Unit {
-    if (exists(p)) {
-        remove(p)
-    }
-    let f = File.create(p)
-    f.write(content.toArray())
-    f.close()
-}
-
-func ensureDir(p: String): Unit {
-    if (!exists(p)) {
-        Directory.create(p, recursive: true)
-    }
-}
-
-func listDir(p: String): Array<FileInfo> {
-    return Directory.readFrom(p)
-}
-
-/** TOML 基本字符串转义：反斜杠与双引号 */
-func escapeTomlString(p: String): String {
-    return p.replace("\\", "\\\\").replace("\"", "\\\"")
-}
+/**
+ * cj-tauri CLI：通用工具层
+ *
+ * 路径与字符串处理统一按 UTF-8 字节做 ASCII 分隔符扫描，切分点都在 ASCII 边界上，
+ * 对含中文的路径安全（仓颉迭代 String 得到的是码点，这里显式走字节以避免码点/字节混淆）。
+ */
+package cli
+
+import std.fs.*
+
+// ===== 字节级字符判定 =====
+
+func isPathSep(b: UInt8): Bool {
+    return b == 0x2F || b == 0x5C // '/' or '\'
+}
+
+func isSpaceByte(b: UInt8): Bool {
+    return b == 0x20 || b == 0x09 || b == 0x0D || b == 0x0A
+}
+
+func isAsciiDigit(b: UInt8): Bool {
+    return b >= 0x30 && b <= 0x39
+}
+
+func isAsciiAlpha(b: UInt8): Bool {
+    return (b >= 0x41 && b <= 0x5A) || (b >= 0x61 && b <= 0x7A)
+}
+
+func toUpperByte(b: UInt8): UInt8 {
+    if (b >= 0x61 && b <= 0x7A) {
+        return b - 0x20
+    }
+    return b
+}
+
+func toLowerByte(b: UInt8): UInt8 {
+    if (b >= 0x41 && b <= 0x5A) {
+        return b + 0x20
+    }
+    return b
+}
+
+// ===== 路径 =====
+
+/** 拼接路径（统一用 '/'，Windows 亦兼容） */
+func joinPath(a: String, b: String): String {
+    let ab = a.toArray()
+    if (ab.size == 0) {
+        return b
+    }
+    if (isPathSep(ab[ab.size - 1])) {
+        return a + b
+    }
+    return a + "/" + b
+}
+
+/** 去掉末尾的路径分隔符 */
+func stripTrailingSep(p: String): String {
+    let b = p.toArray()
+    var n = b.size
+    while (n > 1 && isPathSep(b[n - 1])) {
+        n--
+    }
+    return String.fromUtf8(b[0..n])
+}
+
+/** 父目录；已到根或无法解析时返回 None */
+func parentDir(p: String): Option<String> {
+    let s = stripTrailingSep(p)
+    let b = s.toArray()
+    var i = b.size
+    while (i > 0) {
+        i--
+        if (isPathSep(b[i])) {
+            if (i == 0) {
+                return Some(String.fromUtf8(b[0..1])) // "/"
+            }
+            // Windows 盘符根 "C:/"
+            if (i == 2 && b[1] == 0x3A) {
+                return Some(String.fromUtf8(b[0..3]))
+            }
+            return Some(String.fromUtf8(b[0..i]))
+        }
+    }
+    return None
+}
+
+/** 最后一段（文件/目录名） */
+func baseName(p: String): String {
+    let s = stripTrailingSep(p)
+    let b = s.toArray()
+    var i = b.size
+    while (i > 0) {
+        i--
+        if (isPathSep(b[i])) {
+            return String.fromUtf8(b[i + 1..b.size])
+        }
+    }
+    return s
+}
+
+/** 去掉首尾 ASCII 空白（含 \r） */
+func trimAscii(s: String): String {
+    let b = s.toArray()
+    var start = 0
+    var end = b.size
+    while (start < end && isSpaceByte(b[start])) {
+        start++
+    }
+    while (end > start && isSpaceByte(b[end - 1])) {
+        end--
+    }
+    if (start == 0 && end == b.size) {
+        return s
+    }
+    return String.fromUtf8(b[start..end])
+}
+
+/** 路径含空格时给出告警（cjpm 的 link-option 以空格分隔，无法转义） */
+func warnIfSpacey(label: String, p: String): Unit {
+    let b = p.toArray()
+    for (x in b) {
+        if (x == 0x20) {
+            eprintln("[cj-tauri] 告警: ${label} 路径含空格，cjpm 的 link-option 可能解析失败: ${p}")
+            return
+        }
+    }
+}
+
+// ===== 文件 =====
+
+func readText(p: String): String {
+    return String.fromUtf8(File.readFrom(p))
+}
+
+/** 覆盖写（File.create 对已存在文件会抛异常，故先删） */
+func writeText(p: String, content: String): Unit {
+    if (exists(p)) {
+        remove(p)
+    }
+    let f = File.create(p)
+    f.write(content.toArray())
+    f.close()
+}
+
+func ensureDir(p: String): Unit {
+    if (!exists(p)) {
+        Directory.create(p, recursive: true)
+    }
+}
+
+func listDir(p: String): Array<FileInfo> {
+    return Directory.readFrom(p)
+}
+
+/** TOML 基本字符串转义：反斜杠与双引号 */
+func escapeTomlString(p: String): String {
+    return p.replace("\\", "\\\\").replace("\"", "\\\"")
+}
+
+/**
+ * 写进生成 TOML 的路径一律转正斜杠。
+ * 为什么：Windows 的 `E:\a\b` 在 TOML 基本字符串里是转义序列，`\a` / `\t` 会让 cjpm 解析期直接
+ * `errLexEscape` 失败（AGENTS §4「生成 toml 的脚本用正斜杠」）；正斜杠 cjpm 与 gcc/ld 都认。
+ */
+func toTomlPath(p: String): String {
+    return p.replace("\\", "/")
+}

package/cli/templates/app/README.md

@@ -1,80 +1,48 @@
-# {{PROJECT_NAME}}
-
-基于 [cj-tauri]({{FRAMEWORK_ROOT}})（仓颉版 Tauri）的应用：**仓颉后端 + 系统 WebView 前端**，
-通过 `window.__CJ_TAURI__` 做 invoke/listen 双向 IPC，并由 capability 清单做最小权限管控。
-
-## 目录结构
-
-```
-{{PROJECT_NAME}}/
-├── cjpm.toml              # 应用构建配置（依赖 cj-tauri 框架）
-├── src/main.cj            # 仓颉入口：窗口配置 + 命令注册 + 启动
-├── ui/index.html          # 前端页面（任意 Web 技术栈）
-└── capabilities/default.json  # 能力白名单（命令 / 事件）
-```
-
-## 运行
-
-```bash
-# 开发：构建 C 桥 + 编译 + 启动窗口
-cj-tauri dev
-
-# 仅构建 / 仅运行
-cj-tauri build
-cj-tauri run
-```
-
-不带 CLI 时手动运行：
-
-```bash
-cjpm build
-# 需要把「框架 native 目录 + stdx 目录 + 仓颉运行时目录」加入动态库搜索路径后，
-# 在项目根目录（capabilities/ 与 ui/ 是相对路径读取）启动：
-#   Linux:   LD_LIBRARY_PATH=<native>:<stdx>:<cangjie runtime/lib> ./target/release/bin/main
-#   Windows: set PATH=<native>;<native>\webview2;<stdx>;<cangjie>\runtime\lib\windows_x86_64_cjnative;%PATH%
-#            target\release\bin\main.exe
-```
-
-## 窗口配置
-
-```cangjie
-let app = TauriApp()
-    .window(WindowConfig("我的应用", 1200, 800))   // 标题 / 宽 / 高
-```
-
-默认标题 `cj-tauri 应用`、1000×700、允许开发者工具；
-`WindowConfig.devTools = false` 可禁用，前端 `invoke('system:devtools')` 可在运行时打开（需在能力清单里声明）。
-
-## 加一个命令
-
-1. 在 `src/main.cj` 实现 `CommandHandler`：
-
-```cangjie
-public class PingCommand <: CommandHandler {
-    public init() {}
-    public func handle(cmd: String, args: JsonObject, ipc: IpcContext): JsonValue {
-        return JsonString("pong")
-    }
-}
-```
-
-2. 注册：`.register("ping", PingCommand())`
-3. 在 `capabilities/default.json` 的 `commands` 里声明 `"ping"`（**不声明会被拒绝**；
-   清单由框架在 `run()` 时自动扫描 `capabilities/` 目录，无需自己读文件）
-4. 前端调用：`window.__CJ_TAURI__.invoke('ping').then(...)`
-
-## 后端推事件
-
-```cangjie
-var payload = JsonObject()
-payload.put("n", JsonInt(1))
-ipc.emit("tick", payload)     // 需在 capabilities 的 events 中声明 "tick"
-```
-
-```js
-window.__CJ_TAURI__.listen('tick', function (payload) { console.log(payload.n); });
-```
-
-## 文档
-
-框架完整文档：`{{FRAMEWORK_ROOT}}/README.md` 与 `{{FRAMEWORK_ROOT}}/docs/使用文档.md`
+# {{PROJECT_NAME}}
+
+基于 [cj-tauri]({{FRAMEWORK_ROOT}})（仓颉版 Tauri）的应用：**仓颉后端 + 系统 WebView 前端**，
+通过 `window.__CJ_TAURI__` 做 invoke/listen 双向 IPC，并由 capabilities 清单做最小权限管控。
+
+## 目录结构（一份业务代码，骨架按目标派生）
+
+```
+{{PROJECT_NAME}}/
+├── cj-tauri.toml           # 应用清单——单一真相（id/version/窗口/资产/能力目录）
+├── cjpm.toml               # 业务包（static 库；骨架以 path 依赖引用）
+├── src/main.cj             # 业务装配点 build(): AppSpec（零平台知识）
+├── assets/
+│   ├── ui/index.html       # 前端页面（任意 Web 技术栈）
+│   └── capabilities/default.json   # 能力白名单（命令 / 事件 / 权限集）
+└── targets/                # cj-tauri sync 生成的骨架（勿手改；check 判漂移）
+    ├── desktop/            #   桌面可执行（launcher 调 build()）
+    └── ohos/               #   鸿蒙 hap 工程（DevEco + build-hap.sh）
+```
+
+## 运行
+
+```bash
+cj-tauri sync     # 派生 targets/ 骨架（首次；重跑幂等）
+cj-tauri dev      # 构建 C 桥 + 编译 + 启动窗口
+cj-tauri build    # 仅构建
+cj-tauri run      # 运行已构建产物
+cj-tauri check    # 清单校验 + 骨架漂移 + 插件三方比对
+```
+
+## 鸿蒙端（PC / 2in1）
+
+```bash
+export CANGJIE_STDX_OHOS=<鸿蒙版 stdx>/linux_ohos_aarch64_cjnative/dynamic/stdx
+cd targets/ohos && bash build-hap.sh            # 编 hap
+cd targets/ohos && bash build-hap.sh --install  # 编完装到设备并拉起
+```
+
+提示：模板不带签名证书——首次在 DevEco 里 File → Project Structure → Signing Configs
+勾「Automatically generate signature」（要登录华为账号）；不签名只能编出
+*-unsigned.hap，装不进设备。
+
+## 命令与能力
+
+命令在 `src/main.cj`（`greet` / `timer` + 演示菜单），白名单在 `assets/capabilities/default.json`——
+两边必须对齐：`cj-tauri check` 的三方比对会交叉核对「能力声明 × 插件自描述 × 实际装配」。
+插件在某端没有实现时（如 shell/sqlite 在鸿蒙端），骨架照样编得过，运行期调用得到
+可照做的「端不支持」错误（RFC-002 §4.6.4 的 P-1 桩）。

package/cli/templates/app/{capabilities → assets/capabilities}/default.json

@@ -1,7 +1,7 @@
-{
-  "identifier": "default",
-  "windows": ["main"],
-  "commands": ["greet", "timer", "system:version", "system:ping", "system:echo", "system:devtools"],
-  "permissions": ["menu:state"],
-  "events": ["tick", "menu:click"]
-}
+{
+  "identifier": "default",
+  "windows": ["main"],
+  "commands": ["greet", "timer", "system:version", "system:ping", "system:echo", "system:devtools"],
+  "permissions": ["menu:state"],
+  "events": ["tick", "menu:click"]
+}