這很重要
Windows 應用程式開發 CLI 目前處於 公開預覽。 功能與指令可能會在最終版本前有所變動。 請透過 creating a issue 分享你的回饋。
Windows 應用程式 開發 CLI（winapp CLI）是一個單一命令列介面，用於管理 Windows SDK、打包、產生應用程式身份、清單、憑證，以及在任何應用程式框架下使用建置工具。 此工具彌合跨平台開發與 Windows 原生能力之間的鴻溝。
無論你是使用 .NET/Win32、CMake、Electron 或 Rust，這個 CLI 都能讓你存取：
Modern Windows APIs Windows 應用程式 SDK 以及具備自動設定與程式碼產生功能的 Windows SDK- 套件識別 碼 - 透過新增套件識別碼來除錯與測試，無需完整封裝
- MSIX 封裝 - 具備數位簽署與商店上架準備的應用程式打包
- Developer Tools - 清單、憑證、資產與建構整合
為什麼要包裝身份？
許多強大的 Windows API 要求你的應用程式必須有套件身份。 透過身份認證，你的應用程式將獲得通知、作業系統整合及裝置上 AI 等功能access。 要查看套件識別功能解鎖的完整清單以及選擇合適包裝模型的幫助，請參閱 包裝總覽。
安裝
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 管線，請使用 setup-WinAppCli 動作自動安裝 CLI 到執行者/代理程式上。
手冊下載
從 GitHub Releases 下載最新版本。
確認安裝
安裝後，請透過呼叫 CLI 來驗證安裝：
winapp --help
或者如果使用 Electron/Node.js：
npx winapp --help
支援的架構
Winapp CLI 可搭配多種應用程式框架：
| Framework | Guide |
|---|---|
| .NET / WPF / WinForms | 開始使用 .NET |
| C++ （CMake） | 開始使用 C++ |
| 電子 | 從頭開始學習 Electron |
| Rust | 開始使用 Rust |
| 陶瑞 | 開始使用Tauri |
| 撲動 | 開始使用Flutter |
額外指南：
- 打包 EXE/CLI：將現有 EXE/CLI 打包為 MSIX 的逐步指南
- Shell 補全：在 PowerShell、bash、zsh 和 fish 中啟用指令、選項和值的 Tab 補全功能
命令概觀
| 類別 | Commands |
|---|---|
| 設定 | 初始化、 還原、 更新 |
| 身份與除錯 | 執行、 建立除錯身份、 取消註冊 |
| 封裝 | 包 |
| 清單 | manifest generate，manifest update-assets，manifest add-alias |
| 證書與簽署 | cert generate， cert install， sign， create-external-catalog |
| 公用程式 | tool、 store、 get-winapp-path、 完成 |
| UI 自動化 | ui |
| Node.js/電子 | node create-addon、 node add-electron-debug-identity、 node clear-electron-debug-identity |
完整 CLI 參考，請參見 CLI 參考。
開放原始碼
Winapp CLI 是 開放原始碼。 你可以在 GitHub 找到原始碼、檔案問題並貢獻。
