From 88d278122e3b1e83721adcd8719078d020a6db5a Mon Sep 17 00:00:00 2001 From: kdletters Date: Sat, 20 Jun 2026 09:45:09 +0800 Subject: [PATCH] =?UTF-8?q?=E8=AE=B0=E5=BD=95=E6=A1=8C=E9=9D=A2=E5=A3=B3?= =?UTF-8?q?=E6=B7=B1=E9=93=BE=E6=B3=A8=E5=86=8C=E5=A4=B1=E8=B4=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 桌面深链 scheme 注册结果改为显式日志记录 桌面壳配置检查拒绝静默吞掉深链注册失败 共享决策日志补充深链注册失败边界 --- apps/desktop-shell/scripts/check-config.mjs | 20 ++++++++++++++++ .../src-tauri/src/shell/deep_link.rs | 24 +++++++++++++++++-- .../shared-memory/decision-log.md | 7 ++++++ 3 files changed, 49 insertions(+), 2 deletions(-) diff --git a/apps/desktop-shell/scripts/check-config.mjs b/apps/desktop-shell/scripts/check-config.mjs index 738f6a105..3e88cd082 100644 --- a/apps/desktop-shell/scripts/check-config.mjs +++ b/apps/desktop-shell/scripts/check-config.mjs @@ -163,6 +163,14 @@ const desktopShellNetworkSource = fs.readFileSync( desktopShellNetworkPath, 'utf8', ); +const desktopShellDeepLinkPath = new URL( + '../src-tauri/src/shell/deep_link.rs', + import.meta.url, +); +const desktopShellDeepLinkSource = fs.readFileSync( + desktopShellDeepLinkPath, + 'utf8', +); const desktopShellNavigationPath = new URL( '../src-tauri/src/shell/navigation.rs', import.meta.url, @@ -2778,6 +2786,7 @@ for (const blockedLifecycleSnippet of [ 'let _ = emit_current_desktop_lifecycle_event(window)', 'let _ = emit_current_desktop_lifecycle_event(&lifecycle_window)', 'let _ = emit_desktop_image_drop_event(&drop_window', + 'let _ = app.deep_link().register_all()', 'let _ = window.navigate(target_url)', 'let _ = show_main_window(window.app_handle())', 'let _ = show_main_window(app)', @@ -2800,3 +2809,14 @@ for (const snippet of requiredRustHostSnippets) { throw new Error(`desktop shell Rust host bridge missing ${snippet}`); } } + +for (const snippet of [ + 'register_desktop_deep_link_schemes(app: &tauri::App) -> bool', + 'log_desktop_deep_link_register_result(app.deep_link().register_all())', + 'desktop host event failed for deep_link.register', + 'desktop_deep_link_register_result_reports_success_and_failure', +]) { + if (!desktopShellDeepLinkSource.includes(snippet)) { + throw new Error(`desktop shell deep-link registration logging missing ${snippet}`); + } +} diff --git a/apps/desktop-shell/src-tauri/src/shell/deep_link.rs b/apps/desktop-shell/src-tauri/src/shell/deep_link.rs index ec8114799..a09ce72ab 100644 --- a/apps/desktop-shell/src-tauri/src/shell/deep_link.rs +++ b/apps/desktop-shell/src-tauri/src/shell/deep_link.rs @@ -76,6 +76,18 @@ fn log_desktop_deep_link_open_result(result: tauri::Result<()>) -> bool { log_desktop_host_event_result("deep_link.open", result) } +fn log_desktop_deep_link_register_result( + result: Result<(), tauri_plugin_deep_link::Error>, +) -> bool { + match result { + Ok(()) => true, + Err(error) => { + eprintln!("desktop host event failed for deep_link.register: {error}"); + false + } + } +} + pub(crate) fn register_desktop_deep_link_events(app: &tauri::App) -> tauri::Result<()> { let app_handle = app.handle().clone(); app.deep_link().on_open_url(move |event| { @@ -100,8 +112,8 @@ pub(crate) fn register_desktop_deep_link_events(app: &tauri::App) -> tauri::Resu Ok(()) } -pub(crate) fn register_desktop_deep_link_schemes(app: &tauri::App) { - let _ = app.deep_link().register_all(); +pub(crate) fn register_desktop_deep_link_schemes(app: &tauri::App) -> bool { + log_desktop_deep_link_register_result(app.deep_link().register_all()) } #[cfg(test)] @@ -238,4 +250,12 @@ mod tests { tauri::Error::AssetNotFound("deep-link".to_string()) ))); } + + #[test] + fn desktop_deep_link_register_result_reports_success_and_failure() { + assert!(log_desktop_deep_link_register_result(Ok(()))); + assert!(!log_desktop_deep_link_register_result(Err( + tauri_plugin_deep_link::Error::UnsupportedPlatform + ))); + } } diff --git a/docs/project-memory/shared-memory/decision-log.md b/docs/project-memory/shared-memory/decision-log.md index 90143941f..863ae094f 100644 --- a/docs/project-memory/shared-memory/decision-log.md +++ b/docs/project-memory/shared-memory/decision-log.md @@ -2895,6 +2895,13 @@ - 影响范围：`apps/desktop-shell/src-tauri/src/app.rs`、`apps/desktop-shell/src-tauri/src/shell/navigation.rs`、`apps/desktop-shell/src-tauri/src/shell/tray.rs`、`apps/desktop-shell/scripts/check-config.mjs`、宿主壳方案文档。 - 验证方式：`cargo test --manifest-path apps/desktop-shell/src-tauri/Cargo.toml`、`npm run desktop-shell:typecheck`、`npm run check:native-shells`、`npm run check:encoding`、`git diff --check`。 +## 2026-06-20 桌面壳深链注册失败不可静默 + +- 背景：Tauri 桌面壳深链 scheme 注册决定已安装桌面包能否从系统链接唤醒；如果 `register_all()` 失败后静默继续，用户会看到深链无反应且没有可排查日志。 +- 决策：`register_desktop_deep_link_schemes(...)` 必须把 `app.deep_link().register_all()` 结果交给同日志格式的 `log_desktop_deep_link_register_result(...)`，并返回布尔结果供测试和门禁反查；桌面壳配置检查拒绝重新出现 `let _ = app.deep_link().register_all()`。 +- 影响范围：`apps/desktop-shell/src-tauri/src/shell/deep_link.rs`、`apps/desktop-shell/scripts/check-config.mjs`。 +- 验证方式：`cargo test --manifest-path apps/desktop-shell/src-tauri/Cargo.toml shell::deep_link`、`npm run desktop-shell:typecheck`、`npm run check:native-shells`、`npm run check:encoding`、`git diff --check`。 + ## 2026-06-20 移动壳 EAS 原生包构建 profile - 背景：移动壳已能通过 Expo managed config 和 Metro production bundle smoke，但缺少原生安装包构建 profile；如果只保留 `expo export`，无法证明 Android / iOS 壳有进入原生分发链路的配置。