重要
Windows 应用程序开发 CLI 目前为 公开预览。 在最终发布之前，功能和命令可能会更改。 通过创建问题来共享反馈。
Windows App开发 CLI（winapp CLI）是一个命令行界面，用于管理 Windows SDK、打包、生成应用标识、清单、证书，以及将生成工具用于任何应用框架。 此工具弥合了跨平台开发和 Windows 本机功能之间的差距。
无论你是使用 .NET/Win32、CMake、Electron 还是 Rust 进行开发，此 CLI 都为你提供访问权限：
- Modern Windows API - Windows App SDK 和 Windows SDK 具有自动设置和代码生成
- 包标识 - 通过添加包标识而不进行完整打包来调试和测试
- MSIX 打包 - 使用签名和应用商店就绪情况进行应用打包
- Developer Tools - 清单、证书、资产和构建集成
为什么包标识重要？
许多强大的 Windows API 要求你的应用程序具备包标识，以便你能够利用 Windows 提供的操作系统组件，而这些是在其他情况下无法访问的。 通过身份识别，您的应用可以访问通知、操作系统集成以及设备上的人工智能等功能。
包标识和 MSIX 打包所能实现的功能示例：
- 交互式本机通知 和通知管理
- 与 Windows 资源管理器、任务栏、共享面板和其他 shell 图面集成
-
协议处理程序 （
yourapp://URI） - 设备 AI （本地 LLM、文本和图像 AI API）
- 后台任务 （关闭应用时运行）
- 文件类型关联
- 清理安装/卸载和自动更新
安装
WinGet
安装 CLI 的最简单方法是通过 WinGet （Windows Package Manager）：
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 |
命令概述
| 类别 | 指令 |
|---|---|
| Setup | init、 还原、 更新 |
| 包装 | pack， create-debug-identity |
| 清单 | 清单生成， 清单资产更新 |
| 证书和签名 | 证书生成， 证书安装， 签名 |
| Utilities | tool， store， get-winapp-path |
| Node.js/Electron | node create-addon，node add-electron-debug-identity，node clear-electron-debug-identity |
有关完整的 CLI 参考，请参阅 CLI 参考。
Open source
winapp CLI open source。 可以在 GitHub 中找到源代码、文件问题和贡献内容。
