Windows 应用开发 CLI(winapp CLI)

重要

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 要求应用具有包标识。 借助标识,你的应用可以访问高级 OS 集成和设备 AI 等功能。 有关包标识解锁功能的完整列表以及帮助选择合适打包模型的信息,请参阅 打包概述

安装

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。

手动下载

GitHub 版本下载最新版本

验证安装

安装后,通过调用 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还原更新
包装 packcreate-debug-identity
清单 清单生成清单资产更新
证书和签名 证书生成证书安装签名
Utilities toolstoreget-winapp-path
Node.js/Electron node create-addonnode add-electron-debug-identitynode clear-electron-debug-identity

有关完整的 CLI 参考,请参阅 CLI 参考

开源

winapp CLI 开放源代码。 可以在 GitHub 中找到源代码、文件问题和贡献内容。