用途
msix-package-generator 是一个面向 Windows 应用的 MSIX 打包配置生成技能,目标是帮助开发者完成从清单编写到签名、分发准备的完整 MSIX 打包工作流。根据提供的项目路径与应用基本信息,它会生成所需的配置文件与构建命令。
主要能力
- 生成 Package.appxmanifest 清单文件
- 创建所需的视觉资源(图标、磁贴等)配置
- 配置应用能力(Capabilities)与声明(Extensions)
- 设置 MSIX 代码签名
- 配置自动更新设置
- 准备 Microsoft Store 提交
- 生成 CI/CD 打包脚本
- 配置旁加载(sideload)部署
输入参数
必填项为 projectPath(项目路径)与 appInfo。appInfo 需包含 name、displayName、publisher、version,可选 description 与 publisherDisplayName。
可选 capabilities 数组,取值包括:internetClient、privateNetworkClientServer、documentsLibrary、musicLibrary、picturesLibrary、webcam、microphone、location、removableStorage、appointments、contacts。
可选 executables 数组,每项含 target、id 以及 subsystem(windows 或 console)。
可选 distribution,取值为 store、sideload、both,默认 sideload。
输出内容
输出包含 success 状态;files 数组,每项含 path 与 type(manifest、assets、priconfig、signing);以及 buildCommands 对象,含 package 与 sign 两条命令。
清单与资源
技能可生成 Package.appxmanifest 示例结构,包含 Identity(名称、发布者、版本、架构)、Properties(显示名称、发布者显示名称、Logo、描述)、Dependencies(目标设备族与版本)、Resources(语言)、Applications(可执行文件、入口点、视觉元素、默认磁贴、启动画面)以及 Extensions(文件类型关联、协议处理、启动任务)和 Capabilities。
视觉资源按固定尺寸组织,包括 StoreLogo 50x50、Square44x44Logo 及其 targetsize 变体(16/24/32/48/256)、Square150x150Logo、Square310x310Logo、Wide310x150Logo、SmallTile 71x71、SplashScreen 620x300、BadgeLogo 24x24 以及 AppIcon.ico。
同时提供 priconfig.xml 的资源配置示例,包括 Language 与 Scale 的自动资源包限定符与索引配置。
构建与签名
提供基于 msbuild 的打包命令、使用 makeappx 打包、使用 signtool 签名,以及通过 PowerShell 创建自签名测试证书的命令。还给出 .csproj 中启用 MSIX 工具链、运行时标识符、包标识与版本等配置示例。
CI/CD
提供 GitHub Actions 工作流示例:在 windows-latest 上检出代码、安装 .NET 8、从密钥解码证书、发布并签名 MSIX、上传产物。
使用建议
发布者标识应与证书匹配;提供所有显示缩放所需的完整资源尺寸;在多版本 Windows 上测试(MinVersion 影响兼容范围);生产分发使用受信任证书;能力按最小必要原则配置;在提交 Store 前先测试旁加载部署。
适用场景与限制
适用于需要为 Windows 桌面应用生成 MSIX 打包配置、签名与分发准备的开发者和发布流程。资料未说明该技能的具体运行环境要求、支持的应用框架范围(除示例涉及 .NET/WPF 外)、收费方式或版本兼容细节,这些暂未提供。