native-sdk

Native SDK

Native SDK は、ネイティブデスクトップアプリケーションを構築するための完全なツールキットです。主な開発方法は、src/core.ts の TypeScript アプリロジックと、.native ファイルの宣言型 Native マークアップを組み合わせることです。 TypeScript コアは事前にチェックおよびコンパイルされてネイティブコードになるため、配布バイナリにはブラウザー、WebView、JS ランタイム、インタープリターは含まれません。Zig はツールキット自体の動作に使われており、明示的に選択するアプリコアの代替手段として第一級にサポートされています（--template zig-core）。SDK の実装言語からデフォルトで選ばれるものではありません。すべてのアプリには決定論的な自動化サーバーが組み込まれているため、エージェントは実行中のウィンドウのスナップショットを取得し、操作し、スクリーンショットを撮影できます。デスクトップが成熟した領域であり（macOS が最も充実し、Linux と Windows も CI でテストされています）、モバイルへの組み込みは実験段階です。WebView サーフェスは、Web コンテンツの組み込みや既存の Web フロントエンドのホスティングに使うオプションの手段として共存しています。

まずはこちら

このファイルは、npx skills add native-sdk などのスキルインストーラーで Native SDK を一度インストールしたエージェント向けの案内用スタブです。Native SDK アプリの実装や説明を始める前に、インストール済み CLI を使って最新のスキルコンテンツを確認し、読み込んでください。

native skills list
native skills get core
native skills get native-ui
native skills get ts-core

最初の概要を確認するには、native skills get core を使います。デフォルトのアプリ開発方法で実装する場合は、実装を始める前に native-ui（ビュー、バインディング、アプリループ）と ts-core（TypeScript のサブセット、エフェクト、サブスクリプション、モジュール）の両方を読み込んでください。ツリーに src/services/ がある場合や、通常の TypeScript で Cmd.request の背後にあるファイルシステム／プロセス／JSON／正規表現／Map／Date／クラスの処理が必要な場合は、ts-services も読み込んでください。低レベルのランタイム配線、WebView、ブリッジ／セキュリティ、ネイティブ機能、パッケージング、デバッグに取り組む場合は、native skills get core --full を使います。実行中のアプリのテスト、スナップショットの取得、リロードの要求、組み込み自動化サーバーの使用には、native skills get automation を使います。既存の Zig コア、ツールキットの拡張、SDK の実装作業、または Zig 0.16 のコンパイルエラーに取り組む場合に限り、native skills get zig を使います。

クイックガイド

npm install -g @native-sdk/cli
native init my_app
cd my_app
native dev

native init my_app は、主要な3つのファイルで構成されるアプリを生成します。app.json、src/app.native（マークアップビュー）、src/core.ts（Model、Msg、update）です。既存の app.zon マニフェストも引き続きサポートされています。既存のアプリを編集する前にツリーを確認し、すでに使われているコア言語を維持してください。src/main.zig がある場合、そのアプリでは Zig コアテンプレートが明示的に使われています。Web フロントエンドのシェルには、さらに frontend/ と、通常は専用のビルド／ランタイム配線が含まれます。