应用包要求

  • 项目

按照以下准则准备应用软件包以提交到 Microsoft Store。

在为 Microsoft Store 构建应用软件包之前

确保使用 Windows 应用认证工具包来测试应用。 我们还建议在不同类型的硬件上测试应用。 请注意，在你的应用通过我们的认证并在 Microsoft Store 中发布之前，它只能在拥有开发者许可证的计算机上安装和运行。

使用 Microsoft Visual Studio 构建应用软件包

如果使用 Microsoft Visual Studio 作为开发环境，那么其中已有的内置工具能让你快速轻松地创建应用软件包。 有关详细信息，请参阅打包应用。

注意

确保所有文件名都使用 ANSI。

在 Visual Studio 中创建软件包时，请确保使用与开发人员帐户关联的同一帐户登录。 软件包清单的某些部分有与你的帐户相关的具体详细信息。 这些信息会被自动检测和添加。 如果未在清单中添加附加信息，则可能会遇到软件包上传失败的情况。

生成应用的 UWP 程序包时，Visual Studio 可以创建 .msix 或 appx 文件，或者 .msixupload 或 .appxupload 文件。 对于 UWP 应用，我们建议始终在“程序包”页面中上传 .msixupload 或 .appxupload 文件。 有关为应用商店打包 UWP 应用的更多信息，请参阅使用 Visual Studio 打包 UWP 应用。

应用的软件包不一定要使用可信证书颁发机构的证书进行签名。

应用捆绑包

对于面向 UWP 的应用，Visual Studio 可以生成应用程序包（.msixbundle 或 .appxbundle）以减少用户所下载应用的大小。 如果定义了特定语言的资产、各种映像规模的资产或适用于 Microsoft DirectX 特定版本的资源，这将很有帮助。

注意

 一个应用捆绑包可以包含所有体系结构的软件包。

有了应用捆绑包，用户只用下载相关文件，而不用下载所有可能的资源。 有关应用捆绑包的更多信息，请参阅打包应用和使用 Visual Studio 打包 UWP 应用。

手动构建应用软件包

如果不使用 Visual Studio 创建软件包，则必须手动创建软件包清单。

请务必查看应用软件包清单文档，了解完整的清单详情和要求。 清单必须遵循软件包清单架构才能通过认证。

清单必须包含一些有关你的帐户和应用的具体信息。 可以通过仪表板中应用概览页面产品管理部分的查看应用标识的详细信息来查看这些信息。

注意

 清单中的值区分大小写。 空格和其他标点符号也必须匹配。 仔细输入数值并反复检查，确保它们正确无误。

应用程序包（.msixbundle 或 .appxbundle）使用不同的清单。 有关应用捆绑清单的详细信息和要求，请查看捆绑清单文档。 请注意，在 .msixbundle 或 .appxbundle 中，每个包含程序包的清单都必须使用相同的元素和属性，Identity 元素的 ProcessorArchitecture 属性除外。

提示

 在提交软件包之前，请务必运行 Windows 应用认证工具包。 这有助于确定你的清单是否存在任何可能导致认证或提交失败的问题。

软件包格式要求

应用软件包必须符合这些要求。

应用软件包属性 要求
包大小 .msixbundle 或 .appxbundle：每个捆绑包最大为 25 GB
面向 Windows 10 或 Windows 11 的 .msix 或 .appx 程序包：每个程序包最大为 25 GB
块映射哈希 SHA2-256 算法

重要

无法再上传使用 Windows Phone 8.x SDK 生成的新的 XAP 包。 Microsoft Store 中已经具有 XAP 程序包的应用将可以继续用于 Windows 10 移动设备。 有关详细信息，请参阅此博客文章。

支持的版本

对于 UWP 应用，所有程序包都必须以 Microsoft Store 支持的 Windows 10 或 Windows 11 版本为目标。 必须在应用清单 TargetDeviceFamily 元素的 MinVersion 和 MaxVersionTested 属性中指明软件包支持的版本。

当前支持的版本范围为：

  • 最低：10.0.10240.0
  • 最高：10.0.22621.0

StoreManifest XML 文件

StoreManifest.xml 是一个可选的配置文件，可包含在应用软件包中。 其目的是启用软件包清单未涵盖的功能，例如将声明应用为 Microsoft Store 设备应用，或声明软件包适用于设备所依赖的要求。 如果使用，StoreManifest.xml 与应用包一起提交，并且必须在应用的主项目的根文件夹中。 有关详细信息，请参阅 StoreManifest 架构。

将支持 HTTPS 的下载 URL（直接链接）提交到产品的安装程序二进制文件。 以这种方式提交的产品受以下要求的限制：

  • 安装程序二进制文件只能是 .msi 或 .exe。

  • 二进制文件及其所有可移植可执行 (PE) 文件必须使用代码签名证书进行数字签名，该证书链接到由作为 Microsoft 受信任的根程序的一部分的证书颁发机构 (CA) 颁发的证书。

  • 必须在合作伙伴中心提交已进行版本控制的下载 URL。 与该 URL 关联的二进制文件在提交后不得更改。

  • 只要有更新的二进制文件要进行分发，就必须在合作伙伴中心内提供与更新的二进制文件相关联且已进行版本控制的已更新下载 URL。 你负责维护和更新下载 URL。

  • 启动安装时，不得显示安装用户界面（即要求静默安装），但允许显示用户帐户控制 (UAC) 对话框。

  • 该安装程序是独立的安装程序，并且不是在运行时下载位的下载程序存根/Web 安装程序。

重要

应用加载项不支持应用软件包要求。