Important
Windows App開発 CLI は現在、一般プレビュー段階です。 機能とコマンドは、最終リリースの前に変更される可能性があります。 問題を作成して、フィードバックを共有します。
Windows App開発 CLI (winapp CLI) は、Windows SDK の管理、パッケージ化、アプリ ID、マニフェスト、証明書の生成、および任意のアプリ フレームワークでのビルド ツールの使用を行う単一のコマンド ライン インターフェイスです。 このツールは、クロスプラットフォーム開発と Windows ネイティブ機能の間のギャップを埋めます。
.NET/Win32、CMake、Electron、Rust を使用してビルドする場合でも、この CLI を使用すると、次のaccessを実行できます。
- Modern Windows API - Windows App SDK および Windows SDK (自動セットアップとコード生成を使用)
- パッケージ ID - 完全パッケージ化せずにパッケージ ID を追加してデバッグとテストを行う
- MSIX パッケージ - 署名とストア対応のアプリパッケージ化
- Developer Tools - マニフェスト、証明書、資産、ビルド統合
パッケージ ID が必要な理由
多くの強力な Windows API を利用するためには、アプリにパッケージ識別子が必要です。これにより、通常アクセスできない Windows が提供する OS コンポーネントを活用できるようになります。 ID を使用すると、アプリは通知、OS 統合、デバイス上の AI などの機能にaccessを得られます。
パッケージ ID と MSIX パッケージのロック解除の例:
- 対話型のネイティブ通知 と通知管理
- Windows エクスプローラー、タスク バー、シートの共有、その他のシェル サーフェスとの統合
-
プロトコル ハンドラー (
yourapp://URI) - デバイス上の AI (ローカル LLM、テキスト、画像 AI API)
- バックグラウンド タスク (アプリが閉じられたときに実行)
- ファイルの種類の関連付け
- クリーン インストール/アンインストールと自動更新
インストール作業
WinGet
CLI をインストールする最も簡単な方法は、WinGet (Windows Package Manager) を使用することです。
winget install Microsoft.winappcli --source winget
NPM
Electron プロジェクトの場合は、NPM を使用してインストールします。
npm install @microsoft/winappcli --save-dev
GitHub Actions / Azure DevOps
CI/CD pipelinesの場合は、setup-WinAppCli アクションを使用して、ランナー/エージェントに CLI を自動的にインストールします。
手動ダウンロード
GitHub リリースから最新のビルドをダウンロードします。
インストールを検証する
インストールが完了したら、CLI を呼び出してインストールを確認します。
winapp --help
または、Electron/Node.jsを使用している場合:
npx winapp --help
サポートされているフレームワーク
winapp CLI は、さまざまなアプリ フレームワークで動作します。
| フレームワーク | ガイド |
|---|---|
| .NET/ WPF / WinForms | .NETを開始する |
| C++ (CMake) | C++ を使い始める |
| 電子 | Electronを使って始めよう |
| Rust | Rustを始める方法 |
| Tauri | Tauri の使い方を始める |
| フラッター | Flutter を使い始める |
コマンドの概要
| カテゴリ | コマンド |
|---|---|
| セットアップ | init、 restore、 update |
| 包装 | pack, create-debug-identity |
| マニフェスト | マニフェスト生成, マニフェストのアセットを更新 |
| 証明書と署名 | 証明書の生成、 証明書のインストール、 署名 |
| Utilities | ツール, ストア, get-winapp-path |
| Node.js/Electron | node create-addon, node add-electron-debug-identity, node clear-electron-debug-identity |
完全な CLI リファレンスについては、 CLI リファレンスを参照してください。
Open source
winapp CLI がopen source。 ソース コード、ファイルの問題を見つけ、GitHubで投稿できます。
関連トピック
Windows developer