桌面应用跨平台【免费下载链接】nativeToolkit for building native desktop apps项目地址https://gitcode.com/gh_mirrors/ze/native点击查看免费下载本指南以仓库中 examples/capabilities 示例为蓝本系统讲解 Native SDK 如何在“受信任 WebView 显式权限 命令策略”模型下调用操作系统能力覆盖平台能力探测、系统服务打开 URL、显示路径、最近文档、通知、剪贴板、消息对话框、凭据存取、文件拖放与 App 生命周期事件。读完本文你将掌握 capabilities 示例的完整代码结构、manifest 打包元数据写法以及如何用无头测试与真实宿主验证这些能力。示例定位一套“受保护系统能力”的验收样板Capabilities 示例是 Native SDK 仓库中专门演示受守卫的 OS 能力guarded OS capabilities的最小可运行应用所有系统调用都不在 Zig 侧直接硬编码而是由 WebView 中的可信前端代码通过window.zero.invoke()桥接到原生侧再由运行时按权限与命令策略放行。从 examples/capabilities/src/main.zig 可以看到该示例的核心目标是证明一条完整链路权限声明应用声明需要的全部权限窗口、网络、文件系统、通知、对话框、剪贴板、凭据命令策略为每个桥接命令绑定所需权限与允许来源originWebView 调用前端页面逐个按钮触发对应桥接命令原生执行与回传结果以 JSON 返回前端pre输出区显示事件通道文件拖放、App 激活/失活等事件同时分发给 Zig 与 WebView 事件桥。示例覆盖的能力清单对应 examples/capabilities/README.md平台支持探测native-sdk.platform.supports打开 URL、在 Finder 中显示路径、添加/清空最近文档发送系统通知剪贴板文本读写含富数据能力探测消息对话框凭据Keychain 风格的 set / get / delete文件拖放事件同时送达 Zig 事件循环与 WebView 事件桥并提供真实 canvasdrop_files目标文件关联与自定义 URL scheme 打包元数据App 激活activate与失活deactivate事件。快速运行系统后端与无头测试两条路径示例 README 提供了两种运行方式。系统后端运行macOSzig build run -Dplatformmacos -Dweb-enginesystem其中-Dplatformmacos指定宿主平台-Dweb-enginesystem使用系统 WebView 内核对应 examples/capabilities/app.zon 中的web_engine system配置而不是内置的 CEF。示例还声明platforms .{ macos, linux }因此在 Linux 上可用-Dplatformlinux配合相应后端运行。无头测试路径无需真实窗口与系统服务zig build test -Dplatformnull-Dplatformnull使用仓库的 null platform 测试桩harness.null_platform可以脱离 AppKit 模拟全部桥接调用与平台事件详见下文“无头测试验证”一节。一次性跑完所有 native-first 示例测试zig build test-examples-native该命令从仓库根目录执行汇总所有示例包括 capabilities的原生测试。信任边界权限声明与命令策略的双重守卫示例的守卫模型由两层构成均可在 src/security/root.zig 中找到定义。第一层应用级权限permissions示例在 examples/capabilities/src/main.zig 声明了应用级权限数组const app_permissions [_][]const u8{ native_sdk.security.permission_window, native_sdk.security.permission_network, native_sdk.security.permission_filesystem, native_sdk.security.permission_notifications, native_sdk.security.permission_dialog, native_sdk.security.permission_clipboard, native_sdk.security.permission_credentials, };这 7 个权限字符串与 src/security/root.zig 中定义的常量一一对应window、command、view、dialog、filesystem、clipboard、network、notifications、credentials。同一组权限在 examples/capabilities/app.zon 的permissions字段中重复声明供打包期校验。第二层桥接命令策略BridgeCommandPolicy仅声明权限还不够每个命令必须显式列出所需权限与允许来源。示例在 examples/capabilities/src/main.zig 定义builtin_policiesconst builtin_policies [_]native_sdk.BridgeCommandPolicy{ .{ .name native-sdk.platform.supports, .permissions platform_permission, .origins bridge_origins }, .{ .name native-sdk.os.openUrl, .permissions network_permission, .origins bridge_origins }, .{ .name native-sdk.os.showNotification, .permissions notification_permission, .origins bridge_origins }, // ... revealPath / recentDocuments / dialog / clipboard / credentials 等 };其中bridge_origins [_][]const u8{ zero://inline, zero://app }表明只有来自这两个受信任来源的调用才会被接受。CommandPolicy的实际判定逻辑在 src/bridge/root.zigPolicy.allows()会先检查enabled再按命令名查表find()随后要求应用级权限列表完整包含该命令策略声明的所有权限security.hasPermissions最后校验调用 origin 是否命中origins白名单支持*通配。任何一环不满足调用即被拒绝。这正是 README 中“受守卫的 OS 能力”的落地机制桥接层不是“谁能调用”而是“哪个来源、带哪些权限才能调用”的命令级最小授权。导航策略与外部链接examples/capabilities/src/main.zig 的security.navigation还配置了两项allowed_origins bridge_origins允许导航的来源白名单external_links.action .open_system_browser、allowed_urls .{https://example.com/docs/*}仅当 URL 匹配该模式时才交给系统浏览器打开。对应的通配符校验逻辑见 src/security/root.zig*只能作为路径段后缀出现如https://example.com/docs/*且会拒绝https://example.com*这类可被中间人利用的宽泛模式测试用例!allowsExternalUrl(... https://example.com.evil/docs)直接覆盖了该场景。逐项拆解 WebView 侧的能力调用示例页面内联 HTML 中每个按钮绑定一个window.zero.invoke()调用见 examples/capabilities/src/main.zig。下表汇总各能力对应的命令、参数与作用能力命令关键参数效果发送通知native-sdk.os.showNotificationtitle/subtitle/body弹出系统通知平台探测native-sdk.platform.supportsfeature返回当前平台是否支持某能力打开 URLnative-sdk.os.openUrlurl按导航策略用系统浏览器打开显示路径native-sdk.os.revealPathpath在 Finder/文件管理器中定位文件最近文档native-sdk.os.addRecentDocument/clearRecentDocumentspath/ 空添加或清空系统最近文档列表剪贴板native-sdk.clipboard.writeText/readTexttext/ 空剪贴板文本写读往返对话框native-sdk.dialog.showMessagestyle/title/message/primaryButton原生消息对话框凭据native-sdk.credentials.set/get/deleteservice/account/secret系统凭据存储读写删这些命令的 TypeScript 类型签名可在 packages/native-sdk/native-sdk.d.ts 中对照NativeSdkApi.os、clipboard、credentials、dialogs、platform.supports等方法族以及NativeSdkNotificationOptions、NativeSdkCredentialKey、NativeSdkMessageDialogOptions等载荷结构。平台支持探测为能力分发做运行时判断前端“Check Support”按钮会依次查询 10 个特性examples/capabilities/src/main.zig[open_url,reveal_path,recent_documents,notifications,dialogs, clipboard_text,clipboard_rich_data,credentials,file_drops,app_activation_events]native-sdk.platform.supports返回布尔值应用据此决定 UI 是否可用某项能力避免在能力缺失的平台上硬调用报错。完整特性枚举含gpu_surfaces、context_menus、audio_playback等定义在 packages/native-sdk/native-sdk.d.ts 的NativeSdkPlatformFeature。凭据往返set → get → delete 一条龙示例的 Credential Round Trip 按钮演示了完整生命周期examples/capabilities/src/main.zigconst key { service: dev.native-sdk.capabilities, account: demo }; await inv(native-sdk.credentials.set, { ...key, secret: demo-token }); show({ token: await inv(native-sdk.credentials.get, key), deleted: await inv(native-sdk.credentials.delete, key), });先写入demo-token再读取回显最后删除。对应测试逐条断言了credentialSetCount、get返回demo-token、delete返回true见 examples/capabilities/src/main.zig。凭据键由service account唯一确定此结构同样反映在NativeSdkCredentialKey类型中。剪贴板与对话框剪贴板按钮先写入Copied from Native SDK再读取并回显无头测试则以plain text为载荷验证了writeText与readText的往返examples/capabilities/src/main.zig。对话框按钮以style:info、主按钮OK调用native-sdk.dialog.showMessage返回用户按下的按钮标识。文件拖放Zig 事件循环、WebView 事件桥与 canvas 目标三方联动文件拖放是本示例最复杂的部分README 明确说明了它的三种观察视角Zig 侧CapabilitiesApp.event处理files_dropped事件examples/capabilities/src/main.zig更新状态栏文本WebView 事件桥前端监听native-sdk:drop:files自定义事件并展示e.detail含windowId与paths对应NativeSdkFileDropDetail类型canvasdrop_files目标右侧 GPU 画布上安装一个带drop_files语义动作的按钮控件拖放到其上会命中canvas_widget_file_drop事件标记出具体 widget 目标 ID。拖放目标的安装与重建右侧 250pt 宽的drop-canvas是gpu_surface视图examples/capabilities/src/main.zig。首次收到gpu_surface_frame事件时installDropTarget会布局一棵包含目标 widget 的树并通过runtime.setCanvasWidgetLayout与emitCanvasWidgetDisplayList安装examples/capabilities/src/main.zigconst target canvas.Widget{ .id drop_target_id, // 2 .kind .button, .frame ..., .text Drop files here, .semantics .{ .label Drop files here, .actions .{ .drop_files true } }, };gpu_surface_resized事件会触发重新安装保证拖放命中测试几何始终与最新尺寸一致——测试中特意用x300超出初始 250pt 表面证明 resize 后重建了 retained widget 命中几何见 examples/capabilities/src/main.zig 的注释与断言。拖放事件分发逻辑event处理器维护pending_drop_target_id当canvas_widget_file_drop携带目标时记录该 ID随后到达的files_dropped若命中目标状态栏报告Widget target 2 fired若拖到 WebView无目标则只报告普通应用级Received file drop N。README 要求的手动验收步骤正是围绕这一区分设计的用系统后端运行应用将 Finder 文件拖到右侧Drop files here画布状态栏必须显示Widget target 2 fired与拖入路径拖到左侧 WebView 上则只应出现普通应用级拖放信息。打包元数据文件关联与自定义 URL scheme示例在 examples/capabilities/app.zon 中声明了两类打包期元数据用于安装后与系统深度集成file_associations: [ { name: Native SDK Capability Document, role: viewer, extensions: [zncap], mime_types: [application/vnd.native-sdk.capabilityjson] } ], url_schemes: [ { scheme: native-sdk-capabilities } ].zncap扩展名 application/vnd.native-sdk.capabilityjsonMIME 类型让系统把该扩展名关联到本应用角色viewernative-sdk-capabilities://scheme让native-sdk-capabilities:前缀的链接由本应用接管。Zig 侧通过hasField防御性读取这些字段examples/capabilities/src/main.zig并在“capabilities manifest declares package integration metadata”测试中逐一断言扩展名为zncap、scheme 为native-sdk-capabilitiesexamples/capabilities/src/main.zig。App 激活 / 失活事件event处理器通过lifecycle分支接收.activate与.deactivateexamples/capabilities/src/main.zig分别累加activation_count/deactivation_count并把状态栏文本改为 “App activated.” / “App deactivated.”。同时前端通过window.zero.on(app:activate, ...)与window.zero.on(app:deactivate, ...)订阅同名事件examples/capabilities/src/main.zig构成“Zig 事件循环 WebView 事件桥”双通道通知——这也是NativeSdkApi.on事件 API 的典型用法。无头测试验证不依赖 AppKit 的完整链路断言示例内置一个名为 “capabilities bridge gates native services and dispatches file drops” 的 Zig 测试examples/capabilities/src/main.zig以native_sdk.TestHarness在 null platform 上运行覆盖视图布局断言主 WebView650pt、右侧 drop-canvas250pt、底部 statusbar34pt的初始 frame 精确匹配含min_width与 restore 策略联动桥接命令逐条验证通知notificationCount与标题、平台探测notifications/recentDocuments返回result:true、打开 URLlastExternalUrl、显示路径lastRevealedPath、最近文档lastRecentDocumentPath与清空计数、剪贴板往返lastClipboardData、凭据 set/get/delete拖放命中模拟files_dropped到画布断言widget_drop_count、目标 ID2、last_drop_paths完整保真包括带换行符的/tmp/one\nname.txt与 WebView断言保持普通应用级拖放并验证状态栏前缀Widget target 2 fired生命周期事件派发.app_activated/.app_deactivated后断言计数与lastWindowEventName为app:activate/app:deactivate。测试中的dispatchBridge辅助函数以zero://inline来源、mainWebView 标签派发原始 JSON 桥接消息examples/capabilities/src/main.zig完整模拟了真实前端window.zero.invoke()的到达路径。延伸阅读示例声明与配置examples/capabilities/app.zon平台、权限、capabilities、shell 布局、安全导航、web_engine示例全部实现与测试examples/capabilities/src/main.zig权限常量与导航/外部链接判定src/security/root.zig桥接命令策略解析与allows判定src/bridge/root.zigWebView 侧 API 完整类型声明packages/native-sdk/native-sdk.d.tsNativeSdkApi、NativeSdkPlatformFeature、各 Options 载荷。本示例是理解 Native SDK“最小权限、命令级白名单、双通道事件”安全模型的最佳起点照此模式你可以为自己的桌面应用扩展新的受保护系统能力并在任何支持-Dplatformnull的环境中先行完成全链路自动化验证。赞分享桌面应用跨平台【免费下载链接】nativeToolkit for building native desktop apps项目地址https://gitcode.com/gh_mirrors/ze/native点击查看免费下载相关推荐用 Zig 与 Native SDK 组合原生面板与 WebView 内容native-panels 示例深度解析用 Zig 与 Native SDK 组合原生面板与 WebView 内容native panels 示例深度解析 本文以 Native SDK 仓库中的 n桌面应用跨平台Capn Proto能力式RPC实战用三方握手构建不受信任方之间的安全远程调用Capn Proto能力式RPC实战用三方握手构建不受信任方之间的安全远程调用 Capn Proto 是 C 生态中基于能力式安全capabilit后端通信用 V 语言在 x.async 任务中集成 MCP 工具调度mcp 集成示例全解析用 V 语言在 x.async 任务中集成 MCP 工具调度mcp 集成示例全解析 vlib/x/async/examples/mcp/ 下的示例展示了如何在编程语言编译器语言运行时标准库上一篇离线音频转录与翻译工具的完整使用指南下一篇Azure API Management DevOps Resource Kit实战案例构建多环境API部署策略创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
Native SDK Capabilities 示例全解析：在受信任 WebView 中安全调用 macOS 系统能力
桌面应用跨平台【免费下载链接】nativeToolkit for building native desktop apps项目地址https://gitcode.com/gh_mirrors/ze/native点击查看免费下载本指南以仓库中 examples/capabilities 示例为蓝本系统讲解 Native SDK 如何在“受信任 WebView 显式权限 命令策略”模型下调用操作系统能力覆盖平台能力探测、系统服务打开 URL、显示路径、最近文档、通知、剪贴板、消息对话框、凭据存取、文件拖放与 App 生命周期事件。读完本文你将掌握 capabilities 示例的完整代码结构、manifest 打包元数据写法以及如何用无头测试与真实宿主验证这些能力。示例定位一套“受保护系统能力”的验收样板Capabilities 示例是 Native SDK 仓库中专门演示受守卫的 OS 能力guarded OS capabilities的最小可运行应用所有系统调用都不在 Zig 侧直接硬编码而是由 WebView 中的可信前端代码通过window.zero.invoke()桥接到原生侧再由运行时按权限与命令策略放行。从 examples/capabilities/src/main.zig 可以看到该示例的核心目标是证明一条完整链路权限声明应用声明需要的全部权限窗口、网络、文件系统、通知、对话框、剪贴板、凭据命令策略为每个桥接命令绑定所需权限与允许来源originWebView 调用前端页面逐个按钮触发对应桥接命令原生执行与回传结果以 JSON 返回前端pre输出区显示事件通道文件拖放、App 激活/失活等事件同时分发给 Zig 与 WebView 事件桥。示例覆盖的能力清单对应 examples/capabilities/README.md平台支持探测native-sdk.platform.supports打开 URL、在 Finder 中显示路径、添加/清空最近文档发送系统通知剪贴板文本读写含富数据能力探测消息对话框凭据Keychain 风格的 set / get / delete文件拖放事件同时送达 Zig 事件循环与 WebView 事件桥并提供真实 canvasdrop_files目标文件关联与自定义 URL scheme 打包元数据App 激活activate与失活deactivate事件。快速运行系统后端与无头测试两条路径示例 README 提供了两种运行方式。系统后端运行macOSzig build run -Dplatformmacos -Dweb-enginesystem其中-Dplatformmacos指定宿主平台-Dweb-enginesystem使用系统 WebView 内核对应 examples/capabilities/app.zon 中的web_engine system配置而不是内置的 CEF。示例还声明platforms .{ macos, linux }因此在 Linux 上可用-Dplatformlinux配合相应后端运行。无头测试路径无需真实窗口与系统服务zig build test -Dplatformnull-Dplatformnull使用仓库的 null platform 测试桩harness.null_platform可以脱离 AppKit 模拟全部桥接调用与平台事件详见下文“无头测试验证”一节。一次性跑完所有 native-first 示例测试zig build test-examples-native该命令从仓库根目录执行汇总所有示例包括 capabilities的原生测试。信任边界权限声明与命令策略的双重守卫示例的守卫模型由两层构成均可在 src/security/root.zig 中找到定义。第一层应用级权限permissions示例在 examples/capabilities/src/main.zig 声明了应用级权限数组const app_permissions [_][]const u8{ native_sdk.security.permission_window, native_sdk.security.permission_network, native_sdk.security.permission_filesystem, native_sdk.security.permission_notifications, native_sdk.security.permission_dialog, native_sdk.security.permission_clipboard, native_sdk.security.permission_credentials, };这 7 个权限字符串与 src/security/root.zig 中定义的常量一一对应window、command、view、dialog、filesystem、clipboard、network、notifications、credentials。同一组权限在 examples/capabilities/app.zon 的permissions字段中重复声明供打包期校验。第二层桥接命令策略BridgeCommandPolicy仅声明权限还不够每个命令必须显式列出所需权限与允许来源。示例在 examples/capabilities/src/main.zig 定义builtin_policiesconst builtin_policies [_]native_sdk.BridgeCommandPolicy{ .{ .name native-sdk.platform.supports, .permissions platform_permission, .origins bridge_origins }, .{ .name native-sdk.os.openUrl, .permissions network_permission, .origins bridge_origins }, .{ .name native-sdk.os.showNotification, .permissions notification_permission, .origins bridge_origins }, // ... revealPath / recentDocuments / dialog / clipboard / credentials 等 };其中bridge_origins [_][]const u8{ zero://inline, zero://app }表明只有来自这两个受信任来源的调用才会被接受。CommandPolicy的实际判定逻辑在 src/bridge/root.zigPolicy.allows()会先检查enabled再按命令名查表find()随后要求应用级权限列表完整包含该命令策略声明的所有权限security.hasPermissions最后校验调用 origin 是否命中origins白名单支持*通配。任何一环不满足调用即被拒绝。这正是 README 中“受守卫的 OS 能力”的落地机制桥接层不是“谁能调用”而是“哪个来源、带哪些权限才能调用”的命令级最小授权。导航策略与外部链接examples/capabilities/src/main.zig 的security.navigation还配置了两项allowed_origins bridge_origins允许导航的来源白名单external_links.action .open_system_browser、allowed_urls .{https://example.com/docs/*}仅当 URL 匹配该模式时才交给系统浏览器打开。对应的通配符校验逻辑见 src/security/root.zig*只能作为路径段后缀出现如https://example.com/docs/*且会拒绝https://example.com*这类可被中间人利用的宽泛模式测试用例!allowsExternalUrl(... https://example.com.evil/docs)直接覆盖了该场景。逐项拆解 WebView 侧的能力调用示例页面内联 HTML 中每个按钮绑定一个window.zero.invoke()调用见 examples/capabilities/src/main.zig。下表汇总各能力对应的命令、参数与作用能力命令关键参数效果发送通知native-sdk.os.showNotificationtitle/subtitle/body弹出系统通知平台探测native-sdk.platform.supportsfeature返回当前平台是否支持某能力打开 URLnative-sdk.os.openUrlurl按导航策略用系统浏览器打开显示路径native-sdk.os.revealPathpath在 Finder/文件管理器中定位文件最近文档native-sdk.os.addRecentDocument/clearRecentDocumentspath/ 空添加或清空系统最近文档列表剪贴板native-sdk.clipboard.writeText/readTexttext/ 空剪贴板文本写读往返对话框native-sdk.dialog.showMessagestyle/title/message/primaryButton原生消息对话框凭据native-sdk.credentials.set/get/deleteservice/account/secret系统凭据存储读写删这些命令的 TypeScript 类型签名可在 packages/native-sdk/native-sdk.d.ts 中对照NativeSdkApi.os、clipboard、credentials、dialogs、platform.supports等方法族以及NativeSdkNotificationOptions、NativeSdkCredentialKey、NativeSdkMessageDialogOptions等载荷结构。平台支持探测为能力分发做运行时判断前端“Check Support”按钮会依次查询 10 个特性examples/capabilities/src/main.zig[open_url,reveal_path,recent_documents,notifications,dialogs, clipboard_text,clipboard_rich_data,credentials,file_drops,app_activation_events]native-sdk.platform.supports返回布尔值应用据此决定 UI 是否可用某项能力避免在能力缺失的平台上硬调用报错。完整特性枚举含gpu_surfaces、context_menus、audio_playback等定义在 packages/native-sdk/native-sdk.d.ts 的NativeSdkPlatformFeature。凭据往返set → get → delete 一条龙示例的 Credential Round Trip 按钮演示了完整生命周期examples/capabilities/src/main.zigconst key { service: dev.native-sdk.capabilities, account: demo }; await inv(native-sdk.credentials.set, { ...key, secret: demo-token }); show({ token: await inv(native-sdk.credentials.get, key), deleted: await inv(native-sdk.credentials.delete, key), });先写入demo-token再读取回显最后删除。对应测试逐条断言了credentialSetCount、get返回demo-token、delete返回true见 examples/capabilities/src/main.zig。凭据键由service account唯一确定此结构同样反映在NativeSdkCredentialKey类型中。剪贴板与对话框剪贴板按钮先写入Copied from Native SDK再读取并回显无头测试则以plain text为载荷验证了writeText与readText的往返examples/capabilities/src/main.zig。对话框按钮以style:info、主按钮OK调用native-sdk.dialog.showMessage返回用户按下的按钮标识。文件拖放Zig 事件循环、WebView 事件桥与 canvas 目标三方联动文件拖放是本示例最复杂的部分README 明确说明了它的三种观察视角Zig 侧CapabilitiesApp.event处理files_dropped事件examples/capabilities/src/main.zig更新状态栏文本WebView 事件桥前端监听native-sdk:drop:files自定义事件并展示e.detail含windowId与paths对应NativeSdkFileDropDetail类型canvasdrop_files目标右侧 GPU 画布上安装一个带drop_files语义动作的按钮控件拖放到其上会命中canvas_widget_file_drop事件标记出具体 widget 目标 ID。拖放目标的安装与重建右侧 250pt 宽的drop-canvas是gpu_surface视图examples/capabilities/src/main.zig。首次收到gpu_surface_frame事件时installDropTarget会布局一棵包含目标 widget 的树并通过runtime.setCanvasWidgetLayout与emitCanvasWidgetDisplayList安装examples/capabilities/src/main.zigconst target canvas.Widget{ .id drop_target_id, // 2 .kind .button, .frame ..., .text Drop files here, .semantics .{ .label Drop files here, .actions .{ .drop_files true } }, };gpu_surface_resized事件会触发重新安装保证拖放命中测试几何始终与最新尺寸一致——测试中特意用x300超出初始 250pt 表面证明 resize 后重建了 retained widget 命中几何见 examples/capabilities/src/main.zig 的注释与断言。拖放事件分发逻辑event处理器维护pending_drop_target_id当canvas_widget_file_drop携带目标时记录该 ID随后到达的files_dropped若命中目标状态栏报告Widget target 2 fired若拖到 WebView无目标则只报告普通应用级Received file drop N。README 要求的手动验收步骤正是围绕这一区分设计的用系统后端运行应用将 Finder 文件拖到右侧Drop files here画布状态栏必须显示Widget target 2 fired与拖入路径拖到左侧 WebView 上则只应出现普通应用级拖放信息。打包元数据文件关联与自定义 URL scheme示例在 examples/capabilities/app.zon 中声明了两类打包期元数据用于安装后与系统深度集成file_associations: [ { name: Native SDK Capability Document, role: viewer, extensions: [zncap], mime_types: [application/vnd.native-sdk.capabilityjson] } ], url_schemes: [ { scheme: native-sdk-capabilities } ].zncap扩展名 application/vnd.native-sdk.capabilityjsonMIME 类型让系统把该扩展名关联到本应用角色viewernative-sdk-capabilities://scheme让native-sdk-capabilities:前缀的链接由本应用接管。Zig 侧通过hasField防御性读取这些字段examples/capabilities/src/main.zig并在“capabilities manifest declares package integration metadata”测试中逐一断言扩展名为zncap、scheme 为native-sdk-capabilitiesexamples/capabilities/src/main.zig。App 激活 / 失活事件event处理器通过lifecycle分支接收.activate与.deactivateexamples/capabilities/src/main.zig分别累加activation_count/deactivation_count并把状态栏文本改为 “App activated.” / “App deactivated.”。同时前端通过window.zero.on(app:activate, ...)与window.zero.on(app:deactivate, ...)订阅同名事件examples/capabilities/src/main.zig构成“Zig 事件循环 WebView 事件桥”双通道通知——这也是NativeSdkApi.on事件 API 的典型用法。无头测试验证不依赖 AppKit 的完整链路断言示例内置一个名为 “capabilities bridge gates native services and dispatches file drops” 的 Zig 测试examples/capabilities/src/main.zig以native_sdk.TestHarness在 null platform 上运行覆盖视图布局断言主 WebView650pt、右侧 drop-canvas250pt、底部 statusbar34pt的初始 frame 精确匹配含min_width与 restore 策略联动桥接命令逐条验证通知notificationCount与标题、平台探测notifications/recentDocuments返回result:true、打开 URLlastExternalUrl、显示路径lastRevealedPath、最近文档lastRecentDocumentPath与清空计数、剪贴板往返lastClipboardData、凭据 set/get/delete拖放命中模拟files_dropped到画布断言widget_drop_count、目标 ID2、last_drop_paths完整保真包括带换行符的/tmp/one\nname.txt与 WebView断言保持普通应用级拖放并验证状态栏前缀Widget target 2 fired生命周期事件派发.app_activated/.app_deactivated后断言计数与lastWindowEventName为app:activate/app:deactivate。测试中的dispatchBridge辅助函数以zero://inline来源、mainWebView 标签派发原始 JSON 桥接消息examples/capabilities/src/main.zig完整模拟了真实前端window.zero.invoke()的到达路径。延伸阅读示例声明与配置examples/capabilities/app.zon平台、权限、capabilities、shell 布局、安全导航、web_engine示例全部实现与测试examples/capabilities/src/main.zig权限常量与导航/外部链接判定src/security/root.zig桥接命令策略解析与allows判定src/bridge/root.zigWebView 侧 API 完整类型声明packages/native-sdk/native-sdk.d.tsNativeSdkApi、NativeSdkPlatformFeature、各 Options 载荷。本示例是理解 Native SDK“最小权限、命令级白名单、双通道事件”安全模型的最佳起点照此模式你可以为自己的桌面应用扩展新的受保护系统能力并在任何支持-Dplatformnull的环境中先行完成全链路自动化验证。赞分享桌面应用跨平台【免费下载链接】nativeToolkit for building native desktop apps项目地址https://gitcode.com/gh_mirrors/ze/native点击查看免费下载相关推荐用 Zig 与 Native SDK 组合原生面板与 WebView 内容native-panels 示例深度解析用 Zig 与 Native SDK 组合原生面板与 WebView 内容native panels 示例深度解析 本文以 Native SDK 仓库中的 n桌面应用跨平台Capn Proto能力式RPC实战用三方握手构建不受信任方之间的安全远程调用Capn Proto能力式RPC实战用三方握手构建不受信任方之间的安全远程调用 Capn Proto 是 C 生态中基于能力式安全capabilit后端通信用 V 语言在 x.async 任务中集成 MCP 工具调度mcp 集成示例全解析用 V 语言在 x.async 任务中集成 MCP 工具调度mcp 集成示例全解析 vlib/x/async/examples/mcp/ 下的示例展示了如何在编程语言编译器语言运行时标准库上一篇离线音频转录与翻译工具的完整使用指南下一篇Azure API Management DevOps Resource Kit实战案例构建多环境API部署策略创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考