重要
Windows 应用开发 CLI 目前为公开预览。 在最终发布之前，功能和命令可能会更改。 通过创建问题来共享反馈。
Windows 应用开发 CLI（winapp CLI）是一个命令行界面，用于管理Windows SDK、打包、生成应用标识、清单、证书，以及将生成工具用于任何应用框架。 此工具弥合了跨平台开发和Windows本机功能之间的差距。
无论你是使用 .NET/Win32、CMake、Electron 还是 Rust 进行生成，此 CLI 都允许你访问：
- Modern Windows API - Windows 应用 SDK和Windows SDK，具有自动设置和代码生成
- 包标识 - 通过添加包标识而不进行完整打包来调试和测试
- MSIX 打包 - 使用签名和应用商店就绪情况进行应用打包
- Developer Tools - 清单、证书、资产和构建集成
为什么包标识重要？
许多功能强大的Windows API 要求应用具有包标识。 通过身份识别，您的应用可以访问通知、操作系统集成以及设备上的人工智能等功能。 有关包标识解锁功能的完整列表以及帮助选择合适打包模型的信息，请参阅 打包概述。
安装
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。
手动下载
验证安装
安装后，通过调用 CLI 验证安装：
winapp --help
或者，如果使用 Electron/Node.js：
npx winapp --help
支持的框架
winapp CLI 适用于各种应用框架：
| Framework | 指南 |
|---|---|
| .NET/ WPF / WinForms | 开始使用 .NET |
| C++ （CMake） | 开始使用 C++ |
| 电子 | 开始使用 Electron |
| Rust | 开始学习 Rust |
| 陶里 | 开始使用Tauri |
| Flutter | 开始使用 Flutter |
其他指南：
- 打包 EXE/CLI：将现有 EXE/CLI 打包为 MSIX 的分步指南
- Shell 补全：在 PowerShell、bash、zsh 和 fish 中为命令、选项和值启用 Tab 自动补全。
命令概述
| 类别 | 指令 |
|---|---|
| Setup | init、 还原、 更新 |
| 标识和调试 | run， create-debug-identity， unregister |
| 包装 | 打包 |
| 清单 | 清单生成， 清单更新资产， 清单添加别名 |
| 证书和签名 | 证书生成， 证书 安装， 签名， create-external-catalog |
| Utilities | 工具， 存储， 获取-winapp-路径， 完成 |
| UI 自动化 | ui |
| Node.js/Electron | node create-addon，node add-electron-debug-identity，node clear-electron-debug-identity |
有关完整的 CLI 参考，请参阅 CLI 参考。
开源
winapp CLI 开放源代码。 可以在 GitHub 中找到源代码、文件问题和贡献内容。
