MSIX 封裝延伸模組

以下是示範如何在 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

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

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

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

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

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

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

以下範例示範如何在 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

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

以下範例示範如何設定工作，以在 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'

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

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

以下範例示範如何在 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' 

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

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

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

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

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

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

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

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

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

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

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

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

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

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