Windows アプリ 開発 CLI (winapp CLI)

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 .NET
C++ (CMake) C++ を使い始める
電子 Electronを使って始めよう
Rust Rustを始める方法
Tauri Tauri の使い方を始める
フラッター Flutter を使い始める

コマンドの概要

カテゴリ コマンド
セットアップ initrestoreupdate
包装 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で投稿できます。