cj-tauri 1.1.2 → 2.0.0

package/cli/templates/{ohos-pc → ohos-skeleton}/entry/src/main/cangjie/index.cj

@@ -1,167 +1,167 @@
-package ohos_app_cangjie_entry
-
-import kit.ArkUI.*
-import kit.ArkWeb.*
-import kit.PerformanceAnalysisKit.Hilog
-import ohos.arkui.component.web.Web
-import ohos.arkui.state_macro_manage.*
-import cjTauri.*
-
-/*
- * 应用侧的 ArkWeb 宿主组件
- *
- * 这个 `@Component` **必须住在应用模块里**，不能由框架包提供：框架包一旦 import
- * `kit.ArkUI.*` / `kit.ArkWeb.*`，合并进应用动态库后包初始化链会跳到坏地址、启动即 SIGSEGV。
- * 框架侧只留 `arkWebProxyPost` / `arkWebProxyPoll` 两个不碰 ArkUI 的桥接函数。
- *
- * 单窗口版：label 用框架默认的 DEFAULT_WINDOW_LABEL。要做多窗口就照着加一份、
- * 换成别的 label（框架的宿主路由是按 label 查的，不会串台）。
- */
-
-/**
- * proxy 的 `post` 入口：先交给框架处理报文，再把队列里的脚本推回页面
- *
- * 为什么「顺手推」放在这里：`javaScriptProxy` 的回调就在 UI 线程上，而
- * `controller.runJavaScript` 也必须在 UI 线程调。页面 → 原生的**返回值通道不可用**
- * （实测恒为 `null`），所以鸿蒙侧只能「页面发心跳 → 原生在该回调里把待执行脚本推出去」，
- * 这是唯一的回投路径；框架会把它收到的 invoke 结果 / event 都排进这个队列。
- */
-func onProxyPost(label: String, raw: String, ctrl: WebviewController): String {
-    let ack = arkWebProxyPost(label, raw)
-    match (ArkWebRuntime.hostFor(label)) {
-        case Some(h) =>
-            let pending = h.takePendingScripts()
-            var i = 0
-            while (i < pending.size) {
-                ctrl.runJavaScript(pending[i], { _, _ => () })
-                i += 1
-            }
-        case None => ()
-    }
-    return ack
-}
-
-@Component
-class CjTauriWebView {
-    /* label 决定：①页面里 __CJ_TAURI_LABEL__ ②报文里的 window 字段 ③宿主取哪份页面来源。
-       必须是 `@Prop`：普通成员会被宏展开成 ObservedProperty 形参，外面传字符串进来会报
-       「expected 4 arguments」。 */
-    @Prop
-    var windowLabel: String
-
-    /* 组件生命周期内必须保持同一个 controller 实例（ArkWeb 的硬约束） */
-    private let controller: WebviewController = WebviewController()
-
-    /* 页面地址由宿主给定；@State 让它参与刷新（宿主登记页面往往晚于组件首次 build）。
-       `@State` 不允许与 private/public/static 同用——宏会直接拒绝。 */
-    @State
-    var pageUrl: String = ""
-
-    public func build() {
-        Column {
-            if (this.pageUrl.size > 0) {
-                Web(src: this.pageUrl, controller: this.controller)
-                    .width(100.percent)
-                    .height(100.percent)
-                    .fileAccess(true)
-                    .javaScriptProxy(
-                        funcList: [
-                            { raw => onProxyPost(this.windowLabel, raw, this.controller) },
-                            /* `poll` 只为兼容页面上可能残留的旧桥脚本：返回值传不回 JS，
-                               真正的脚本推送已在 `onProxyPost` 里完成。 */
-                            { _ => "" }
-                        ],
-                        name: ARKWEB_PROXY_NAME, methodList: ["post", "poll"],
-                        controller: this.controller
-                    )
-                    .onPageBegin({ _ => this.onPageBegin() })
-                    .onPageEnd({ _ => this.onPageEnd() })
-            }
-        }.width(100.percent).height(100.percent)
-    }
-
-    /**
-     * 组件挂载钩子（首次 `build()` 之前调用一次）
-     *
-     * **必须在这里同步宿主地址**：宿主把页面落盘后才把 `file://` 地址放进自己的字段，
-     * 而 `build()` 是声明式的一次性求值——`pageUrl` 仍为空就永远不建 `Web`，
-     * `onPageBegin` 也就永远不会来，页面白屏。
-     */
-    protected override func aboutToAppear(): Unit {
-        match (ArkWebRuntime.hostFor(this.windowLabel)) {
-            case Some(h) =>
-                let u = h.currentUrl()
-                if (u.size > 0) {
-                    this.pageUrl = u
-                }
-                Hilog.info(1, "CjTauri", "aboutToAppear label=${this.windowLabel} pageUrl=${u}")
-            case None => Hilog.info(1, "CjTauri", "aboutToAppear without host")
-        }
-    }
-
-    private func onPageBegin(): Unit {
-        Hilog.info(1, "CjTauri", "page begin label=${this.windowLabel}")
-        match (ArkWebRuntime.hostFor(this.windowLabel)) {
-            case Some(h) =>
-                h.notePageBegin()
-                let url = h.currentUrl()
-                if (url.size > 0 && url != this.pageUrl) {
-                    this.pageUrl = url
-                }
-                // 桥脚本与插件 shim 都在 initScripts 里：ArkWeb 没有 document-start 注入，
-                // `onPageBegin` 是能拿到的最早时机。
-                for (js in h.initScriptsSnapshot()) {
-                    this.runScript(js)
-                }
-                this.runScript(arkWebLabelScript(this.windowLabel))
-            case None => Hilog.info(1, "CjTauri", "page begin without host: label=${this.windowLabel}")
-        }
-    }
-
-    private func onPageEnd(): Unit {
-        Hilog.info(1, "CjTauri", "page end label=${this.windowLabel}")
-        match (ArkWebRuntime.hostFor(this.windowLabel)) {
-            case Some(h) =>
-                h.notePageEnd()
-                // 组件首次 build 时宿主可能还没登记（页面为空），这里再同步一次并触发刷新
-                let url = h.currentUrl()
-                if (url.size > 0 && url != this.pageUrl) {
-                    this.pageUrl = url
-                }
-            case None => ()
-        }
-    }
-
-    /** 单条脚本执行（ArkWeb 的 runJavaScript 是异步的，回调里只做失败日志） */
-    private func runScript(js: String): Unit {
-        if (js.size == 0) {
-            return
-        }
-        // runJavaScript(script, callback) 两个都是位置参数（命名参数前缀会被编译器拒）
-        this.controller.runJavaScript(
-            js,
-            {
-                err, result =>
-                    match (err) {
-                        case Some(e) => Hilog.info(1, "CjTauri", "runJavaScript failed: ${e.message}")
-                        case None => Hilog.info(1, "CjTauri", "runJavaScript ok")
-                    }
-                    let _ = result
-            }
-        )
-    }
-}
-
-@Entry
-@Component
-class EntryView {
-    func build() {
-        Column {
-            // 高度由**外层容器**给：自定义组件的调用点不能挂链式修饰（`.height(...)`），
-            // 那样宏展开时补不上 `__gen_parent`，报的是「missing arguments for parameter list」。
-            Column() {
-                CjTauriWebView(windowLabel: DEFAULT_WINDOW_LABEL)
-            }.width(100.percent).height(100.percent)
-        }.width(100.percent).height(100.percent)
-    }
-}
+package ohos_app_cangjie_entry
+
+import kit.ArkUI.*
+import kit.ArkWeb.*
+import kit.PerformanceAnalysisKit.Hilog
+import ohos.arkui.component.web.Web
+import ohos.arkui.state_macro_manage.*
+import cjTauri.*
+
+/*
+ * 应用侧的 ArkWeb 宿主组件
+ *
+ * 这个 `@Component` **必须住在应用模块里**，不能由框架包提供：框架包一旦 import
+ * `kit.ArkUI.*` / `kit.ArkWeb.*`，合并进应用动态库后包初始化链会跳到坏地址、启动即 SIGSEGV。
+ * 框架侧只留 `arkWebProxyPost` / `arkWebProxyPoll` 两个不碰 ArkUI 的桥接函数。
+ *
+ * 单窗口版：label 用框架默认的 DEFAULT_WINDOW_LABEL。要做多窗口就照着加一份、
+ * 换成别的 label（框架的宿主路由是按 label 查的，不会串台）。
+ */
+
+/**
+ * proxy 的 `post` 入口：先交给框架处理报文，再把队列里的脚本推回页面
+ *
+ * 为什么「顺手推」放在这里：`javaScriptProxy` 的回调就在 UI 线程上，而
+ * `controller.runJavaScript` 也必须在 UI 线程调。页面 → 原生的**返回值通道不可用**
+ * （实测恒为 `null`），所以鸿蒙侧只能「页面发心跳 → 原生在该回调里把待执行脚本推出去」，
+ * 这是唯一的回投路径；框架会把它收到的 invoke 结果 / event 都排进这个队列。
+ */
+func onProxyPost(label: String, raw: String, ctrl: WebviewController): String {
+    let ack = arkWebProxyPost(label, raw)
+    match (ArkWebRuntime.hostFor(label)) {
+        case Some(h) =>
+            let pending = h.takePendingScripts()
+            var i = 0
+            while (i < pending.size) {
+                ctrl.runJavaScript(pending[i], { _, _ => () })
+                i += 1
+            }
+        case None => ()
+    }
+    return ack
+}
+
+@Component
+class CjTauriWebView {
+    /* label 决定：①页面里 __CJ_TAURI_LABEL__ ②报文里的 window 字段 ③宿主取哪份页面来源。
+       必须是 `@Prop`：普通成员会被宏展开成 ObservedProperty 形参，外面传字符串进来会报
+       「expected 4 arguments」。 */
+    @Prop
+    var windowLabel: String
+
+    /* 组件生命周期内必须保持同一个 controller 实例（ArkWeb 的硬约束） */
+    private let controller: WebviewController = WebviewController()
+
+    /* 页面地址由宿主给定；@State 让它参与刷新（宿主登记页面往往晚于组件首次 build）。
+       `@State` 不允许与 private/public/static 同用——宏会直接拒绝。 */
+    @State
+    var pageUrl: String = ""
+
+    public func build() {
+        Column {
+            if (this.pageUrl.size > 0) {
+                Web(src: this.pageUrl, controller: this.controller)
+                    .width(100.percent)
+                    .height(100.percent)
+                    .fileAccess(true)
+                    .javaScriptProxy(
+                        funcList: [
+                            { raw => onProxyPost(this.windowLabel, raw, this.controller) },
+                            /* `poll` 只为兼容页面上可能残留的旧桥脚本：返回值传不回 JS，
+                               真正的脚本推送已在 `onProxyPost` 里完成。 */
+                            { _ => "" }
+                        ],
+                        name: ARKWEB_PROXY_NAME, methodList: ["post", "poll"],
+                        controller: this.controller
+                    )
+                    .onPageBegin({ _ => this.onPageBegin() })
+                    .onPageEnd({ _ => this.onPageEnd() })
+            }
+        }.width(100.percent).height(100.percent)
+    }
+
+    /**
+     * 组件挂载钩子（首次 `build()` 之前调用一次）
+     *
+     * **必须在这里同步宿主地址**：宿主把页面落盘后才把 `file://` 地址放进自己的字段，
+     * 而 `build()` 是声明式的一次性求值——`pageUrl` 仍为空就永远不建 `Web`，
+     * `onPageBegin` 也就永远不会来，页面白屏。
+     */
+    protected override func aboutToAppear(): Unit {
+        match (ArkWebRuntime.hostFor(this.windowLabel)) {
+            case Some(h) =>
+                let u = h.currentUrl()
+                if (u.size > 0) {
+                    this.pageUrl = u
+                }
+                Hilog.info(1, "CjTauri", "aboutToAppear label=${this.windowLabel} pageUrl=${u}")
+            case None => Hilog.info(1, "CjTauri", "aboutToAppear without host")
+        }
+    }
+
+    private func onPageBegin(): Unit {
+        Hilog.info(1, "CjTauri", "page begin label=${this.windowLabel}")
+        match (ArkWebRuntime.hostFor(this.windowLabel)) {
+            case Some(h) =>
+                h.notePageBegin()
+                let url = h.currentUrl()
+                if (url.size > 0 && url != this.pageUrl) {
+                    this.pageUrl = url
+                }
+                // 桥脚本与插件 shim 都在 initScripts 里：ArkWeb 没有 document-start 注入，
+                // `onPageBegin` 是能拿到的最早时机。
+                for (js in h.initScriptsSnapshot()) {
+                    this.runScript(js)
+                }
+                this.runScript(arkWebLabelScript(this.windowLabel))
+            case None => Hilog.info(1, "CjTauri", "page begin without host: label=${this.windowLabel}")
+        }
+    }
+
+    private func onPageEnd(): Unit {
+        Hilog.info(1, "CjTauri", "page end label=${this.windowLabel}")
+        match (ArkWebRuntime.hostFor(this.windowLabel)) {
+            case Some(h) =>
+                h.notePageEnd()
+                // 组件首次 build 时宿主可能还没登记（页面为空），这里再同步一次并触发刷新
+                let url = h.currentUrl()
+                if (url.size > 0 && url != this.pageUrl) {
+                    this.pageUrl = url
+                }
+            case None => ()
+        }
+    }
+
+    /** 单条脚本执行（ArkWeb 的 runJavaScript 是异步的，回调里只做失败日志） */
+    private func runScript(js: String): Unit {
+        if (js.size == 0) {
+            return
+        }
+        // runJavaScript(script, callback) 两个都是位置参数（命名参数前缀会被编译器拒）
+        this.controller.runJavaScript(
+            js,
+            {
+                err, result =>
+                    match (err) {
+                        case Some(e) => Hilog.info(1, "CjTauri", "runJavaScript failed: ${e.message}")
+                        case None => Hilog.info(1, "CjTauri", "runJavaScript ok")
+                    }
+                    let _ = result
+            }
+        )
+    }
+}
+
+@Entry
+@Component
+class EntryView {
+    func build() {
+        Column {
+            // 高度由**外层容器**给：自定义组件的调用点不能挂链式修饰（`.height(...)`），
+            // 那样宏展开时补不上 `__gen_parent`，报的是「missing arguments for parameter list」。
+            Column() {
+                CjTauriWebView(windowLabel: DEFAULT_WINDOW_LABEL)
+            }.width(100.percent).height(100.percent)
+        }.width(100.percent).height(100.percent)
+    }
+}

package/cli/templates/{ohos-pc → ohos-skeleton}/entry/src/main/cangjie/main_ability.cj

@@ -1,139 +1,139 @@
-package ohos_app_cangjie_entry
-
-import kit.PerformanceAnalysisKit.Hilog
-import kit.AbilityKit.Want
-import kit.AbilityKit.UIAbility
-import kit.AbilityKit.LaunchParam
-import kit.AbilityKit.LaunchReason
-import kit.ArkUI.WindowStage
-import ohos.display.getDefaultDisplaySync
-import ohos.resource_manager.*
-import cjTauri.*
-
-/*
- * {{PROJECT_NAME}} 的 UIAbility
- *
- * 鸿蒙应用没有「自己起进程跑一个 main」这回事：窗口属于 ArkUI、页面由 ArkWeb 组件承载。
- * 所以桌面的 `main()` 在这里被拆成三段：
- * ① 把沙箱目录告诉框架（`run(html)` 要把页面落到沙箱再以 file:// 加载）；
- * ② 在**非 UI 线程**上装配并跑框架应用（`run()` 阻塞到 quit()，UI 线程要留给 ArkUI 建树）；
- * ③ 等框架把默认窗口的宿主登记好，再 `loadContent`。
- *
- * 页面与能力清单都是 hap 里的 `resources/rawfile/` 真文件，运行期读成字符串：
- *   rawfile/index.html        ← 就是桌面工程的 ui/index.html（改了重建即可）
- *   rawfile/capabilities.json ← 就是桌面的 capabilities 目录下那份 default.json
- * 好处是 DevEco 里直接点 Build 也能编过（不需要先跑一次生成脚本）。
- */
-class MainAbility <: UIAbility {
-    public init() {
-        super()
-        registerSelf()
-    }
-
-    public override func onCreate(want: Want, launchParam: LaunchParam): Unit {
-        Hilog.info(1, "CjTauri", "MainAbility OnCreated.${want.abilityName}")
-
-        // 1) 沙箱目录要在 run() 之前给定：run(html) 把页面写成文件再以 file:// 加载
-        //    （ArkWeb 的仓颉绑定没有 loadData）。
-        let filesDir = "${this.context.filesDir}"
-        ArkWebRuntime.configure(filesDir)
-
-        // 2) 页面与能力清单：从 hap 的 rawfile 读（读不到就是构建期没打进去，如实报一行）
-        let pageHtml = this.readRawText("index.html")
-        let capsJson = this.readRawText("capabilities.json")
-        if (pageHtml.size == 0) {
-            Hilog.info(1, "CjTauri", "rawfile/index.html 读不到，页面将只显示一句提示")
-        }
-
-        // 3) run() 会阻塞到 quit()，只能在非 UI 线程上跑——UI 线程要留给 ArkUI 建树。
-        let _ = spawn { startTauriApp("{{APP_LABEL}}", pageHtml, capsJson) }
-
-        match (launchParam.launchReason) {
-            case LaunchReason.StartAbility => Hilog.info(1, "CjTauri", "START_ABILITY")
-            case _ => ()
-        }
-    }
-
-    public override func onWindowStageCreate(windowStage: WindowStage): Unit {
-        Hilog.info(1, "CjTauri", "MainAbility onWindowStageCreate.")
-        this.logDefaultWindowRect(windowStage)
-        // 等框架把宿主登记上再建树：组件的 build() 只有在该 label 有宿主、页面地址非空时
-        // 才渲染 `Web`。等不到也照常 loadContent——页面会自己报桥缺失，比静默白屏好排查。
-        this.waitAndLogHost(DEFAULT_WINDOW_LABEL)
-        windowStage.loadContent("EntryView")
-    }
-
-    /**
-     * 读 hap 里的 rawfile（路径相对 `resources/rawfile/`）
-     *
-     * 读失败返回空串并把原因打进 hilog：调用方按「空 = 没有」降级，不让异常冒到生命周期里
-     * （生命周期里抛异常，应用直接退，页面上看到的是「点了图标没反应」）。
-     */
-    private func readRawText(path: String): String {
-        try {
-            let bytes = this.context.resourceManager.getRawFileContent(path)
-            Hilog.info(1, "CjTauri", "rawfile ${path} bytes=${bytes.size}")
-            return String.fromUtf8(bytes)
-        } catch (e: Exception) {
-            Hilog.info(1, "CjTauri", "rawfile ${path} 读取失败: ${e}")
-            return ""
-        }
-    }
-
-    /**
-     * 不干预窗口尺寸：**鸿蒙 PC 上系统给的默认窗口就是答案**
-     *
-     * 早先这里自己 `resize()` 定尺寸（先按屏幕比例 86%×84% = 2683×1747、后按逻辑 1000×700 vp），
-     * 两版都是在跟平台的默认窗口抢方向盘：实测系统本来就按桌面形态给一扇约 2/3 屏宽的窗
-     * （3120×2080 的屏上初始矩形 `[515 281 2090 1394]`，即 2090×1394 px ≈ 1100×734 vp），
-     * 而紧接着的 resize 把它改成 1900×1330——屏上看到的是「先弹一个尺寸、随即变成另一个」，
-     * 观感就是窗口莫名跳一下。所以模板**默认不碰窗口尺寸**，只读取矩形打一行日志作凭证；
-     * 应用真需要固定尺寸时自己调 `windowStage.getMainWindow().resize()`。
-     * 前提是 `entry/build-profile.json5` 的 `deviceTypes` 写成 `2in1` 且
-     * `cangjieOptions.checkDeviceTypes=false` 放行——写成 phone/tablet 时系统按手机应用塞进
-     * 竖屏兼容窗（约 600 宽），那种情况才需要自己定尺寸。
-     */
-    private func logDefaultWindowRect(windowStage: WindowStage): Unit {
-        try {
-            let screen = getDefaultDisplaySync()
-            let screenW = Int64(screen.width)
-            let screenH = Int64(screen.height)
-            // `densityPixels` 是 **Float32**（.cj.d 里看着像 Float64），先化成整数百分比再参与运算。
-            let densityRaw = screen.densityPixels
-            let densityPct = Int64(densityRaw * 100.0)
-            let mainWin = windowStage.getMainWindow()
-            let r = mainWin.getWindowProperties().windowRect
-            Hilog.info(1, "CjTauri", "main window keeps system default ${r.width}x${r.height} px at density ${densityPct}% on screen ${screenW}x${screenH}, rect=[${r.left} ${r.top} ${r.width} ${r.height}]")
-        } catch (e: Exception) {
-            Hilog.info(1, "CjTauri", "main window geometry read failed: ${e}")
-        }
-    }
-
-    /**
-     * 有界等待（3s）默认窗口的宿主登记完成，并把页面地址 / 预执行脚本条数打进 hilog
-     *
-     * 白屏定位用：宿主把页面落盘后的 file:// 地址必须非空，否则组件拿不到 src。
-     */
-    private func waitAndLogHost(label: String): Unit {
-        var polls = 0
-        while (polls < 300) {
-            match (ArkWebRuntime.hostFor(label)) {
-                case Some(_) => break
-                case None => ()
-            }
-            sleep(Duration.millisecond * 10)
-            polls += 1
-        }
-        if (polls >= 300) {
-            Hilog.info(1, "CjTauri", "host not registered in 3s: label=${label}")
-            return
-        }
-        Hilog.info(1, "CjTauri", "host registered after ${polls} polls label=${label}")
-        match (ArkWebRuntime.hostFor(label)) {
-            case Some(h) =>
-                Hilog.info(1, "CjTauri", "host pageUrl label=${label} url=\"${h.currentUrl()}\"")
-                Hilog.info(1, "CjTauri", "host initScripts label=${label} count=${h.initScriptsSnapshot().size}")
-            case None => Hilog.info(1, "CjTauri", "host missing at loadContent label=${label}")
-        }
-    }
-}
+package ohos_app_cangjie_entry
+
+import kit.PerformanceAnalysisKit.Hilog
+import kit.AbilityKit.Want
+import kit.AbilityKit.UIAbility
+import kit.AbilityKit.LaunchParam
+import kit.AbilityKit.LaunchReason
+import kit.ArkUI.WindowStage
+import ohos.display.getDefaultDisplaySync
+import ohos.resource_manager.*
+import cjTauri.*
+
+/*
+ * {{PROJECT_NAME}} 的 UIAbility
+ *
+ * 鸿蒙应用没有「自己起进程跑一个 main」这回事：窗口属于 ArkUI、页面由 ArkWeb 组件承载。
+ * 所以桌面的 `main()` 在这里被拆成三段：
+ * ① 把沙箱目录告诉框架（`run(html)` 要把页面落到沙箱再以 file:// 加载）；
+ * ② 在**非 UI 线程**上装配并跑框架应用（`run()` 阻塞到 quit()，UI 线程要留给 ArkUI 建树）；
+ * ③ 等框架把默认窗口的宿主登记好，再 `loadContent`。
+ *
+ * 页面与能力清单都是 hap 里的 `resources/rawfile/` 真文件，运行期读成字符串：
+ *   rawfile/index.html        ← 就是桌面工程的 ui/index.html（改了重建即可）
+ *   rawfile/capabilities.json ← 就是桌面的 capabilities 目录下那份 default.json
+ * 好处是 DevEco 里直接点 Build 也能编过（不需要先跑一次生成脚本）。
+ */
+class MainAbility <: UIAbility {
+    public init() {
+        super()
+        registerSelf()
+    }
+
+    public override func onCreate(want: Want, launchParam: LaunchParam): Unit {
+        Hilog.info(1, "CjTauri", "MainAbility OnCreated.${want.abilityName}")
+
+        // 1) 沙箱目录要在 run() 之前给定：run(html) 把页面写成文件再以 file:// 加载
+        //    （ArkWeb 的仓颉绑定没有 loadData）。
+        let filesDir = "${this.context.filesDir}"
+        ArkWebRuntime.configure(filesDir)
+
+        // 2) 页面与能力清单：从 hap 的 rawfile 读（读不到就是构建期没打进去，如实报一行）
+        let pageHtml = this.readRawText("index.html")
+        let capsJson = this.readRawText("capabilities.json")
+        if (pageHtml.size == 0) {
+            Hilog.info(1, "CjTauri", "rawfile/index.html 读不到，页面将只显示一句提示")
+        }
+
+        // 3) run() 会阻塞到 quit()，只能在非 UI 线程上跑——UI 线程要留给 ArkUI 建树。
+        let _ = spawn { startTauriApp("{{APP_LABEL}}", pageHtml, capsJson) }
+
+        match (launchParam.launchReason) {
+            case LaunchReason.StartAbility => Hilog.info(1, "CjTauri", "START_ABILITY")
+            case _ => ()
+        }
+    }
+
+    public override func onWindowStageCreate(windowStage: WindowStage): Unit {
+        Hilog.info(1, "CjTauri", "MainAbility onWindowStageCreate.")
+        this.logDefaultWindowRect(windowStage)
+        // 等框架把宿主登记上再建树：组件的 build() 只有在该 label 有宿主、页面地址非空时
+        // 才渲染 `Web`。等不到也照常 loadContent——页面会自己报桥缺失，比静默白屏好排查。
+        this.waitAndLogHost(DEFAULT_WINDOW_LABEL)
+        windowStage.loadContent("EntryView")
+    }
+
+    /**
+     * 读 hap 里的 rawfile（路径相对 `resources/rawfile/`）
+     *
+     * 读失败返回空串并把原因打进 hilog：调用方按「空 = 没有」降级，不让异常冒到生命周期里
+     * （生命周期里抛异常，应用直接退，页面上看到的是「点了图标没反应」）。
+     */
+    private func readRawText(path: String): String {
+        try {
+            let bytes = this.context.resourceManager.getRawFileContent(path)
+            Hilog.info(1, "CjTauri", "rawfile ${path} bytes=${bytes.size}")
+            return String.fromUtf8(bytes)
+        } catch (e: Exception) {
+            Hilog.info(1, "CjTauri", "rawfile ${path} 读取失败: ${e}")
+            return ""
+        }
+    }
+
+    /**
+     * 不干预窗口尺寸：**鸿蒙 PC 上系统给的默认窗口就是答案**
+     *
+     * 早先这里自己 `resize()` 定尺寸（先按屏幕比例 86%×84% = 2683×1747、后按逻辑 1000×700 vp），
+     * 两版都是在跟平台的默认窗口抢方向盘：实测系统本来就按桌面形态给一扇约 2/3 屏宽的窗
+     * （3120×2080 的屏上初始矩形 `[515 281 2090 1394]`，即 2090×1394 px ≈ 1100×734 vp），
+     * 而紧接着的 resize 把它改成 1900×1330——屏上看到的是「先弹一个尺寸、随即变成另一个」，
+     * 观感就是窗口莫名跳一下。所以模板**默认不碰窗口尺寸**，只读取矩形打一行日志作凭证；
+     * 应用真需要固定尺寸时自己调 `windowStage.getMainWindow().resize()`。
+     * 前提是 `entry/build-profile.json5` 的 `deviceTypes` 写成 `2in1` 且
+     * `cangjieOptions.checkDeviceTypes=false` 放行——写成 phone/tablet 时系统按手机应用塞进
+     * 竖屏兼容窗（约 600 宽），那种情况才需要自己定尺寸。
+     */
+    private func logDefaultWindowRect(windowStage: WindowStage): Unit {
+        try {
+            let screen = getDefaultDisplaySync()
+            let screenW = Int64(screen.width)
+            let screenH = Int64(screen.height)
+            // `densityPixels` 是 **Float32**（.cj.d 里看着像 Float64），先化成整数百分比再参与运算。
+            let densityRaw = screen.densityPixels
+            let densityPct = Int64(densityRaw * 100.0)
+            let mainWin = windowStage.getMainWindow()
+            let r = mainWin.getWindowProperties().windowRect
+            Hilog.info(1, "CjTauri", "main window keeps system default ${r.width}x${r.height} px at density ${densityPct}% on screen ${screenW}x${screenH}, rect=[${r.left} ${r.top} ${r.width} ${r.height}]")
+        } catch (e: Exception) {
+            Hilog.info(1, "CjTauri", "main window geometry read failed: ${e}")
+        }
+    }
+
+    /**
+     * 有界等待（3s）默认窗口的宿主登记完成，并把页面地址 / 预执行脚本条数打进 hilog
+     *
+     * 白屏定位用：宿主把页面落盘后的 file:// 地址必须非空，否则组件拿不到 src。
+     */
+    private func waitAndLogHost(label: String): Unit {
+        var polls = 0
+        while (polls < 300) {
+            match (ArkWebRuntime.hostFor(label)) {
+                case Some(_) => break
+                case None => ()
+            }
+            sleep(Duration.millisecond * 10)
+            polls += 1
+        }
+        if (polls >= 300) {
+            Hilog.info(1, "CjTauri", "host not registered in 3s: label=${label}")
+            return
+        }
+        Hilog.info(1, "CjTauri", "host registered after ${polls} polls label=${label}")
+        match (ArkWebRuntime.hostFor(label)) {
+            case Some(h) =>
+                Hilog.info(1, "CjTauri", "host pageUrl label=${label} url=\"${h.currentUrl()}\"")
+                Hilog.info(1, "CjTauri", "host initScripts label=${label} count=${h.initScriptsSnapshot().size}")
+            case None => Hilog.info(1, "CjTauri", "host missing at loadContent label=${label}")
+        }
+    }
+}