MSIX パッケージ拡張機能

"MSIX パッケージ" 拡張機能は、MSIX パッケージ形式を使用した Windows アプリのビルド、パッケージ化、および署名に利用できる Azure DevOps の拡張機能です。

CI/CD ワークフローは、市場投入までのコストと時間を短縮しつつ効率性と品質を向上させるために、開発プロセスに欠かせない要素になっています。 Microsoft の CI/CD ソリューション Azure DevOps パイプラインは広く採用され普及していますが、アプリのビルドと展開のワークフローを統合する現在のプロセスは、MSIX として Azure Pipelines にパッケージ化する必要があり、特に Azure Pipelines または MSIX の専門家以外の人にとっては面倒です。 この Azure DevOps 拡張機能によって、簡単かつ直感的なソリューションが提供されます。これにより、MSIX としてパッケージ化されているアプリや既存の CI/CD ワークフローを利用するアプリのビルドと展開のプロセスをより簡単に自動化して、ビルドと展開のメカニズムを損なうことなく MSIX に移行することができます。

"MSIX パッケージ" 拡張機能には、要件に応じてパイプラインをカスタム ビルドする際に使用できる次のタスクが含まれています。

1. MSIX のビルドおよびパッケージ - MSIX パッケージ形式を使用して Windows アプリをビルドしてパッケージ化する
2. MSIX パッケージ署名 - 信頼された証明書を使用して MSIX パッケージに署名する
3. MSIX 用のアプリ インストーラー ファイル - MSIX アプリの .appinstaller ファイルを作成または更新する
4. MSIX アプリのアタッチ用にパッケージを作成する - MSIX アプリのアタッチ用に VHDX パッケージを作成する

拡張機能をインストールする

Azure DevOps Marketplace を参照し、拡張機能の名前 "MSIX パッケージ" 拡張機能を探します。

パイプラインを作成する

Azure DevOps プロジェクトの新しいパイプラインを作成します。

[Use the classic editor to create a pipeline without YAML]\(クラシック エディターを使用して YAML なしでパイプラインを作成する\) のオプションを選択します。

バージョン管理システムを選択して、リポジトリと既定のブランチの詳細を指定します。

[テンプレートの選択] を求められた場合には、[start with an Empty job]\(空のジョブから始めます\) をクリックします。

MSIX 拡張機能は Windows エージェント上でのみ実行されるため、[エージェントの指定] の選択を windows-2019 に変更します。

既定では、パイプラインに [Agent job 1] が表示されます。 プラス記号をクリックして、"Agent job 1 にタスクを追加" します。

[タスクの追加] 検索バーで MSIX を検索すると、"MSIX パッケージ" 拡張機能に前述したタスクが表示されます。 要件に応じて、必要なタスクを追加することによって、パイプラインをカスタム ビルドできます。 ただし、このページでは、4 つのすべてのタスクの構成方法について説明します。

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 が使用されています。これは、成果物を格納するためのエージェント上のローカル パスです。ここでは、成果物の発行タスクを使用して後から発行できるタスク出力ファイルを格納する目的で、使用されています。
• [Build Solution with MSBuild]\(MSBuild によるソリューションのビルド\) - 特定のターゲット プラットフォームに対して msbuild を指定してソリューションをビルドする場合には、このオプションを選択します。 単にパッケージ化だけが必要なバイナリが既にある場合には、このチェック ボックスをオフのままにします。 チェック ボックスをオフのままにすると、バイナリのパスを指定するように求められます。
• [Project to Build]\(ビルドするプロジェクト\) - ビルドする必要があるプロジェクトまたはソリューション ファイルのパスを指定します。
• [Clean before Building]\(ビルド前にクリーンする\) - タスクにおいてビルド前にクリーン ビルドを実行する場合には、このチェック ボックスをオンにします。
• [Generate MSIX Bundle]\(MSIX バンドルを生成する\) - パッケージではなく MSIX バンドルを生成するには、このチェック ボックスをオンにします。 出力ファイルには必ず、.msix ではなく .msixbundle の拡張子を含めて [出力パス] オプションを指定してください。
• [構成] - [デバッグ] および [リリース] からビルド構成を選択します。
• [プラットフォーム] - たとえば x64、x86、"任意の CPU" のように、ターゲットのビルド プラットフォームを指定します。
• [Update App Version in Manifest]\(マニフェストのアプリ バージョンを更新する\) - アプリの .appxmanifest ファイルで指定されたアプリ バージョンから変更する場合には、このチェック ボックスをオンにします。 これにより .appxmanifest ファイルは上書きされずに、生成される出力 MSIX パッケージのアプリ バージョンが変更されます。 このオプションを選択した場合、マニフェスト ファイルのパスと、アプリに設定するためのアプリ バージョン番号を指定するように求められます。
• [Application Package Distribution Mode]\(アプリケーション パッケージの配布モード\) - ストア アプリ パッケージまたは非ストア アプリ パッケージを生成する場合には、ドロップダウン メニューからこのモードを選択します。
• [MSBuild Version and Architecture]\(Msbuild のバージョンとアーキテクチャ\) - 詳細オプションを指定して MSBuild をカスタマイズします。

MSIX パッケージの署名

署名タスクを使用すると、証明書を使用して署名することができます。 証明書は、セキュリティで保護されたファイル ライブラリから取得することも、Azure Key Vault タスクでフェッチする場合と同様に文字列としてエンコードすることもできます。

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 Key Vault である場合のタスクを示しています。

• [表示名] - タスク名をカスタマイズします
• [Package to sign]\(署名するパッケージ\) - 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

• [表示名] - タスク名をカスタマイズします
• [パッケージ] - これは、アプリ インストーラーを作成する対象のパッケージまたはバンドルのパスです。
• [Output File Path]\(出力ファイル パス\) - これは、書き込まれるアプリ インストーラー ファイルのパスです。
• [Method to Create App Installer File]\(アプリ インストーラー ファイルを作成する方法\) - 新しいアプリ インストーラー ファイルを作成するか、既存のものを更新するかを選択します。 既存のものを更新することを選んだ場合は、既存のアプリ インストーラー ファイルのパスを指定するように求められます。
• [Version for App Installer file]\(アプリ インストーラー ファイルのバージョン\) - 指定されるバージョン番号。 (major).(minor).(build).(revision) の形式にする必要があります。
• [URI] - リダイレクトされたアプリ インストーラー ファイルの Web URI。
• [Main Package/Bundle URI]\(メイン パッケージ/バンドル URI\) - アプリ パッケージ/バンドルの場所の URI。
• [Update On Launch]\(起動時に更新する\) - アプリが起動されたときに更新プログラムを確認するように設定するには、このチェック ボックスをオンにします。 このチェック ボックスをオンにすると、"更新プログラムの確認の間隔"、"更新時にユーザーに 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 Output Path]\(VHDX 出力パス\) - これは、タスクによって作成される VHDX ファイルのパスです。
• [VHDX size]\(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 Output Path]\(VHDX 出力パス\) - これは、タスクによって作成される VHDX ファイルのパスです。

• [VHDX size]\(VHDX のサイズ\) - VHDX の最大サイズ (MB 単位)。

• [表示名] - タスク名をカスタマイズします。

• VHDX パス - これは、Azure Virtual Desktop (AVD) にアプリ アタッチ (発行) される VHDX ファイルのパスです。

• Azure サブスクリプション - これは、アプリケーションをアプリ アタッチする必要がある Azure サブスクリプションをターゲットとするサービス接続です。 ドロップダウンには、現在の ADO ログイン ユーザーが使用できるすべての Azure サブスクリプションが一覧表示され、ユーザーはこれらのいずれかを選択して、そのサブスクリプションに対するサービス接続を確立できます。

• リソース グループ - アプリを発行する必要があるリソース グループを選択します。 このリソース グループには、ストレージ アカウント、ホスト プール、ワークスペース、アプリケーション グループなど、アプリ アタッチに必要なすべてのターゲット リソースが含まれている必要があります。 このドロップダウンには、選択した Azure サブスクリプションで使用可能なすべてのリソース グループが一覧表示されます。

• ストレージ アカウント - アプリケーション (または VHDX) のアップロード先のストレージ アカウントを選択します。 このドロップダウンには、選択したリソース グループで使用可能なすべてのストレージ アカウントが一覧表示されます。

• ファイル共有 - アプリケーション (または VHDX) のアップロード先とする、選択したストレージ アカウント内のファイル共有を選択します。 このドロップダウンには、選択したストレージ アカウントで使用可能なすべてのファイル共有が一覧表示されます。

• ホスト プール - アプリケーションをアプリ アタッチするために使用するホスト プールを選択します。 このドロップダウンには、選択したリソース グループで使用可能なすべてのホスト プールが一覧表示されます。

• ワークスペース - アプリケーションをアプリ アタッチするために使用するワークスペースを選択します。 このドロップダウンには、選択したリソース グループで使用可能なすべてのワークスペースが一覧表示されます。

• アプリケーション グループ - アプリケーションをアプリ アタッチするために使用するアプリケーション グループを選択します。 このドロップダウンには、選択したリソース グループで使用可能なすべてのアプリケーション グループが一覧表示されます。

すべてのタスクを構成した後、[ビルド成果物の発行] タスクを使用して、一時保管場所にあるすべての成果物を Azure Pipelines の成果物または選択したファイル共有にドロップします。

フィードバックの提供方法

"MSIX パッケージ" 拡張機能についてのフィードバックをお寄せください。 次のチャネルを通じてご連絡ください。

• Azure DevOps Marketplace で拡張機能を確認する
• MSIX Tech Community
• GitHub オープンソースプロジェクト - この拡張機能のソース コードは MSIX SDK オープン ソース プロジェクトの一部であり、投稿と提案を積極的に受け入れています。