winapp CLI快速上手：10分钟从零跑通第一个带Windows包身份的应用

【免费下载链接】winappCliwinapp, the Windows App Development CLI, is a single command-line interface for managing Windows SDKs, packaging, generating app identity, manifests, certificates, and using build tools with any app framework.项目地址https://gitcode.com/gh_mirrors/wi/winappCli点击查看免费下载winapp CLIWindows App Development CLI是微软推出的 Windows 应用开发命令行工具一条命令即可搞定 Windows SDK 安装、包身份Package Identity生成、清单Manifest创建、开发证书和 MSIX 打包。本文以 .NET 应用为例带你快速上手10 分钟内从安装 winapp CLI到生成清单、带身份运行、最终打包出可安装的 MSIX 安装包。 为什么选择 winapp CLI很多现代 Windows API系统通知、协议处理器、开机启动项、端侧 AI 等都要求应用具备包身份。传统方式下你要手工完成下载 SDK、生成头文件、创建 appxmanifest、准备图片资源等十几步操作而 winapp CLI 把这些压缩成了 4 条命令它的完整工作流是Build → App Identity → Package → Ship构建 → 包身份 → 打包 → 发布第 1 步一键安装 winapp CLI在 Windows 终端PowerShell 或 Terminal中执行winget install Microsoft.winappcli --source winget安装完成后用--help或-V验证是否成功winapp --help winapp -V 如果你在做 Electron/Node.js 项目也可以通过 NPM 安装npm install microsoft/winappcli --save-dev然后用npx winapp调用。第 2 步创建 .NET 应用并检查包身份前提已安装 .NET SDK。创建一个控制台应用并运行确认一切正常dotnet new console -n dotnet-app cd dotnet-app dotnet run接下来做两件小事把.csproj中的TargetFramework改为带 Windows SDK 的版本例如net10.0-windows10.0.26100.0这样才能访问 WinRT API在代码中读取Windows.ApplicationModel.Package.Current成功则打印包家族名失败则输出Not packaged。此时运行dotnet run你会看到Not packaged—— 这就是普通可执行文件的无身份状态。第 3 步winapp init 一键初始化项目进入项目目录执行核心命令winapp initwinapp init会自动检测.csproj文件并为你完成✅ 把Microsoft.WindowsAppSDK、Microsoft.Windows.SDK.BuildTools等 NuGet 包写入项目✅ 校验并更新TargetFramework到受支持的 Windows TFM✅ 生成Package.appxmanifest应用清单和Assets/图片资源启动画面、磁贴、应用图标等✅ 生成开发证书按提示确认包名、发布者、版本即可全部回车接受默认值。之后用dotnet list package可以看到新加的 NuGet 包。[!NOTE] .NET 项目走 NuGet 管理包不会生成winapp.yaml文件克隆仓库后执行dotnet restore或winapp restore即可。第 4 步带包身份运行应用两种方式任选其一# 方式 Awinapp init 已加入 WinApp 支持包dotnet run 会自动走 winapp run dotnet run # 方式 B直接用 winapp run 构建并运行项目模式 winapp run .输出从Not packaged变成了Package Family Name: dotnet-app_12345abcde 恭喜你的应用已经以完整包身份运行可以解锁通知、协议、系统集身份相关 API 了。如果你更偏好稀疏包身份exe 留在原地注册身份可以改用winapp create-debug-identity exe详见 docs/debugging.md。第 5 步生成并安装 MSIX 包开发完成后一条命令链完成发布# 1. Release 构建 dotnet build -c Release # 2. 生成开发证书已存在则跳过 winapp cert generate --if-exists skip # 3. 打包并签名路径按你的项目 TFM 替换 winapp pack .\bin\Release\net10.0-windows10.0.26100.0 --manifest .\Package.appxmanifest --cert .\devcert.pfx # 4. 以管理员身份安装证书 winapp cert install .\devcert.pfx双击生成的.msix文件安装之后在终端直接输入应用名即可启动——它已经是一个正规的、带身份的 Windows 应用。 小贴士重新打包前先升级Package.appxmanifest中的Version否则 Windows 会拒绝降级更新正式分发建议使用 CA 签名证书或对 Microsoft Store 提交Store 会替你签名。 核心命令速查命令作用winget install Microsoft.winappcli安装 winapp CLIwinapp init一键初始化 SDK、清单、资源与证书winapp run .带包身份构建并运行应用winapp cert generate生成开发证书winapp pack 目录 --cert pfx打包并签名 MSIXwinapp cert install pfx安装开发证书 下一步完整命令参考docs/usage.md本教程详解版docs/guides/dotnet.md可运行的 .NET 示例samples/dotnet-app/其他框架入门指南C、Electron、Rust、Tauri、Flutter、.NET MAUI把现有 EXE/CLI 打成 MSIXdocs/guides/packaging-cli.md从Not packaged到带身份运行的Package Family Name再到可安装的 MSIX整个过程只需要这几条 winapp 命令。现在打开你的终端10 分钟后见赞分享【免费下载链接】winappCliwinapp, the Windows App Development CLI, is a single command-line interface for managing Windows SDKs, packaging, generating app identity, manifests, certificates, and using build tools with any app framework.项目地址https://gitcode.com/gh_mirrors/wi/winappCli点击查看免费下载相关推荐10分钟快速上手React Native Windows从零开始构建你的第一个Windows应用10分钟快速上手React Native Windows从零开始构建你的第一个Windows应用 想要使用React技术开发原生Windows应用 Reac跨平台前端10分钟快速上手ops-ras从零编译安装并跑通你的第一个NPU算子10分钟快速上手ops ras从零编译安装并跑通你的第一个NPU算子 本文带你 10分钟快速上手 ops ras 算子库 完成 NPU 算子的 环境安装、源密码学应用安全人工智能CANNAscend快速上手 Taste-Skill如何用 3 个旋钮调出有品味的 AI 前端设计快速上手 Taste Skill如何用 3 个旋钮调出有品味的 AI 前端设计 连续让 AI 做落地页第三版你还是看到了紫蓝渐变、深色网格底、三张一模一样宽AI 技能前端设计系统创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考