Important
Windows アプリ開発 CLI は現在、公開プレビュー中です。 機能とコマンドは、最終リリースの前に変更される可能性があります。 問題を作成して、フィードバックを共有します。
Windows アプリ開発 CLI (winapp CLI) は、Windows SDK の管理、パッケージ化、アプリ ID、マニフェスト、証明書の生成、および任意のアプリ フレームワークでのビルド ツールの使用を行う単一のコマンド ライン インターフェイスです。 このツールは、クロスプラットフォーム開発とWindowsネイティブ機能の間のギャップを埋めるものです。
.NET/Win32、CMake、Electron、Rust を使用してビルドする場合でも、この CLI を使用すると、次の操作を行うことができます。
- Modern Windows API - Windows アプリ SDK および自動セットアップとコード生成を使用した Windows SDK
- パッケージ ID - 完全パッケージ化せずにパッケージ ID を追加してデバッグとテストを行う
- MSIX パッケージ - 署名とストア対応のアプリパッケージ化
- Developer Tools - マニフェスト、証明書、資産、ビルド統合
パッケージ ID が必要な理由
多くの強力なWindows API では、アプリにパッケージ ID が必要です。 ID を使用すると、アプリは高度な OS 統合やデバイス上の AI などの機能にアクセスできます。 どのパッケージ ID がロック解除され、適切なパッケージ モデルの選択に役立つかの完全な一覧については、「 パッケージ化の概要」を参照してください。
インストール作業
WinGet
CLI をインストールする最も簡単な方法は、WinGet (Windows パッケージ マネージャー) を使用することです。
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 | |
| 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(Electronのデバッグアイデンティティを追加する)、node clear-electron-debug-identity(Electronのデバッグアイデンティティをクリアする) |
完全な CLI リファレンスについては、 CLI リファレンスを参照してください。
オープンソース
winapp CLI がオープンソース。 ソース コード、ファイルの問題を見つけ、GitHubで投稿できます。
関連トピック
Windows developer