cj-tauri 2.0.0 → 2.1.1

package/src/tests/logging_test.cj

@@ -1,62 +1,62 @@
-package cjTauri.tests
-
-import cjTauri.*
-import std.unittest.*
-import std.unittest.testmacro.*
-
-/*
- * 日志落盘的策略层用例（RFC-003 第 5 期）。
- *
- * 只测**纯函数**（默认目录推导、环境变量回退、路径拼接）：真的开 fd 那一段归桩自检
- * （`native/tests/test_bridge_core.c` 的 `log file` 用例）与实机 E2E——单测里调桥的
- * `foreign func` 会踩「子包调不了 foreign func」那条（AGENTS §4，链接期报未定义符号）。
- *
- * 环境变量类的用例一律用**肯定不存在**的变量名：跑测试的机器上 `CJ_TAURI_LOG` 之类
- * 可能真的设着，拿它当「未设置」来断言就是一条会随机器飘的红线。
- */
-
-/** 保证不存在的变量名（前缀统一，便于将来 grep） */
-let ABSENT_LOG_ENV: String = "CJ_TAURI_LOG_TEST_ABSENT"
-
-@Test
-func testLogEnvFallsBackWhenVariableMissing(): Unit {
-    @Expect(logEnvOr(ABSENT_LOG_ENV, "dflt"), "dflt")
-}
-
-@Test
-func testLogBudgetFallsBackWhenVariableMissing(): Unit {
-    @Expect(logBudgetFromEnv(ABSENT_LOG_ENV, 7), 7)
-    // 0 与负数在调用方语义里是「不轮转」，不是「用 0 当默认」——回退值原样带回
-    @Expect(logBudgetFromEnv(ABSENT_LOG_ENV, 0), 0)
-}
-
-@Test
-func testDefaultLogPathUsesAppNameAndPlatformDir(): Unit {
-    let p = defaultLogPath("music")
-    // 分隔符按平台给，所以不整体比对路径；钉的是「文件名 = 应用名」、「落在 cj-tauri 目录下」
-    @Expect(p.endsWith("music.log"), true)
-    @Expect(p.contains("cj-tauri"), true)
-    // 应用没给名字时走兜底：不能拼出没有主名的 ".log"
-    @Expect(defaultLogPath("").endsWith("app.log"), true)
-}
-
-@Test
-func testDefaultLogDirIsNonEmptyAndConventional(): Unit {
-    let d = defaultLogDir()
-    @Expect(d.size > 0, true)
-    @Expect(d.contains("cj-tauri"), true)
-    // 默认预算是个能落地的值：>0 才会轮转，keep>0 才有档案可留
-    @Expect(CJ_LOG_DEFAULT_MAX_KB > 0, true)
-    @Expect(CJ_LOG_DEFAULT_KEEP > 0, true)
-}
-
-@Test
-func testLogPathOrDefaultPrefersEnvOverPlatformDir(): Unit {
-    // 报障路径优先：环境变量给了路径就用它，平台惯例目录被忽略（人家不必知道目录在哪）
-    @Expect(logPathOrDefault("/tmp/from-env.log", "music"), "/tmp/from-env.log")
-    // 空串＝未设置，才落平台惯例目录，文件名跟应用名走（与 logEnvOr 同口径）
-    let d = logPathOrDefault("", "music")
-    @Expect(d.endsWith("music.log"), true)
-    @Expect(d.contains("cj-tauri"), true)
-    @Expect(d == defaultLogPath("music"), true)
-}
+package cjTauri.tests
+
+import cjTauri.*
+import std.unittest.*
+import std.unittest.testmacro.*
+
+/*
+ * 日志落盘的策略层用例（RFC-003 第 5 期）。
+ *
+ * 只测**纯函数**（默认目录推导、环境变量回退、路径拼接）：真的开 fd 那一段归桩自检
+ * （`native/tests/test_bridge_core.c` 的 `log file` 用例）与实机 E2E——单测里调桥的
+ * `foreign func` 会踩「子包调不了 foreign func」那条（AGENTS §4，链接期报未定义符号）。
+ *
+ * 环境变量类的用例一律用**肯定不存在**的变量名：跑测试的机器上 `CJ_TAURI_LOG` 之类
+ * 可能真的设着，拿它当「未设置」来断言就是一条会随机器飘的红线。
+ */
+
+/** 保证不存在的变量名（前缀统一，便于将来 grep） */
+let ABSENT_LOG_ENV: String = "CJ_TAURI_LOG_TEST_ABSENT"
+
+@Test
+func testLogEnvFallsBackWhenVariableMissing(): Unit {
+    @Expect(logEnvOr(ABSENT_LOG_ENV, "dflt"), "dflt")
+}
+
+@Test
+func testLogBudgetFallsBackWhenVariableMissing(): Unit {
+    @Expect(logBudgetFromEnv(ABSENT_LOG_ENV, 7), 7)
+    // 0 与负数在调用方语义里是「不轮转」，不是「用 0 当默认」——回退值原样带回
+    @Expect(logBudgetFromEnv(ABSENT_LOG_ENV, 0), 0)
+}
+
+@Test
+func testDefaultLogPathUsesAppNameAndPlatformDir(): Unit {
+    let p = defaultLogPath("music")
+    // 分隔符按平台给，所以不整体比对路径；钉的是「文件名 = 应用名」、「落在 cj-tauri 目录下」
+    @Expect(p.endsWith("music.log"), true)
+    @Expect(p.contains("cj-tauri"), true)
+    // 应用没给名字时走兜底：不能拼出没有主名的 ".log"
+    @Expect(defaultLogPath("").endsWith("app.log"), true)
+}
+
+@Test
+func testDefaultLogDirIsNonEmptyAndConventional(): Unit {
+    let d = defaultLogDir()
+    @Expect(d.size > 0, true)
+    @Expect(d.contains("cj-tauri"), true)
+    // 默认预算是个能落地的值：>0 才会轮转，keep>0 才有档案可留
+    @Expect(CJ_LOG_DEFAULT_MAX_KB > 0, true)
+    @Expect(CJ_LOG_DEFAULT_KEEP > 0, true)
+}
+
+@Test
+func testLogPathOrDefaultPrefersEnvOverPlatformDir(): Unit {
+    // 报障路径优先：环境变量给了路径就用它，平台惯例目录被忽略（人家不必知道目录在哪）
+    @Expect(logPathOrDefault("/tmp/from-env.log", "music"), "/tmp/from-env.log")
+    // 空串＝未设置，才落平台惯例目录，文件名跟应用名走（与 logEnvOr 同口径）
+    let d = logPathOrDefault("", "music")
+    @Expect(d.endsWith("music.log"), true)
+    @Expect(d.contains("cj-tauri"), true)
+    @Expect(d == defaultLogPath("music"), true)
+}

package/src/tests/platform_contract_test.cj

@@ -1,251 +1,264 @@
-package cjTauri.tests
-
-import cjTauri.*
-import cjTauri.platform.*
-import std.collection.*
-import std.unittest.*
-import std.unittest.testmacro.*
-
-/*
- * 平台契约骨架测试（RFC-002 批次 0）
- * 不创建窗口、不依赖宿主：TargetInfo / 特性探测 / PageSource / 宿主注册表，纯逻辑。
- */
-
-@Test
-func targetInfoDescribe(): Unit {
-    let t = TargetInfo("Linux", "x86_64", "webkitgtk", "desktop")
-    @Expect(t.os, "Linux")
-    @Expect(t.describe(), "Linux/x86_64 host=webkitgtk display=desktop")
-}
-
-@Test
-func appContextFeatureProbe(): Unit {
-    let fs = ArrayList<PlatformFeature>()
-    fs.add(PlatformFeature.Tray)
-    fs.add(PlatformFeature.MultiWindow)
-    let ctx = AppContext(
-        AppPaths("/tmp/d", "/tmp/c", "/tmp/t"),
-        TargetInfo("Linux", "x86_64", "webkitgtk", "desktop"),
-        false, fs)
-    @Expect(ctx.supports(PlatformFeature.Tray), true)
-    @Expect(ctx.supports(PlatformFeature.FilePicker), false)
-    @Expect(ctx.dev, false)
-}
-
-@Test
-func pageSourceMatch(): Unit {
-    let src = PageSource.Asset("ui/index.html")
-    match (src) {
-        case Asset(name) => @Expect(name, "ui/index.html")
-        case _ => @Expect(false, true)   // 不应到达：Asset 之外的分支
-    }
-}
-
-@Test
-func desktopDiscoverDefaults(): Unit {
-    let ctx = Platform.desktop("com.example.test", "x86_64")
-    @Expect(ctx.paths.dataDir.endsWith("com.example.test"), true)
-    @Expect(ctx.supports(PlatformFeature.Tray), true)
-    @Expect(ctx.target.display, "desktop")
-}
-
-@Test
-func mobileDiscoverSandbox(): Unit {
-    let ctx = Platform.mobile("/data/app/el2/base/files", "aarch64")
-    @Expect(ctx.paths.dataDir, "/data/app/el2/base/files")
-    @Expect(ctx.dev, false)
-    @Expect(ctx.supports(PlatformFeature.SoftKeyboardInset), true)
-    @Expect(ctx.supports(PlatformFeature.Tray), false)
-}
-
-/** 优先级最高者胜；create 返回假宿主（pickHost 会真实调用它） */
-class HighPrioProvider <: HostProvider {
-    public func priority(target: TargetInfo): Int64 {
-        return 10
-    }
-    public func create(label: String, target: TargetInfo): WebViewHost {
-        return FakeHost(label)
-    }
-}
-
-class LowPrioProvider <: HostProvider {
-    public func priority(target: TargetInfo): Int64 {
-        return 1
-    }
-    public func create(label: String, target: TargetInfo): WebViewHost {
-        return FakeHost(label)
-    }
-}
-
-class NullProvider <: HostProvider {
-    public func priority(target: TargetInfo): Int64 {
-        return 0
-    }
-    public func create(label: String, target: TargetInfo): WebViewHost {
-        return FakeHost(label)
-    }
-}
-
-@Test
-func hostRegistryPicksHighestPriority(): Unit {
-    let before = hostProviderCount()
-    registerHost(NullProvider())
-    registerHost(LowPrioProvider())
-    registerHost(HighPrioProvider())
-    @Expect(hostProviderCount(), before + 3)
-    let target = TargetInfo("Linux", "x86_64", "webkitgtk", "desktop")
-    let picked = pickHost("main", target)
-    @Expect(picked.isSome(), true)
-    // 胜出者必须是优先级 10 的实现（create 真实执行，label 透传）
-    @Expect(picked.getOrThrow().label(), "main")
-}
-
-// ---- 批次 1：PageSource → PageLoad 决策 ----
-
-@Test
-func resolvePageInlineAndUrl(): Unit {
-    match (resolvePage(PageSource.Inline("<p>hi</p>"), None)) {
-        case StartHtml(html) => @Expect(html, "<p>hi</p>")
-        case _ => @Expect(false, true)
-    }
-    match (resolvePage(PageSource.Url("https://example.com"), None)) {
-        case StartUrl(url) => @Expect(url, "https://example.com")
-        case _ => @Expect(false, true)
-    }
-    // DevServer 与 Url 同路：都走 startUrl
-    match (resolvePage(PageSource.DevServer("http://127.0.0.1:5173"), None)) {
-        case StartUrl(url) => @Expect(url, "http://127.0.0.1:5173")
-        case _ => @Expect(false, true)
-    }
-}
-
-/** 返回固定内容的解析器 */
-class StubResolver <: AssetResolver {
-    let table: HashMap<String, String>
-    init(table: HashMap<String, String>) {
-        this.table = table
-    }
-    public func readText(name: String): Option<String> {
-        return table.get(name)
-    }
-    public func exists(name: String): Bool {
-        return table.contains(name)
-    }
-}
-
-@Test
-func resolvePageAssetViaResolver(): Unit {
-    let t = HashMap<String, String>()
-    t.add("ui/index.html", "<html>ok</html>")
-    let src = resolvePage(PageSource.Asset("ui/index.html"), Some(StubResolver(t)))
-    match (src) {
-        case StartHtml(html) => @Expect(html, "<html>ok</html>")
-        case _ => @Expect(false, true)
-    }
-}
-
-@Test
-func resolvePageAssetMissingThrowsReadableError(): Unit {
-    let t = HashMap<String, String>()
-    var msg = ""
-    try {
-        let _ = resolvePage(PageSource.Asset("no/such.html"), Some(StubResolver(t)))
-    } catch (e: Exception) {
-        msg = e.message
-    }
-    @Expect(msg.contains("no/such.html"), true)
-}
-
-@Test
-func resolvePageAssetNoResolverReadsFromCwd(): Unit {
-    // 未注入解析器：按 cwd 相对路径读盘（与模板 textOrFile 桌面行为等价）。
-    // 测试 cwd = 仓库根，读一个确定存在的文件验证「读到了」而非白屏。
-    let src = resolvePage(PageSource.Asset("cjpm.toml"), None)
-    match (src) {
-        case StartHtml(html) => @Expect(html.size > 0, true)
-        case _ => @Expect(false, true)
-    }
-}
-
-// ---- 批次 1 评审修正：devMode 自动改写（RFC §4.3）----
-
-@Test
-func rewriteForDevOnlyTouchesAsset(): Unit {
-    // Asset + devUrl → DevServer
-    match (rewriteForDev(PageSource.Asset("ui/index.html"), Some("http://127.0.0.1:5173"))) {
-        case DevServer(url) => @Expect(url, "http://127.0.0.1:5173")
-        case _ => @Expect(false, true)
-    }
-    // 显式 Inline 是业务意图，不改写
-    match (rewriteForDev(PageSource.Inline("<p/>"), Some("http://d"))) {
-        case Inline(html) => @Expect(html, "<p/>")
-        case _ => @Expect(false, true)
-    }
-    // 无 devUrl 原样返回
-    match (rewriteForDev(PageSource.Asset("ui/index.html"), None)) {
-        case Asset(name) => @Expect(name, "ui/index.html")
-        case _ => @Expect(false, true)
-    }
-}
-
-// ---- 批次 2：DirectoryAssetResolver ----
-
-@Test
-func directoryAssetResolverReadsRepo(): Unit {
-    let r = DirectoryAssetResolver(".")
-    let t = r.readText("cjpm.toml")
-    @Expect(t.isSome(), true)
-    @Expect(t.getOrThrow().size > 0, true)
-    @Expect(r.exists("cjpm.toml"), true)
-    @Expect(r.readText("no/such/file.txt").isSome(), false)
-    @Expect(r.exists("no/such/file.txt"), false)
-}
-
-// ---- 批次 1：guessTarget 与 resolveHost 接线 ----
-
-@Test
-func guessTargetDesktopFields(): Unit {
-    let t = Platform.guessTarget()
-    @Expect(t.display, "desktop")
-    @Expect(t.hostKind, expectedDesktopHostKind())
-    @Expect(t.os, expectedDesktopOs())
-}
-
-// 桌面两平台的宿主形态与系统名本来就不同（Windows = webview2 / Windows，Linux = webkitgtk / Linux）。
-// 期望值写死一套会让用例在另一个平台上恒红——本机 Windows 上这条一直是红的（写死成 Linux 那套）。
-@When[os == "Windows"]
-func expectedDesktopHostKind(): String {
-    return "webview2"
-}
-
-@When[os != "Windows"]
-func expectedDesktopHostKind(): String {
-    return "webkitgtk"
-}
-
-@When[os == "Windows"]
-func expectedDesktopOs(): String {
-    return "Windows"
-}
-
-@When[os != "Windows"]
-func expectedDesktopOs(): String {
-    return "Linux"
-}
-
-/** 注册表有匹配时，resolveHost 必须取注册表而不是内置宿主 */
-class WinProvider <: HostProvider {
-    public func priority(target: TargetInfo): Int64 {
-        return 5
-    }
-    public func create(label: String, target: TargetInfo): WebViewHost {
-        return FakeHost(label)
-    }
-}
-
-@Test
-func resolveHostPrefersRegistryOverBuiltin(): Unit {
-    registerHost(WinProvider())
-    let h = resolveHost("registry-win")
-    @Expect(h.label(), "registry-win")
-}
+package cjTauri.tests
+
+import cjTauri.*
+import cjTauri.platform.*
+import std.collection.*
+import std.unittest.*
+import std.unittest.testmacro.*
+
+/*
+ * 平台契约骨架测试（RFC-002 批次 0）
+ * 不创建窗口、不依赖宿主：TargetInfo / 特性探测 / PageSource / 宿主注册表，纯逻辑。
+ */
+
+@Test
+func targetInfoDescribe(): Unit {
+    let t = TargetInfo("Linux", "x86_64", "webkitgtk", "desktop")
+    @Expect(t.os, "Linux")
+    @Expect(t.describe(), "Linux/x86_64 host=webkitgtk display=desktop")
+}
+
+@Test
+func appContextFeatureProbe(): Unit {
+    let fs = ArrayList<PlatformFeature>()
+    fs.add(PlatformFeature.Tray)
+    fs.add(PlatformFeature.MultiWindow)
+    let ctx = AppContext(
+        AppPaths("/tmp/d", "/tmp/c", "/tmp/t"),
+        TargetInfo("Linux", "x86_64", "webkitgtk", "desktop"),
+        false, fs)
+    @Expect(ctx.supports(PlatformFeature.Tray), true)
+    @Expect(ctx.supports(PlatformFeature.FilePicker), false)
+    @Expect(ctx.dev, false)
+}
+
+/** 经函数返回：调用点看到的是 PageSource 全类型，match 的穷尽性检查才不会与流分析打架 */
+func assetPageSource(name: String): PageSource {
+    return PageSource.Asset(name)
+}
+
+@Test
+func pageSourceMatch(): Unit {
+    let src = assetPageSource("ui/index.html")
+    match (src) {
+        case Asset(name) => @Expect(name, "ui/index.html")
+        case _ => @Expect(false, true)   // 不应到达：工厂只造 Asset
+    }
+}
+
+@Test
+func desktopDiscoverDefaults(): Unit {
+    let ctx = Platform.desktop("com.example.test", "x86_64")
+    @Expect(ctx.paths.dataDir.endsWith("com.example.test"), true)
+    @Expect(ctx.supports(PlatformFeature.Tray), true)
+    @Expect(ctx.target.display, "desktop")
+}
+
+@Test
+func mobileDiscoverSandbox(): Unit {
+    let ctx = Platform.mobile("/data/app/el2/base/files", "aarch64")
+    @Expect(ctx.paths.dataDir, "/data/app/el2/base/files")
+    @Expect(ctx.dev, false)
+    @Expect(ctx.supports(PlatformFeature.SoftKeyboardInset), true)
+    @Expect(ctx.supports(PlatformFeature.Tray), false)
+}
+
+/** 优先级最高者胜；create 返回假宿主（pickHost 会真实调用它） */
+class HighPrioProvider <: HostProvider {
+    public func priority(target: TargetInfo): Int64 {
+        let _ = target
+        return 10
+    }
+    public func create(label: String, target: TargetInfo): WebViewHost {
+        let _ = target
+        return FakeHost(label)
+    }
+}
+
+class LowPrioProvider <: HostProvider {
+    public func priority(target: TargetInfo): Int64 {
+        let _ = target
+        return 1
+    }
+    public func create(label: String, target: TargetInfo): WebViewHost {
+        let _ = target
+        return FakeHost(label)
+    }
+}
+
+class NullProvider <: HostProvider {
+    public func priority(target: TargetInfo): Int64 {
+        let _ = target
+        return 0
+    }
+    public func create(label: String, target: TargetInfo): WebViewHost {
+        let _ = target
+        return FakeHost(label)
+    }
+}
+
+@Test
+func hostRegistryPicksHighestPriority(): Unit {
+    let before = hostProviderCount()
+    registerHost(NullProvider())
+    registerHost(LowPrioProvider())
+    registerHost(HighPrioProvider())
+    @Expect(hostProviderCount(), before + 3)
+    let target = TargetInfo("Linux", "x86_64", "webkitgtk", "desktop")
+    let picked = pickHost("main", target)
+    @Expect(picked.isSome(), true)
+    // 胜出者必须是优先级 10 的实现（create 真实执行，label 透传）
+    @Expect(picked.getOrThrow().label(), "main")
+}
+
+// ---- 批次 1：PageSource → PageLoad 决策 ----
+
+@Test
+func resolvePageInlineAndUrl(): Unit {
+    match (resolvePage(PageSource.Inline("<p>hi</p>"), None)) {
+        case StartHtml(html) => @Expect(html, "<p>hi</p>")
+        case _ => @Expect(false, true)
+    }
+    match (resolvePage(PageSource.Url("https://example.com"), None)) {
+        case StartUrl(url) => @Expect(url, "https://example.com")
+        case _ => @Expect(false, true)
+    }
+    // DevServer 与 Url 同路：都走 startUrl
+    match (resolvePage(PageSource.DevServer("http://127.0.0.1:5173"), None)) {
+        case StartUrl(url) => @Expect(url, "http://127.0.0.1:5173")
+        case _ => @Expect(false, true)
+    }
+}
+
+/** 返回固定内容的解析器 */
+class StubResolver <: AssetResolver {
+    let table: HashMap<String, String>
+    init(table: HashMap<String, String>) {
+        this.table = table
+    }
+    public func readText(name: String): Option<String> {
+        return table.get(name)
+    }
+    public func exists(name: String): Bool {
+        return table.contains(name)
+    }
+}
+
+@Test
+func resolvePageAssetViaResolver(): Unit {
+    let t = HashMap<String, String>()
+    t.add("ui/index.html", "<html>ok</html>")
+    let src = resolvePage(PageSource.Asset("ui/index.html"), Some(StubResolver(t)))
+    match (src) {
+        case StartHtml(html) => @Expect(html, "<html>ok</html>")
+        case _ => @Expect(false, true)
+    }
+}
+
+@Test
+func resolvePageAssetMissingThrowsReadableError(): Unit {
+    let t = HashMap<String, String>()
+    var msg = ""
+    try {
+        let _ = resolvePage(PageSource.Asset("no/such.html"), Some(StubResolver(t)))
+    } catch (e: Exception) {
+        msg = e.message
+    }
+    @Expect(msg.contains("no/such.html"), true)
+}
+
+@Test
+func resolvePageAssetNoResolverReadsFromCwd(): Unit {
+    // 未注入解析器：按 cwd 相对路径读盘（与模板 textOrFile 桌面行为等价）。
+    // 测试 cwd = 仓库根，读一个确定存在的文件验证「读到了」而非白屏。
+    let src = resolvePage(PageSource.Asset("cjpm.toml"), None)
+    match (src) {
+        case StartHtml(html) => @Expect(html.size > 0, true)
+        case _ => @Expect(false, true)
+    }
+}
+
+// ---- 批次 1 评审修正：devMode 自动改写（RFC §4.3）----
+
+@Test
+func rewriteForDevOnlyTouchesAsset(): Unit {
+    // Asset + devUrl → DevServer
+    match (rewriteForDev(PageSource.Asset("ui/index.html"), Some("http://127.0.0.1:5173"))) {
+        case DevServer(url) => @Expect(url, "http://127.0.0.1:5173")
+        case _ => @Expect(false, true)
+    }
+    // 显式 Inline 是业务意图，不改写
+    match (rewriteForDev(PageSource.Inline("<p/>"), Some("http://d"))) {
+        case Inline(html) => @Expect(html, "<p/>")
+        case _ => @Expect(false, true)
+    }
+    // 无 devUrl 原样返回
+    match (rewriteForDev(PageSource.Asset("ui/index.html"), None)) {
+        case Asset(name) => @Expect(name, "ui/index.html")
+        case _ => @Expect(false, true)
+    }
+}
+
+// ---- 批次 2：DirectoryAssetResolver ----
+
+@Test
+func directoryAssetResolverReadsRepo(): Unit {
+    let r = DirectoryAssetResolver(".")
+    let t = r.readText("cjpm.toml")
+    @Expect(t.isSome(), true)
+    @Expect(t.getOrThrow().size > 0, true)
+    @Expect(r.exists("cjpm.toml"), true)
+    @Expect(r.readText("no/such/file.txt").isSome(), false)
+    @Expect(r.exists("no/such/file.txt"), false)
+}
+
+// ---- 批次 1：guessTarget 与 resolveHost 接线 ----
+
+@Test
+func guessTargetDesktopFields(): Unit {
+    let t = Platform.guessTarget()
+    @Expect(t.display, "desktop")
+    @Expect(t.hostKind, expectedDesktopHostKind())
+    @Expect(t.os, expectedDesktopOs())
+}
+
+// 桌面两平台的宿主形态与系统名本来就不同（Windows = webview2 / Windows，Linux = webkitgtk / Linux）。
+// 期望值写死一套会让用例在另一个平台上恒红——本机 Windows 上这条一直是红的（写死成 Linux 那套）。
+@When[os == "Windows"]
+func expectedDesktopHostKind(): String {
+    return "webview2"
+}
+
+@When[os != "Windows"]
+func expectedDesktopHostKind(): String {
+    return "webkitgtk"
+}
+
+@When[os == "Windows"]
+func expectedDesktopOs(): String {
+    return "Windows"
+}
+
+@When[os != "Windows"]
+func expectedDesktopOs(): String {
+    return "Linux"
+}
+
+/** 注册表有匹配时，resolveHost 必须取注册表而不是内置宿主 */
+class WinProvider <: HostProvider {
+    public func priority(target: TargetInfo): Int64 {
+        let _ = target
+        return 5
+    }
+    public func create(label: String, target: TargetInfo): WebViewHost {
+        let _ = target
+        return FakeHost(label)
+    }
+}
+
+@Test
+func resolveHostPrefersRegistryOverBuiltin(): Unit {
+    registerHost(WinProvider())
+    let h = resolveHost("registry-win")
+    @Expect(h.label(), "registry-win")
+}