MSIX 封裝延伸模組

「MSIX 封裝」延伸模組是一種 Azure DevOps 延伸模組，有助於使用 MSIX 套件格式來建置、封裝及簽署 Windows 應用程式。

CI/CD 工作流程已成為開發程序不可或缺的一部分，可提升效率和品質，同時降低成本和上市時間。 Microsoft 的 CI/CD 解決方案 Azure DevOps Pipelines 被廣泛採用且廣受歡迎，但目前整合建置和部署工作流程的程式，適用於需要封裝為 MSIX 到 Azure Pipelines 的應用程式，特別適用於不是 Azure Pipelines 或 MSIX 專家的人員。 此 Azure DevOps 擴充功能提供簡單且直覺的解決方案，可讓您更輕鬆地針對封裝為 MSIX 的應用程式，以及使用現有 CI/CD 工作流程的應用程式，輕鬆地移至 MSIX，而不會中斷其建置和部署機制。

「MSIX 封裝」延伸模組包含下列工作，可讓您根據需求自訂建置您的管線：

1. MSIX 組建和套件 - 使用 MSIX 套件格式建置和封裝 Windows 應用程式
2. MSIX 套件簽署 - 使用受信任的憑證簽署 MSIX 套件
3. MSIX 的應用程式安裝程式- 建立或更新 MSIX 應用程式的 .appinstaller file 檔案
4. 建立 MSIX 應用程式連結的套件 - 建立 MSIX 應用程式連結的 VHDX 套件

安裝延伸模組

瀏覽 Azure DevOps Marketplace 並尋找延伸模組名稱「MSIX 封裝」延伸模組。

建立管線

為 Azure DevOps 專案建立新管線。

選取此選項以「使用傳統編輯器來建立管線，而不需使用 YAML」。

選取您的版本控制系統，並提供您的存放庫和預設分支詳細資料。

當系統要求您選取範本時，按兩下 [從空白作業開始]。

將代理 程式規格 選項變更為 windows-2019 ，因為 MSIX 擴充功能只在 Windows 代理程式上執行。

根據預設，您應該會在 管線中看到 Agent 作業 1 。 按一下加號，「將工作新增至代理程式作業 1」。

在 [新增工作] 搜尋列中搜尋 MSIX，您應該會在 MSIX 封裝延伸模組中看到之前所述的工作。 您可以根據本身需求來新增所需的工作，以自訂建置您的管線。 但是，我們將示範如何設定此頁面上的所有四個工作。

MSIX 組建和套件

注意：如果您嘗試使用此工作建置已封裝的應用程式，則必須 包含 Windows 應用程式封裝專案，因為工作需要 Package.appxmanifest 檔案。 工作不會自動為您新增。

YAML

以下是示範如何在 yaml 檔案中設定建置和封裝工作的範例：

steps:
- task: MSIX.msix-ci-automation-task-dev.msix-packaging.MsixPackaging@1
  displayName: 'MSIX build and package'
  inputs:
    outputPath: '$(Build.ArtifactStagingDirectory)\MyApp.msix'
    solution: MyUWPApp.sln
    buildPlatform: x64
    updateAppVersion: true
    manifestFile: MyUWPApp/Package.appxmanifest
    appVersion: 2.0.0.0
    appPackageDistributionMode: SideloadOnly
    msbuildArchitecture: x64

UI

• 顯示名稱 - 自訂您的工作名稱
• 輸出路徑 - 指定此工作將建立之 MSIX 套件的輸出路徑。 上述範例中的路徑會使用 預先定義的變數Build.ArtifactStagingDirectory ，這是代理程式上用來儲存成品的本機路徑，並在這裡用來儲存工作輸出檔案，稍後可以使用發佈成品工作發佈。
• 使用 MSBuild 建置解決方案 - 選取此選項，以針對指定的目標平台，使用 msbuild 建置解決方案。 如果您已經有只需要封裝的二進位檔，請將此方塊保持未核取狀態。 如果將此方塊保持未核取狀態，則系統會要求您提供二進位檔的路徑。
• 要建立的專案 - 提供需要建立之專案或解決方案檔的路徑。
• 建立前清理 - 如果您想要工作在建立前執行乾淨的組建，請選取此核取方塊。
• 產生 MSIX 套件組合 - 選取此核取方塊可產生 MSIX 套件組合，而不是套件。 請務必在 [輸出路徑] 選項中，使用 .msixbundle 副檔名 (而不是 .msix) 來命名輸出檔案。
• 設定 - 在 [偵錯] 和 [發行] 組建設定之間做選擇。
• 平台 -指定目標組建平台，例如，[x64]、[x86]、[任何 CPU]。
• 更新資訊清單中的應用程式版本 - 選取此核取方塊，將應用程式版本從應用程式的 .appxmanifest 檔案中指定的版本進行變更。 這不會覆寫 .appxmanifest 檔案，但是會變更所產生輸出 MSIX 套件中的應用程式版本。 若已選取此選項，系統會要求您提供資訊清單檔案的路徑，以及為應用程式設定的應用程式版本號碼。
• 應用程式套件散發模式 - 從下拉式功能表中選取模式，以產生 Store 應用程式套件或非 Store 應用程式套件。
• MSBuild 版本和架構 - 藉由指定進階選項來自定義 MSBuild。

MSIX 套件簽署

簽署工作允許使用憑證進行簽署。 憑證可以來自安全檔案庫，或編碼為字串，就像使用 Azure 金鑰保存庫 工作擷取一樣。

YAML

以下範例示範如何在 yaml 檔案中設定套件簽署工作：

steps:
- task: MSIX.msix-ci-automation-task-dev.msix-signing.MsixSigning@1
  displayName: 'Sign MSIX package'
  inputs:
    certificateType: base64
    encodedCertificate: '$(kvtestcert)'

UI

當憑證的來源是安全檔案庫時，此範例會顯示工作。

此範例顯示憑證來源為 Azure 金鑰保存庫 時的工作。

• 顯示名稱 - 自訂您的工作名稱
• 要簽署的套件- MSIX 套件簽署工作會使用 SignTool 來簽署符合此路徑的所有檔案 (不論其為 MSIX 套件或套件組合)。
• 憑證檔類型 - 選取要使用的憑證檔案來源。
• 時間戳記伺服器 - 指定時間戳記伺服器位址的 URL。 這是選擇性參數。

MSIX 的應用程式安裝程式檔案

YAML

以下範例示範如何在 yaml 檔案中設定 AppInstaller 檔案工作：

steps:
- task: MSIX.msix-ci-automation-task-dev.app-installer-file.AppInstallerFile@1
  displayName: 'Create App Installer file'
  inputs:
    package: '$(Build.ArtifactStagingDirectory)\MyApp.msix'
    outputPath: '$(Build.ArtifactStagingDirectory)\MyApp.appinstaller'
    uri: 'https://myuwpapp-demo.azurewebsites.net/MyApp.appinstaller'
    mainItemUri: 'https://myuwpapp-demo.azurewebsites.net/MyApp.msix'
    showPromptWhenUpdating: true
    updateBlocksActivation: true

UI

• 顯示名稱 - 自訂您的工作名稱
• 套件 - 這是您想要為套件或套件組合建立應用程式安裝程式的路徑。
• 輸出檔案路徑 - 這是要寫入的應用程式安裝程式檔案的路徑。
• 建立應用程式安裝程式檔案的方法 - 選擇是否要建立新的應用程式安裝程式檔案，或更新現有檔案。 如果您選擇更新現有檔案，則系統會要求您提供現有應用程式安裝程式檔案的路徑。
• 應用程式安裝程式檔案的版本 - 將提供的版本號碼。 必須採用 (major).(minor).(build).(revision) 形式。
• URI - 已重新導向應用程式安裝程式檔案的 Web URI。
• 主要套件/套件組合 URI - 應用程式套件/套件組合位置的 URI。
• 啟動時更新 - 選取此選項可將應用程式設定為在啟動時檢查更新。 若已選取此核取方塊，系統會要求您提供詳細資料，例如「更新檢查之間的時數」、是否「在更新時對使用者顯示 UI」，以及是否要「更新封鎖應用程式啟用」。

建立 MSIX 應用程式連結的套件

YAML

以下範例示範如何設定工作，以在 yaml 檔案中建立應用程式附加的 VHDX 檔案：

steps:
- task: MSIX.msix-ci-automation-task-dev.msix-app-attach.MsixAppAttach@1
  displayName: 'Create package for MSIX app attach'
  inputs:
    package: '$(Build.ArtifactStagingDirectory)\MyApp.msix'
    vhdxOutputPath: '$(Build.ArtifactStagingDirectory)\MyApp.vhdx'

UI

• 顯示名稱 - 自訂您的工作名稱。
• 套件路徑 - 這是 MSIX 套件/套件組合的路徑。
• VHDX 輸出路徑 - 這是工作將建立的 VHDX 檔案的路徑。
• VHDX 大小 - VHDX 的大小上限 (以 MB 為單位)。

設定所有工作之後，您可以使用 [發佈組建成品] 工作，將所有成品從暫存位置卸載至 Azure Pipelines 成品或您選擇的檔案共用。

將 MSIX 應用程式附加套件發佈至 AVD

YAML

以下範例示範如何在 yaml 檔案中設定 avd 應用程式附加工作：

steps:
- task: MSIX.msix-ci-automation-task-dev.avd-app-attach-publish.AVDAppAttachPublish@0
  displayName: 'Publish MSIX app attach package to AVD'
  inputs:
    vhdxPath: '$(Build.ArtifactStagingDirectory)/App.vhdx' 
    connectedServiceNameARM: 'ed1db943-1e1c-4eac-8683-ead2abc281b5' 
    resourceGroupName: 'appattach-test-rg' 
    storageAccount: 'appattachteststorage' 
    fileShare: 'appattach-test-fs' 
    hostPool: 'appattach-hostpool' 
    workSpace: 'appattach-test-ws' 
    applicationGroup: 'appattach-test-ag-rail' 

UI

• 顯示名稱 - 自訂您的工作名稱。

• 套件路徑 - 這是 MSIX 套件/套件組合的路徑。

• VHDX 輸出路徑 - 這是工作將建立的 VHDX 檔案的路徑。

• VHDX 大小 - VHDX 的大小上限 (以 MB 為單位)。

• 顯示名稱 - 自訂您的工作名稱。

• VHDX 路徑 - 這是將應用程式連結（發佈）至 Azure 虛擬桌面的 VHDX 檔案路徑（AVD）。

• Azure 訂 用帳戶 - 這是應用程式必須鏈接的目標 Azure 訂用帳戶的服務連線。 下拉式清單會列出目前 ADO 登入使用者可用的所有 Azure 訂用帳戶，用戶可以選取其中任何一項，並建立其服務連線。

• 資源群組 - 選擇應用程式需要發佈的資源群組。 此資源群組應包含應用程序連結所需的所有目標資源，例如記憶體帳戶、主機集區、工作區、應用程式群組。 此下拉式清單會列出所選 Azure 訂用帳戶下可用的所有資源群組。

• 儲存體 帳戶 - 選擇要上傳您應用程式 （或 VHDX） 的記憶體帳戶。 此下拉式清單會列出所選資源群組下所有可用的記憶體帳戶。

• 檔案分享 - 選擇要上傳應用程式 （或 VHDX） 之所選記憶體帳戶中的檔案共用。 此下拉式清單會列出所選記憶體帳戶下所有可用的檔案共用。

• 主機集區 - 選擇要用於附加應用程式的主機集區。 此下拉式清單會列出所選資源群組下所有可用的主機集區。

• 工作區 - 選擇要用於附加應用程式的工作區。 此下拉式清單會列出所選資源群組下所有可用的工作區。

• 應用程式群組 - 選擇要用於附加應用程式的應用程式群組。 此下拉式清單會列出所選資源群組下所有可用的應用程式群組。

設定所有工作之後，您可以使用 [發佈組建成品] 工作，將所有成品從暫存位置卸載至 Azure Pipelines 成品或您選擇的檔案共用。

提供意見反應的方式

我們很樂意聽到您對 [MSIX 封裝] 延伸模組的意見反應。 請透過下列管道與我們聯繫：

• 在 Azure DevOps Marketplace 上檢閱延伸模組
• MSIX 技術社群
• GitHub 開放原始碼專案 - 此延伸模組的原始程式碼屬於 MSIX SDK 開放原始碼專案的一部分，歡迎投稿與提供建議。