winapp-setup

用途：为已有项目添加 Windows 平台支持、管理 Windows SDK / Windows App SDK 版本，或从官方模板新建 WinUI 3 应用。init 不会创建新项目，只为现有代码库（Electron、.NET、C++、Rust、Flutter、Tauri 等）添加 Windows 平台文件。\n\n主要能力：winapp new 从官方 WinUI 模板脚手架（含 XAML 与实验性 Reactor 两种风格）；winapp init 生成 Package.appxmanifest、Assets、winapp.yaml 与 .winapp/；restore 按 winapp.yaml 重装 SDK 包（.NET 项目转调 dotnet restore）；update 更新 SDK 版本；run 注册调试身份并启动；--sparse 为已构建 exe 生成仅含身份的稀疏清单。\n\n使用方式：先安装 CLI，非 Node 项目用 winget install Microsoft.WinAppCli --source winget；Electron/Node 项目用 npm install --save-dev @microsoft/winappcli。随后按场景执行 winapp new、winapp init . --use-defaults、winapp restore、winapp update、winapp run 等，具体参数以官方帮助为准。\n\n适用场景：接入 Windows 平台支持、克隆仓库后恢复 SDK 包、更新 SDK、创建或运行打包/非打包 WinUI 应用、为已有桌面 exe 赋予包身份。\n\n限制：需已有项目；已含 Package.appxmanifest 的 .NET 项目通常无需 init；.winapp/ 被 gitignore；sparse 需配合 --exe，且目标目录已有 appxmanifest.xml 时会失败（可 --force）；私有源解析规则与 dotnet restore 类似，请只在可信目录运行。文档未提供完整收费、价格与授权信息。