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 などの機能にaccessを得られます。 どのパッケージ 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