在 Visual Studio 中设置您的桌面应用程序以进行 MSIX 打包

2025-04-24

如果桌面应用是 WinUI 3 应用，请参阅使用单项目 MSIX 打包应用。 WinUI 3 应用是将 Windows UI 库（WinUI） 3 框架用于其用户界面（UI）的应用;并使用 Windows 应用 SDK。
但对于所有其他类型的桌面应用，请继续阅读本主题。

可以使用 Visual Studio 中的 Windows 应用程序打包项目项目 为桌面应用生成包。然后，可以将你的程序包分发到 Microsoft Store、Web、你的企业或你所使用的任何其他分发机制中。

所需的 Visual Studio 版本和工作负载

Visual Studio 2017 15.5 及更高版本中提供了 Windows 应用程序打包项目 项目。

若要查看“添加新项目”菜单中的 Windows 应用程序打包项目模板，需要确保至少安装了以下 Visual Studio 工作负载之一：

“通用 Windows 平台开发”工作负载
NET Core 工作负载中的可选组件“MSIX 打包工具”。
.NET 桌面开发工作负载中的可选组件“MSIX 打包工具”。

为获得最佳体验，建议使用最新的 Visual Studio 版本。

重要

Visual Studio 中的 Windows 应用程序打包项目 项目在 Windows 10 版本 1607 及更高版本上受支持。它只能用于面向 Windows 10 周年更新（10.0; 内部版本 14393）或更高版本的项目。

以下是您可以从 Visual Studio 应用程序打包项目中执行的其他操作：

✔️ 自动生成视觉资产。

✔️ 使用可视化设计器更改清单。

✔️ 使用向导生成程序包或捆绑包。

✔️（如果发布到 Microsoft Store）基于你已在合作伙伴中心预留的名称轻松为应用程序分配标识。

准备申请

在开始为应用程序创建包之前，请查看本指南：准备打包桌面应用程序。

在解决方案中设置 Windows 应用程序打包项目

在 Visual Studio 中，打开包含桌面应用程序项目的解决方案。

注释

如果要在 x64 配置中打包项目，请确保已将引用的项目配置为 x64。若要确认这一点，请参阅下面的[附加注解](#Additional notes)。

将 Windows 应用程序打包项目 项目添加到解决方案，选择与现有 dekstop 应用项目的语言匹配的相应语言（C# 或C++）。

无需将任何代码添加到打包项目。其用途只是为你生成和配置包。我们将此项目称为 打包项目。
将此项目 的目标版本 设置为所需的任何版本，但请确保将 最低版本 设置为不低于 Windows 10 周年更新。
将 Windows 应用程序打包项目项目 设置为启动项目（右键单击该项目，然后选择 “设置为启动项目”）。
在解决方案资源管理器中，右键单击打包项目下的 “依赖项 ”文件夹，然后选择“ 添加项目引用...”。
选择桌面应用程序项目，然后选择“ 确定 ”按钮。

可以在包中包含多个桌面应用程序，但当用户选择应用磁贴时，只能启动其中一个应用程序。在 “应用程序 ”节点中，右键单击希望用户在选择应用磁贴时启动的应用程序，然后选择“ 设置为入口点”。
生成打包项目，以确保未显示任何错误。如果收到错误，请打开 Configuration Manager 并确保项目面向同一平台。
使用 “创建应用包 ”向导生成 MSIX 包/捆绑包或 .msixupload/.appxupload 文件（用于发布到 Microsoft Store）。

其他注释

若要为 x64 平台生成 WAP，请执行以下步骤之一：

方法 1： 在任何项目上添加 WAP 项目之前，请通过配置管理器添加 x64 体系结构（如以下屏幕截图所示）。

配置管理器。

方法 2： 对于已添加 WAP 的现有项目，

手动从.sln文件条目中删除 x64 条目。

_Global_
_GlobalSection(SolutionConfigurationPlatforms) = preSolution_
_Debug|Any CPU = Debug|Any CPU_
_Debug|ARM = Debug|ARM_
_Debug|ARM64 = Debug|ARM64_ (remove)
_Debug|x64 = Debug|x64_ (remove)
_Debug|x86 = Debug|x86_
_Release|Any CPU = Release|Any CPU_
_Release|ARM = Release|ARM_
_Release|ARM64 = Release|ARM64_ (remove)
_Release|x64 = Release|x64_ (remove)
_Release|x86 = Release|x86"_