用途:这是面向 AI 智能体的 Native SDK 核心指南,在解释 Native SDK 或改动其应用前应先阅读。它覆盖共享基础与 WebView 壳架构,两种架构(原生渲染面与 WebView)共用窗口、策略、生命周期、命令和平台服务,同一应用可混用。智能体不应凭通用模型知识假设已了解该 SDK。
主要能力:应用由 WebViewSource(内联 HTML、URL 或本地打包资源)和 app.zon 清单(身份、图标、窗口、前端资源、Web 引擎、权限、桥策略、安全策略、打包输入)描述;运行时拥有事件循环、窗口、桥分发、安全检查、自动化、追踪、平台服务与窗口状态。frontend/ 为普通 Web 代码,通过 window.zero.invoke() 与原生 Zig 通信。
必要用法:先 npm install -g @native-sdk/cli,再 native init my_app --frontend next,然后 zig build run。实现工作需运行 native skills get core --full 以包含引用文件。常用验证命令:zig build run、zig build dev、zig build test、zig build test-tooling、native validate app.zon、native doctor --manifest app.zon --strict、zig build package。完成改动前应同时运行 zig build 和 zig build test。
适用场景与限制:适用于创建、调试、打包 Native SDK 应用及配置桥命令、窗口、Web 引擎等。工具包要求 Zig 0.16.0;std API 出现 “no member named” 报错说明代码针对旧版 Zig。桥调用有大小限制,经来源与权限检查,仅路由到已注册处理器,内置对话框默认拒绝。默认系统 WebView,需要固定渲染时用 chromium 与 CEF。本技能侧重基础与壳架构,原生标记编写需另载 native-ui。