在 Visual Studio 中打包桌面或 UWP 應用程式

散發應用程式之前，您需要封裝它。 本文描述使用 Visual Studio 配置、建立及測試 MSIX 套件的過程。

應用程式套件的類型

  • 應用程式套件 （.msix 或 .appx）
    包含應用程式及其資源的單一套件，以單一裝置架構為目標。 例如，x64 或 x86 應用程式套件。 若要以應用程式套件針對多個架構，您必須為每個架構生成一個套件。

  • 應用程式套件組合 （.msixbundle 或 .appxbundle）
    應用程式套件組合是一種套件類型，可包含多個應用程式套件，每個套件都是為了支援特定裝置架構而建置的。 例如，應用程式套件組合可以包含 x86、x64 和 ARM 元件的三個不同的應用程式套件。 應用程式套件組合應該儘可能產生，因為它們允許您的應用程式在最廣泛的裝置上使用。

  • 應用程式套件上傳檔案 （.msixupload 或 .appxupload） - 僅適用於市集提交
    單一檔案，可包含多個應用程式套件或應用程式套件組合，以支援各種處理器架構。 應用程式套件上傳檔中也包含一個符號檔，用於分析應用程式效能；這是在應用程式在Microsoft Store發佈之後使用。 如果你打算用 Visual Studio 打包應用程式，並打算提交到 Partner Center 發佈到 Microsoft Store，這個檔案會自動幫你建立。

以下是準備和建立應用程式套件的步驟概觀：

  1. 封裝應用程式之前。 請遵循下列步驟，以確保您的應用程式已準備好封裝。

  2. 設定您的專案。 使用 Visual Studio 的清單設計器來設定套件。 例如，新增磚影像，然後選擇您的應用程式所支援的方向。

  3. 產生應用程式套件。 使用 Visual Studio 的打包嚮導來建立一個應用程式包。

  4. 執行、偵錯及測試已封裝的應用程式。 你可以從 Visual Studio 執行並除錯你的應用程式套件，或直接安裝套件。

封裝應用程式之前

  1. 測試您的應用程式。 在封裝應用程式之前，請確定它可在您計劃支援的所有裝置系列上如預期般運作。 這些裝置家族可能包括桌上型、行動裝置、Surface Hub、Xbox、物聯網裝置或其他。 如需更多關於使用 Visual Studio 部署與測試應用程式的資訊，請參見 部署與除錯 UWP 應用（也適用於打包桌面應用程式）。

  2. 優化您的應用程式。 你可以使用 Visual Studio 的效能分析與除錯工具，優化你所打包應用程式的效能。 例如，UI 回應性的時程表工具、記憶體使用量工具、CPU 使用量工具等等。 如需這些工具的詳細資訊，請參閱 程式代碼剖析功能導覽 主題。

  3. 檢查 .NET 原生相容性（適用於 VB 和 C# 應用程式）。 在 通用 Windows 平台 中，有一個原生編譯器可以提升應用程式的執行效能。 使用此變更時，您應該在此編譯環境中測試您的應用程式。 預設情況下，Release 建置設定啟用了 .NET native 工具鏈，因此測試應用程式時使用此 Release 設定並檢查應用程式是否如預期運作非常重要。

設定您的專案

應用程式指令清單檔案 （Package.appxmanifest） 是一個 XML 檔案，其中包含建立應用程式套件所需的屬性和設定。 例如，應用程式指令清單檔案中的屬性會描述用於作為應用程式磁貼的影像，以及當使用者旋轉裝置時應用程式所支援的方向。

Visual Studio 的清單設計器允許你在不修改原始 XML 的情況下更新清單檔案。

使用清單設計工具配置套件

  1. 在 方案總管 中，展開應用程式專案的專案節點。

  2. 雙擊 Package.appxmanifest 檔案。 如果清單檔案已經在 XML 程式碼檢視中開啟，Visual Studio 會提示你關閉該檔案。

  3. 現在您可以決定如何設定您的應用程式。 每個索引標籤都包含您可以設定有關應用程式的資訊，並視需要連結到詳細資訊。

    Visual Studio 中的 Manifest 設計器

    檢查您擁有應用程式在 [ 視覺資產 ] 索引標籤上所需的所有影像。這是您將提供 應用程式圖示和標誌的位置。

    您可以從 [ 封裝] 索引標籤輸入發佈資料。 您可以在其中選擇要用來簽署應用程式的憑證。 所有 MSIX 應用程式都必須使用憑證簽署。

    備註

    自 Visual Studio 2019 起，封裝桌面或 UWP 專案不再產生臨時憑證。 若要建立或匯出憑證，請使用本文 中所述的 PowerShell Cmdlet。 在近期版本的 Visual Studio 中，你也可以用儲存在 Azure Key Vault 的憑證簽署應用程式，用於開發和測試場景。

    這很重要

    如果你在 Microsoft Store 發佈應用程式，應用程式會以可信憑證為你簽署。 這可讓使用者安裝及執行您的應用程式，而不需要安裝相關聯的應用程式簽署憑證。

    如果您要在裝置上安裝應用程式套件，您必須先信任套件。 若要信任套件，憑證必須安裝在用戶的裝置上。

  4. 在您為應用程式進行必要的編輯之後，儲存 Package.appxmanifest 檔案。

如果你是透過 Microsoft Store 發佈應用程式，Visual Studio 可以將你的套件與 Store 關聯起來。 操作方法是在方案總管中右鍵點擊你的專案名稱，並選擇 Publish->Associate App with the Store（在 2019 Visual Studio 16.3 版本之前，Publish選單名為 Store）。 您也可以在建立 應用程式套件 精靈中執行這項作，如下一節所述。 當您建立應用程式關聯時，manifest 設計工具的 [封裝] 標籤中的某些欄位會自動更新。

產生應用程式套件

應用程式可以在不發佈於商店的情況下安裝，方法是透過應用程式管理工具如 Microsoft Intune 和 設定管理員 等，直接發佈在你的網站。你也可以直接安裝 MSIX 套件，在本地或遠端機器上進行測試。

使用封裝精靈建立應用程式套件

備註

以下說明與截圖描述了截至 Visual Studio 2019 16.3 版本的流程。 如果您使用舊版，某些UI看起來可能會不同。 如果你正在打包桌面應用程式，請右鍵點擊 Windows 應用程式封包 Project 節點。

  1. 在 方案總管 中，開啟你的應用程式專案的解決方案。

  2. 右鍵點擊專案，選擇 Publish->Create App Packages（在 2019 版本 16.3 Visual Studio之前，Publish選單名為 Store）。

    導覽至 [建立應用程式套件] 的操作功能表

  3. 在精靈的第一頁中選取側載，然後按下一步。

    [建立您的套件] 對話框顯示側載模式

  4. 在 [ 選取簽署方法] 頁面上，選取是否要略過封裝簽署，或選取要簽署的憑證。 您可以從本機證書存儲選取憑證、選取憑證檔案，或建立新的憑證。 若要在終端使用者的計算機上安裝 MSIX 套件，必須使用電腦上信任的憑證進行簽署。

    顯示 [建立您的套件 - 簽署] 對話框視窗

  5. 請依照 使用 Visual Studio 建立您的應用程式套件上傳檔案 一節中的說明，完成 選取並設定套件 頁面。

請雙擊以安裝應用程式包

只要按兩下應用程式套件檔案即可安裝應用程式套件。 若要這樣做，請流覽至您的應用程式套件或應用程式套件組合檔案，然後按兩下它。 應用程式安裝程式 會啟動並提供基本應用程式資訊，以及安裝按鈕、安裝進度列，以及任何相關的錯誤訊息。

備註

應用程式安裝程序假設套件是以裝置上信任的憑證簽署。 如果不是，您必須將簽署憑證安裝到裝置上的受信任人員或受信任的發行者證書頒發機構單位存放區。 如果您不確定如何執行這項作，請參閱 安裝測試憑證。

使用安裝文稿安裝您的應用程式套件

  1. 開啟 *_Test 資料夾。

  2. 以滑鼠右鍵按兩下 Add-AppDevPackage.ps1 檔案。 選擇 [使用 PowerShell 執行 ]，然後遵循提示。
    流覽至 PowerShell 腳本的檔案總管

    安裝應用程式套件之後，PowerShell 視窗會顯示此訊息： 您的應用程式已成功安裝。

  3. 按兩下 [開始] 按鈕，依名稱搜尋應用程式，然後啟動它。

後續步驟：偵錯及測試您的應用程式套件

請參考 Run， debug， and test a app package，了解如何在Visual Studio或使用Windows除錯工具來除錯你的應用程式。

產生應用程式套件上傳檔案以進行市集提交

若要將您的應用程式分發給Microsoft Store，我們建議您產生一個app套件上傳檔（.msixupload 或 .appxupload），並將此檔案提交至合作夥伴中心。 雖然您可以單獨將應用程式套件或應用程式套件組合提交至合作夥伴中心，但建議您改為提交應用程式套件上傳檔案。

你可以在 Visual Studio 中使用 Create App Packages 精靈建立應用程式套件上傳檔案，或者從現有的應用程式套件或應用程式組合手動建立檔案。

備註

如果您想要手動建立應用程式套件 （.msix or.appx） 或應用程式套件組合 （.msixbundle 或 .appxbundle），請參閱 使用 MakeAppx.exe 工具建立應用程式套件。

使用 Visual Studio 建立你的應用程式套件上傳檔案

備註

以下說明與截圖描述了截至 Visual Studio 2019 16.3 版本的流程。 如果您使用舊版，某些UI看起來可能會不同。

  1. 在 方案總管，開啟你 UWP 應用程式專案的解決方案。

  2. 右鍵點擊專案，選擇 Publish->Create App Packages（在 2019 版本 16.3 Visual Studio之前，Publish選單名為 Store）。 如果此選項被停用或根本不出現，請檢查該專案是否為通用 Windows 專案。

    導覽至 [建立應用程式套件] 的操作功能表

    [建立應用程式套件] 精靈隨即出現。

  3. 在第一個對話框中選擇 Microsoft Store，並用新應用程式名稱，然後點選 Next。

    顯示為 Microsoft Store 的「建立您的套件」對話視窗

    如果您已經將專案與市集中的應用程式相關聯，您也可以選擇為相關聯的市集應用程式建立套件。 如果你選擇 Sideloading，Visual Studio 將不會產生用於合作夥伴中心提交的應用程式套件上傳檔案（.msixupload 或 .appxupload）。 如果您只想為非商店分發建立 MSIX 套件，則可以選擇此選項。

  4. 在下一個頁面上，使用您的開發人員帳戶登入合作夥伴中心。 如果您還沒有開發人員帳戶，精靈將協助您建立一個帳戶。

    [建立應用程式套件] 視窗，顯示選定的應用程式名稱

  5. 從目前註冊至您的帳戶的應用程式清單中選取套件的應用程式名稱，或如果您尚未在合作夥伴中心保留一個，請保留新的應用程式名稱。

    備註

    如果你使用 Visual Studio 2017，使用 Microsoft 帳戶（MSA）時，將無法列出目前註冊在你帳戶中的應用程式或保留新的應用程式名稱，只有 Microsoft Entra ID（AAD）帳號才會生效。 Visual Studio 2019 開始支援 MSA 帳號。

  6. 請務必在 [ 選取和設定套件 ] 對話框中選取所有三個架構組態 （x86、x64 和 ARM），以確保您的應用程式可以部署到最廣泛的裝置。 在 [ 產生應用程式套件組合 ] 列表框中，選取 [ 永遠]。 應用程式套件組合 （.appxbundle 或 .msixbundle） 優先於單一應用程式套件檔案，因為它包含針對每種處理器架構類型所設定的應用程式套件集合。 當您選擇產生應用程式套件組合時，應用程式套件組合將會包含在最終的應用程式套件上傳 （.appxupload 或 .msixupload） 檔案中，以及偵錯和當機分析資訊。 如果您不確定選擇哪些架構，或想要深入了解各種裝置所使用的架構，請參閱應用程式套件架構。

    [建立應用程式套件] 視窗，並顯示套件組態

  7. 在應用程式發佈之後，請在合作夥伴中心中包含公用符號檔案以進行應用程式效能分析。 設定任何其他詳細數據，例如版本編號或套件輸出位置。

  8. 按兩下 [建立] 以產生應用程式套件。 如果你在步驟 3 選擇了 I 想建立套件上傳到 Microsoft Store 選項，並且正在建立合作夥伴中心提交的套件，精靈會建立一個套件上傳檔案（.appxupload 或 .msixupload）。 如果您選取 [我想要在步驟 3 中建立用於側載的套件 ]，精靈會根據您在步驟 6 中的選取專案建立單一應用程式套件或應用程式套件組合。

  9. 成功封裝您的應用程式時，您會看到此對話方塊，而且您可以從指定的輸出位置擷取應用程式套件上傳檔案。 此時，您可以在 本機電腦或遠端電腦上驗證應用程式套件，並自動化商店提交。

    套件建立已完成視窗，顯示驗證選項

手動建立應用程式套件上傳檔案

  1. 將下列檔案放在資料夾中：

    • 一或多個應用程式套件 （.msix 或 .appx） 或應用程式套件組合 （.msixbundle 或 .appxbundle）。
    • .appxsym 檔案。 這是壓縮的 .pdb 檔案，其中包含用於合作夥伴中心 當機分析 的應用程式公用符號。 您可以省略此檔案，但如果您這麼做，您的應用程式將無法使用當機分析或偵錯資訊。

  2. 選取資料夾內的所有檔案，以滑鼠右鍵點擊這些檔案，然後選取 傳送至 ->壓縮 (zip) 資料夾。

  3. 將新 zip 檔案的擴展名名稱從 .zip 變更為 .msixupload 或 .appxupload。

驗證您的應用程式套件

先驗證您的應用程式，再將其提交至合作夥伴中心，以取得本機或遠端電腦上的認證。 您只能驗證應用程式套件的發行組建，而不是偵錯組建。 如需將應用程式提交至合作夥伴中心的詳細資訊，請參閱 應用程式提交。

在本機驗證您的應用程式套件

備註

Windows 應用程式 認證套件（WACK）已不再被支持維護，但你仍可選擇性地進行本地提交前檢查。 當您向合作夥伴中心提交套件時，正式認證會自動執行。 請參閱 應用程式提交。

  1. 在Create App Packages嚮導的最後一個Package Creation Completed頁面中，選擇Local machine選項，並點選Launch Windows 應用程式 Certification Kit。 欲了解更多關於使用 Windows 應用程式 認證套件測試應用程式的資訊，請參閱 Windows 應用程式 認證套件。

    Windows 應用程式 認證套件（WACK）會執行各種測試並回傳結果。 詳見Windows 應用程式認證套件測試以獲得更具體資訊。

    如果你有一台遠端的 Windows 10 裝置想用來測試，你需要手動安裝 Windows 應用程式 認證套件。 下一節將逐步引導您完成這些步驟。 完成後，你可以選擇 Remote machine，點選 Launch Windows 應用程式 Certification Kit 連接到遠端裝置並執行驗證測試。

  2. WACK 完成且您的應用程式已通過認證之後，您就可以將應用程式提交至合作夥伴中心。 請確定您上傳正確的檔案。 您可以在方案的根資料夾中找到檔案 \[AppName]\AppPackages 的預設位置，其結尾是 .appxupload 或 .msixupload 擴展名。 名稱的格式將為[AppName]_[AppVersion]_x86_x64_arm_bundle.appxupload或[AppName]_[AppVersion]_x86_x64_arm_bundle.msixupload，或者，如果您選擇包含所有套件架構的應用程式套件組合。

在遠端 Windows 10 裝置上驗證你的應用程式套件

  1. 請依照 啟用您的裝置以進行開發 的指示，啟用您的 Windows 10 裝置進行開發。

    這很重要

    你無法在遠端 ARM 裝置上驗證你的 Windows 10 應用程式套件。

  2. 下載並安裝 Visual Studio 的遠端工具。 這些工具用於遠端執行 Windows 應用程式 認證套件。 您可以造訪 遠端電腦上執行 MSIX 應用程式，以取得這些工具的詳細資訊，包括下載工具的位置。

  3. 下載所需的 Windows 應用程式 認證套件，然後安裝到您的遠端Windows 10裝置上。

  4. 在精靈的 [ 封裝建立已完成 ] 頁面上，選擇 [ 遠端計算機 ] 選項按鈕，然後選擇 [ 測試連線 ] 按鈕旁的省略號按鈕。

    備註

    只有在您選取至少一個支援驗證的解決方案組態時，才能使用 [遠端電腦 ] 選項按鈕。 如需更多關於使用 WACK 測試應用程式的資訊，請參閱 Windows 應用程式 認證套件。

  5. 在子網內指定裝置表單，或提供子網外部裝置的域名伺服器 （DNS） 名稱或IP位址。

  6. 在認證模式清單中，如果你的裝置不需要你用Windows憑證登入，請選擇None。

  7. 選擇 Select 按鈕，然後選擇 Launch Windows 應用程式 Certification Kit 按鈕。 如果遠端工具在該裝置上執行，Visual Studio 會連接到該裝置，然後執行驗證測試。 請參見Windows 應用程式認證套件測試。

自動化商店提交

備註

自 2026 Visual Studio 起，Automate Store submissions 功能不再支援。

從 Visual Studio 2019 開始，你可以直接從 IDE 選擇 在通過 Windows 應用程式 憑證套件驗證後自動提交到 Microsoft Store 選項，將產生的 .appxupload 檔案提交到 Microsoft Store，此選項位於 建立應用程式套件向導 的末尾。 此功能利用 Microsoft Entra ID 存取合作夥伴中心帳號資訊，以發布您的應用程式。 要使用此功能，您需要將 Microsoft Entra ID 與您的合作夥伴中心帳號關聯，並取得提交所需的多項憑證。

將 Microsoft Entra ID 與您的合作夥伴中心帳戶關聯

在擷取自動市集提交所需的認證之前，如果您尚未這麼做，您必須先遵循 合作夥伴中心儀錶板 中的這些步驟。

  1. 將您的合作夥伴中心帳戶與組織的Microsoft Entra ID關聯。 如果您的組織已經使用Microsoft的Office 365或其他商業服務，您已經擁有Azure AD。 否則，你可以在合作夥伴中心內免費建立新的 Azure AD 租戶。

  2. 將 Azure AD 應用程式加入你的合作夥伴中心帳戶。 這個 Azure AD 應用程式代表你將用來存取開發中心帳號提交的應用程式或服務。 您必須將此應用程式指派給 管理員 角色。 如果這個應用程式已經存在於你的 Azure AD 目錄中，你可以在 Add Azure AD 應用程式頁面選擇它，將它加入你的開發中心帳號。 否則，你可以在 Add Azure AD 應用程式頁面建立新的 Azure AD 應用程式。

擷取提交所需的憑證

接著，你可以取得提交所需的合作夥伴中心憑證：Azure 租戶 ID、Client ID 以及 Client 金鑰。

  1. 請到 Partner Center 儀表板，並用你的 Azure AD 憑證登入。

  2. 在合作夥伴中心儀錶板上，選取齒輪圖示（靠近儀錶板右上角），然後選取 [ 開發人員設定]。

  3. 在左窗格中的 [ 設定 ] 功能表中，按兩下 [ 使用者]。

  4. 點擊你 Azure AD 應用程式的名稱，進入該應用程式的設定。 在此頁面上，複製 租用戶 ID 和 用戶端 ID 值。

  5. 在 [ 金鑰] 區段中，按兩下 [ 新增金鑰]。 在下一個畫面上，複製對應至客戶端密碼的 [金鑰 ] 值。 離開此頁面之後，您將無法再次存取此資訊，因此請務必不要遺失此資訊。 欲了解更多資訊，請參閱 管理 Azure AD 應用程式的金鑰。

在 Visual Studio 中設定自動提交到應用程式商店

完成前述步驟後，你可以在 Visual Studio 2019 中設定自動商店提交。

  1. 在 建立應用程式封裝精靈 結束時，選擇 在 Windows 應用程式 Certification Kit 驗證後自動提交至 Microsoft Store，然後點選 重新配置。

  2. 在 配置Microsoft Store提交設定對話框中，輸入Azure租戶 ID、客戶端 ID 和客戶端金鑰。

    配置Microsoft Store投稿設定

    這很重要

    您的憑證可以儲存至您的個人資料，以便未來提交時使用。

  3. 按一下 [確定]。

提交會在 WACK 測試完成之後開始。 您可以在 [ 驗證] 和 [發佈 ] 視窗中追蹤提交進度。

驗證和發佈進度

  • Last updated on