用途:winapp 是 Windows 应用开发命令行工具,管理 Windows SDK、MSIX 打包、应用标识、清单、证书、签名、商店发布以及 UI 自动化,支持 .NET/csproj、C++、Electron、Rust、Tauri、Flutter 等面向 Windows 的框架。当前为公开预览版,内容可能变动。
前置条件与安装:需要 Windows 10 或更高版本。安装方式:WinGet 使用 winget install Microsoft.WinAppCli --source winget;Electron/Node 使用 npm install @microsoft/winappcli --save-dev;CI 可用 setup-WinAppCli GitHub Action;也可从 GitHub Releases 手动安装。
主要能力:init 初始化项目(配置 SDK、清单、winapp.yaml,.csproj 项目跳过 YAML 改用 NuGet,v0.2.0+ 不再自动生成证书);restore/update 恢复或更新 SDK 包版本;pack <dir> 构建 MSIX(支持 --generate-cert、--cert、--self-contained、--output,v0.2.1+ 自动发现第三方 WinRT 组件);run <dir> 以松散布局运行打包应用,便于 IDE F5 调试,支持 -- 传参;create-debug-identity <exe> 为 exe 添加稀疏包标识以调用需标识的 API;unregister 移除侧载开发包;manifest 生成清单并支持从一张图生成图标;cert 管理开发证书;sign 签名 MSIX 或 exe;tool 运行 Windows SDK 构建工具;store 调用商店开发者 CLI;create-external-catalog 生成 TrustedLaunch 稀疏包所需目录;ui 子命令提供 UI 自动化并支持 --json;node 子命令提供 Electron/Node 辅助。
典型用法:在应用目录执行 winapp init(CI 加 --no-prompt),再执行 winapp cert generate 生成开发证书,随后用框架自带工具链构建,最后用 winapp pack 打包并用证书签名,可选再签名或提交商店。
限制与注意事项:v0.3.1 起 ui --json 结构有变化,部分子命令输出未变;init 不再自动生成证书;.csproj 项目跳过 winapp.yaml;SDK 包缓存改为 NuGet 全局缓存;清单变更后需重新执行 create-debug-identity。常见问题包括证书不受信任、需开启开发者模式、注册冲突可先 unregister。官方文档、.NET 指南与示例链接见 winapp CLI 仓库。