共用方式為

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

  • 發行項

重要

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 文章：

開啟 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. 選取建立按鈕。