Windows Package Manager 清单文件全流程指南

Windows Package Manager 清单文件全流程指南

winget-pkgs The Microsoft community Windows Package Manager manifest repository 项目地址: https://gitcode.com/gh_mirrors/wi/winget-pkgs

前言

Windows Package Manager 作为微软推出的包管理工具，正在改变 Windows 生态中软件安装与管理的方式。本文将详细介绍如何为 Windows Package Manager 创建、测试和提交软件包清单文件（Manifest），帮助开发者将自己的应用纳入官方软件源。

清单文件基础概念

清单文件是 YAML 格式的配置文件，它包含了软件包的元数据和安装指令。一个完整的清单文件需要包含以下关键信息：

• 软件包标识符（PackageIdentifier）
• 软件名称（PackageName）
• 发布者（Publisher）
• 版本号（PackageVersion）
• 安装程序下载链接（InstallerUrl）
• 安装程序哈希值（InstallerSha256）
• 安装命令参数（InstallModes）

清单文件创建工具

官方推荐工具

1. Windows Package Manager Manifest Creator：微软官方提供的图形化工具，适合初学者使用，可以自动生成符合规范的清单文件。

2. YamlCreate.ps1：PowerShell 脚本工具，适合批量处理或自动化场景。

社区开发工具

• Komac：由社区开发者维护的清单创建工具，提供了更多高级功能和自定义选项。

专业提示：无论使用哪种工具，最终生成的清单文件都需要经过严格验证才能提交。

清单文件测试流程

本地测试准备

在开始测试前，需要执行以下命令启用本地清单文件支持：

winget settings --enable LocalManifestFiles

验证清单语法

使用以下命令验证清单文件语法是否正确：

winget validate --manifest <清单文件路径>

测试安装过程

验证语法无误后，测试实际安装过程：

winget install --manifest <清单文件路径>

Windows Sandbox 测试

为了确保安装过程不会影响主机系统，推荐使用 Windows Sandbox 进行隔离测试：

.\Tools\SandboxTest.ps1 <清单文件路径>

此脚本会自动在沙箱环境中验证并测试安装过程。

清单文件提交规范

文件目录结构

提交的清单文件必须按照以下目录结构组织：

manifests\<发布者首字母小写>\<发布者名称>\<软件包名称>\<版本号>\

例如，Microsoft Edge 的清单文件路径可能为：

manifests\m\Microsoft\Edge\93.0.961.47\

提交注意事项

1. 每个 Pull Request 只能包含一个软件包的清单文件
2. 提交前确认没有重复的软件包清单
3. 确保所有必填字段完整且格式正确

审核流程详解

自动化验证

提交后会触发自动化验证流程，系统会检查：

• 清单文件格式合规性
• 安装程序哈希值匹配
• 必要的元数据完整性

人工审核

通过自动化验证后，将由 Windows Package Manager 管理员或社区审核员进行人工审核，重点关注：

• 软件来源合法性
• 安装程序安全性
• 用户体验合理性

反馈处理

如果审核发现问题，提交者有7天时间进行修改。逾期未处理，Pull Request 将被自动关闭。

最佳实践建议

1. 版本控制：每次软件更新都应提交新的清单文件，保持历史版本可用。

2. 多架构支持：如果软件提供x86和x64版本，应在同一清单文件中包含所有架构的安装程序。

3. 静默安装：确保安装程序支持静默安装参数，提供良好的自动化体验。

4. 哈希值安全：务必提供安装程序的SHA256哈希值，确保下载完整性。

5. 依赖声明：如果软件有运行时依赖（如.NET Framework），应在清单中明确声明。

通过遵循这些指南，开发者可以高效地将自己的软件纳入 Windows Package Manager 生态，为用户提供更便捷的安装体验。

winget-pkgs The Microsoft community Windows Package Manager manifest repository 项目地址: https://gitcode.com/gh_mirrors/wi/winget-pkgs