將您的桌面應用程式設置為在 Visual Studio 中進行 MSIX 封裝

2025-04-22

如果您的桌面應用程式是 WinUI 3 應用程式，請參閱使用單一專案 MSIX 封裝您的應用程式。 WinUI 3 應用程式是針對其使用者介面使用 Windows UI 連結庫（WinUI） 3 架構的應用程式：並使用 Windows App SDK。
但對於所有其他類型的桌面應用程式，請繼續閱讀本主題。

您可以使用 Visual Studio 中的 Windows 應用程式封裝專案專案 ，為您的傳統型應用程式產生套件。然後，您可以將您的套件發佈到 Microsoft Store、網路上、您所在的企業內部或任何其他您正在使用的散發機制。

必要的 Visual Studio 版本和工作負載

Windows 應用程式封裝專案可在 Visual Studio 2017 15.5 和更新版本中取得。

若要查看 [新增專案] 功能表中的 [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市集），請從您已在合作夥伴中心保留的名稱，輕鬆地將身分識別指派給您的應用程式。

準備您的應用程式

開始為應用程式建立套件之前，請先檢閱本指南：準備封裝傳統型應用程式。

在您的方案中設定 Windows 應用程式封裝專案

在 Visual Studio 中，開啟包含桌面應用程式專案的解決方案。

備註

如果您想要在 x64 組態中封裝專案，請確定您已將參考的項目設定為 x64。若要確認這一點，請參閱下方的 [其他附注]（#Additional 附注）。

將 Windows 應用程式封裝專案 新增至您的方案，選擇符合現有 Dekstop 應用程式項目語言的適當語言（C# 或 C++）。

您不需要將任何程式代碼新增至封裝專案。其用途只是為您產生和設定套件。我們將此專案稱為 封裝專案。
將此項目 的目標版本 設定為您想要的任何版本，但請務必將 [最低版本 ] 設定為 [Windows 10 年度更新] 以下。
將 Windows 應用程式封裝項目 專案設定為啟始專案（以滑鼠右鍵按兩下專案，然後選取 [設定為啟始專案]。
在 [方案總管] 中，以滑鼠右鍵按兩下封裝專案底下的 [ 相依性 ] 資料夾，然後選擇 [ 新增項目參考...]。
選擇桌面應用程式專案，然後選擇 [確定] 按鈕。

您可以在套件中包含多個桌面應用程式，但當使用者選擇您的應用程式磚時，只能啟動其中的一個。在 [ 應用程式 ] 節點中，以滑鼠右鍵按下您希望使用者在選擇應用程式磚時啟動的應用程式，然後選擇 [ 設定為進入點]。
建置封裝項目以確保不會出現任何錯誤。如果您收到錯誤，請開啟 Configuration Manager ，並確定您的專案以相同的平台為目標。
使用 [ 建立應用程式套件精靈] 來產生 MSIX 套件/套件組合或 .msixupload/.appxupload 檔案（用於發佈至Microsoft市集）。

其他注意事項

若要建置適用於 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"_