使用內嵌的應用程式安裝程式檔案來更新您的應用程式

重要

Windows 10.0.21300.0 版提供內嵌應用程式安裝程式檔案的使用。 若要使用這項功能，請確定 MaxVersionTested 參考這個或更新版本的 Windows 作業系統。

應用程式安裝程式檔案提供 Windows 應用程式可以周遊搜尋更新和修復的更新路徑。

當您使用 Visual Studio 建置和發佈具有內嵌應用程式安裝程式檔案的 Windows 應用程式時，您必須確定已安裝 Windows 10 SDK 2104 （或更新版本），且專案屬性具有 Windows 10 21H1（或更新版本）作為目標版本 （MaxVersionTested 和 MinVersion）。 如果未設定此設定，Windows 應用程式將不會在安裝 Windows 應用程式時，將內嵌的 AppInstaller 組態設定設定為裝置。

如何 - MSIX 封裝工具

下列步驟將引導您使用 MSIX 封裝工具來編輯預先存在的 Windows 應用程式，以包含內嵌的應用程式安裝程式應用程式。

注意

下列指引假設您先前已使用 Visual Studio 建立應用程式安裝程式檔案，以自動建立應用程式安裝程式檔案、使用 MSIX 工具組，或手動建立應用程式安裝程式檔案。 如需建立應用程式安裝程式檔案的指引，請流覽下列其中一篇 Docs 文章：

• 如何使用 Visual Studio 建立應用程式安裝程式檔案
• 如何手動建立應用程式安裝程序檔案

開啟 Windows 應用程式以進行編輯

下列步驟將引導您使用 Microsoft MSIX 封裝工具應用程式開始編輯 Windows 應用程式。

1. 啟動 Microsoft MSIX 封裝工具（可在 Microsoft Store： MSIX 封裝工具中取得）。
2. 選取 [ 套件編輯器] 按鈕以編輯現有的套件。
3. 選取 [ 瀏覽] 按鈕，然後在提示的視窗中找出您的 Windows 應用程式，然後選取 [ 開啟 ] 按鈕。
4. 選取 [ 開啟封裝] 按鈕。

將應用程式安裝程式檔案匯入 Windows 應用程式

下列步驟將引導您使用 Microsoft MSIX 封裝工具應用程式，將應用程式安裝程式檔案內嵌至預先存在的 Windows 應用程式。 這些步驟假設您已開啟 Windows 應用程式，以使用 Microsoft MSIX 封裝工具應用程式進行編輯。

1. 在 MSIX 封裝工具的左側，選取 [封裝檔案]。
2. 展開樹檢視內的 [ 封裝] 專案。
3. 以滑鼠右鍵按兩下 [ 套件 ]，然後從下拉功能表中選取 [新增檔案 ]。
4. 選取提示視窗內的 [瀏覽] 按鈕、流覽至並選取 [應用程式安裝程式] 檔案，然後選取 [開啟] 按鈕。
5. 選取儲存按鈕。

更新 AppxManifest

下列步驟將引導您更新 AppxManifest，以指向先前新增至 Windows 應用程式的 App Installer 檔案。

1. 在 MSIX 封裝工具的左側，選取 [封裝資訊]。
2. 捲動至 [套件資訊] 區段底部。
3. 選取 [開啟檔案] 按鈕，以在 記事本 視窗中開啟 AppxManifest。
4. <Package>請確定屬性包含下列命名空間和可忽略的命名空間：

   <Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
       xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
       xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
       xmlns:uap13="http://schemas.microsoft.com/appx/manifest/uap/windows10/13" 
       xmlns:build="http://schemas.microsoft.com/developer/appx/2015/build"
       IgnorableNamespaces="uap mp uap13 build">
   

5. 內部 <Properties> 包含下列 <uap13:AutoUpdate> 和子參數：

   <Properties>
       ...
       <uap13:AutoUpdate>
           <uap13:AppInstaller File="Update.appinstaller" />
       </uap13:AutoUpdate>
   </Properties>
   

6. 儲存您對 AppxManifest 所做的變更。
7. 關閉 AppxManifest 記事本 視窗，並返回 MSIX 封裝工具。

注意

上述指示假設應用程式安裝程式檔名為 「Update.appinstaller」。。

關閉並封裝 Windows 應用程式

下列步驟將引導您將 Windows 應用程式封裝為較新版本。 這些步驟假設您已設定簽署喜好設定，以符合您的組織或用戶端需求。

1. 在 MSIX 封裝工具中，選取 [儲存] 按鈕。
2. 在提示的視窗中，選取 [ 是]、[遞增 ] 按鈕。
3. 流覽至您想要將新更新的 Windows 應用程式儲存到何處，然後選取 [ 儲存 ] 按鈕。
4. 選取 [關閉] 按鈕。
5. 關閉 [MSIX 封裝工具] 視窗。

如何 - Visual Studio

開始之前，請確定您使用的是已安裝 Windows 10 SDK 2104 或更高版本的 Windows 10 裝置。 此 SDK 必須確定當您建置應用程式時，會使用適當的值來設定 [目標版本] 和 [最低版本] 屬性。

內嵌應用程式安裝程式檔案

下列步驟將引導您將應用程式安裝程式檔案內嵌至 Windows 應用程式 （UWP） Visual Studio 專案。

1. 在 Visual Studio 專案中，方案總管 以滑鼠右鍵按兩下 Windows 應用程式名稱。
2. 從下拉功能表中選取 [新增>>現有專案]。
3. 瀏覽至您的應用程式安裝程式檔案，選取它並選取 [ 新增 ] 按鈕。
4. 在 方案總管 中，按兩下 Update.appinstaller 以開啟檔案以供檢閱。
5. 確認應用程式安裝程式檔案正確無誤，並關閉檔案。

更新 AppxManifest

下列步驟將提供如何更新 Visual Studio 專案中 AppxManifest 以以新內嵌應用程式安裝程式檔案為目標的指引。

本指南假設：

• 已安裝 Windows 10 SDK 2104 或更高版本
• 專案屬性設定為以 Windows 10 版本 2104 或更高版本為目標。
• 應用程式安裝程式檔案的名稱為 Update.appinstaller

1. 在您的 Visual Studio 專案中，從頂端功能表中選取 [建置 ]。
2. 從下拉功能表中選取 [建置方案 ]。 請確定 Windows 應用程式組建成功。
3. 從功能區選取 [ 本機計算機 ]，以測試 Windows 應用程式的功能。
4. 啟動后不久關閉 Windows 應用程式，並停止偵錯。
5. 在 方案總管 中，以滑鼠右鍵按兩下 Package.appxmanifest
6. 從下拉功能表中選取 [ 檢視程序代碼 ]。
7. <Package>請確定屬性包含下列命名空間和可忽略的命名空間：

   <Package xmlns="http://schemas.microsoft.com/appx/manifest/foundation/windows10"
       xmlns:mp="http://schemas.microsoft.com/appx/2014/phone/manifest"
       xmlns:uap="http://schemas.microsoft.com/appx/manifest/uap/windows10"
       xmlns:uap13="http://schemas.microsoft.com/appx/manifest/uap/windows10/13" 
       xmlns:build="http://schemas.microsoft.com/developer/appx/2015/build"
       IgnorableNamespaces="uap mp uap13 build">
   

8. 內部 <Properties> 包含下列 <uap13:AutoUpdate> 和子參數：

   <Properties>
       ...
       <uap13:AutoUpdate>
           <uap13:AppInstaller File="Update.appinstaller" />
       </uap13:AutoUpdate>
   </Properties>
   

9. 將變更儲存至檔案，然後關閉。

建置 Windows 應用程式

下列步驟將引導您建立 Windows 應用程式套件，以在支援的作業系統上安裝。

1. 在您的 Visual Studio 專案中，以滑鼠右鍵按下 Windows 應用程式名稱。
2. 從下拉功能表中選取 [發佈>>建立應用程式套件...]。
3. 在 [建立應用程式套件] 對話框視窗中，選取 [側載] 單選按鈕。
4. 選取下一步按鈕。
5. 選取 [ 是]，使用目前的憑證： 單選按鈕。
6. 匯入現有的憑證，或自動產生憑證來簽署您的 Windows 應用程式。
7. 選取下一步按鈕。
8. 指定 Windows 應用程式套件組合的解決方案組態、版本和選擇性組建。
9. 選取建立按鈕。