AppCenterDistribute@3 - App Center の v3 タスクの配布

このタスクを使用して、Visual Studio App Center を介してテスト担当者とユーザーにアプリ ビルドを配布します。

構文

# App Center distribute v3
# Distribute app builds to testers and users via Visual Studio App Center.
- task: AppCenterDistribute@3
  inputs:
    serverEndpoint: # string. Required. App Center service connection. 
    appSlug: # string. Required. App slug. 
    appFile: # string. Alias: app. Required. Binary file path. 
    #buildVersion: # string. Build version. 
    releaseNotesOption: 'input' # 'input' | 'file'. Alias: releaseNotesSelection. Required. Create release notes. Default: input.
    releaseNotesInput: # string. Required when releaseNotesSelection = input. Release notes. 
    #releaseNotesFile: # string. Required when releaseNotesSelection = file. Release notes file. 
    #isMandatory: false # boolean. Require users to update to this release. Default: false.
    destinationType: 'groups' # 'groups' | 'store'. Required. Release destination. Default: groups.
    #distributionGroupId: # string. Alias: destinationGroupIds. Optional. Use when destinationType = groups. Destination IDs. 
    #destinationStoreId: # string. Required when destinationType = store. Destination ID. 
    #isSilent: # boolean. Optional. Use when destinationType = groups. Do not notify testers. Release will still be available to install. 
  # Symbols
    #symbolsOption: 'Apple' # 'Apple' | 'Android' | 'UWP'. Alias: symbolsType. Symbols type. Default: Apple.
    #symbolsPath: # string. Optional. Use when symbolsType == AndroidNative || symbolsType = Windows. Symbols path. 
    #appxsymPath: # string. Optional. Use when symbolsType = UWP. Symbols path (*.appxsym). 
    #symbolsDsymFiles: # string. Alias: dsymPath. Optional. Use when symbolsType = Apple. dSYM path. 
    #symbolsMappingTxtFile: # string. Alias: mappingTxtPath. Optional. Use when symbolsType = Android. Mapping file. 
    #nativeLibrariesPath: # string. Optional. Use when symbolsType == Android. Native Library File Path. 
    #symbolsIncludeParentDirectory: # boolean. Alias: packParentFolder. Optional. Use when symbolsType = Apple. Include all items in parent folder.

入力

serverEndpoint - App Center サービス接続
string. 必須です。

Visual Studio App Center のサービス接続を選択します。 作成するには、リンクを Manage クリックし、新しいサービス接続を作成します。

appSlug - アプリ スラッグ
string. 必須です。

アプリ スラッグの形式 {username}/{app_identifier}は です。 アプリの と {app_identifier} を見つけるには{username}、App Center からその名前をクリックすると、結果の URL は のhttps://appcenter.ms/users/**{username}**/apps/**{app_identifier}**形式になります。 組織を使用している場合、アプリスラッグの形式 {orgname}/{app_identifier}は です。

appFile - バイナリ ファイル パス
入力エイリアス: app。 string. 必須です。

リポジトリ ルートから、公開する APK/AAB または IPA ファイルへの相対パス。

buildVersion - ビルド バージョン
string.

と .msiに指定する必要があるアップロード バイナリの.zipビルド バージョン。 プラットフォームが WPF または WinForms でない限り、この値は無視されます。

symbolsOption - シンボルの種類
入力エイリアス: symbolsType。 string. 許可値: Apple、Android、UWP。 既定値: Apple。

App Center Diagnostics でシンボル化されたスタック トレースを受信するシンボル ファイルが含まれています。

symbolsPath - シンボル パス
string. 省略可能。 の場合は symbolsType == AndroidNative || symbolsType = Windowsを使用します。

リポジトリ ルートから symbols フォルダーへの相対パス。

appxsymPath - シンボル パス (*.appxsym)
string. 省略可能。 の場合は symbolsType = UWPを使用します。

APPXSYM シンボル ファイルへの相対パス。 パスには ワイルドカードを含めることがあります。

symbolsDsymFiles - dSYM パス
入力エイリアス: dsymPath。 string. 省略可能。 の場合は symbolsType = Appleを使用します。

リポジトリ ルートから dSYM フォルダーへの相対パス。 パスには ワイルドカードを含めることがあります。

symbolsMappingTxtFile - マッピング ファイル
入力エイリアス: mappingTxtPath。 string. 省略可能。 の場合は symbolsType = Androidを使用します。

リポジトリ ルートから Android の mapping.txt ファイルへの相対パス。

nativeLibrariesPath - ネイティブ ライブラリ のファイル パス
string. 省略可能。 の場合は symbolsType == Androidを使用します。

リポジトリ ルートから発行する追加のネイティブ ライブラリ (.so ファイルなど) への相対パス。

symbolsIncludeParentDirectory - 親フォルダーにすべてのアイテムを含める
入力エイリアス: packParentFolder。 boolean. 省略可能。 の場合は symbolsType = Appleを使用します。

選択したシンボル ファイルまたはフォルダー、および同じ親フォルダー内の他のすべてのアイテムをアップロードします。 これは、React Native アプリに必要です。

releaseNotesOption - リリース ノートを作成する
入力エイリアス: releaseNotesSelection。 string. 必須です。 使用できる値: input (「リリース ノート」と入力します file )。([リリース ノート ファイル] を選択します)。 既定値: input。

リリース ノートはリリースに添付され、インストール ページのテスト担当者に表示されます。

releaseNotesInput - リリース ノート
string. releaseNotesSelection = input の場合に必要です。

このバージョンのリリース ノート。

releaseNotesFile - リリース ノート ファイル
string. releaseNotesSelection = file の場合に必要です。

このバージョンのリリース ノートを含む UTF-8 でエンコードされたテキスト ファイルを選択します。

isMandatory - ユーザーにこのリリースへの更新を要求する
boolean. 既定値: false。

更新を要求するために必要な App Center Distribute SDK。 テスト担当者は自動的に更新を求められます。

destinationType - リリース先
string. 必須です。 使用できる値: groups、store。 既定値: groups。

各リリースは、グループまたはストアのいずれかに配布されます。

distributionGroupId - 宛先 ID
入力エイリアス: destinationGroupIds。 string. 省略可能。 の場合は destinationType = groupsを使用します。

ビルド リリースを受け取る配布グループの ID。 既定のグループを使用するには空のままにし、複数の ID を区切るにはコンマまたはセミコロンを使用します。

destinationStoreId - 宛先 ID
string. destinationType = store の場合に必要です。

ビルド リリースを受け取る配布ストアの ID。

isSilent - テスト担当者に通知しないでください。リリースは引き続きインストールできます。
boolean. 省略可能。 の場合は destinationType = groupsを使用します。

テスト担当者は、新しいリリースの電子メールを受信しません。

タスク制御オプション

すべてのタスクには、タスク入力に加えて制御オプションがあります。 詳細については、「 コントロール オプションと一般的なタスク プロパティ」を参照してください。

出力変数

[なし] :

解説

このタスクを使用して、App Center を通じてテスト担当者とユーザーにアプリ ビルドを配布します。

• 最初にApp Center にサインアップします。
• このタスクの使用の詳細については、App Center のドキュメント記事「Deploy Azure DevOps Builds with App Center」を参照してください。

例

このパイプライン例では、Android アプリをビルドし、テストを実行し、App Center Distribute を使用してアプリを発行します。

# Android
# Build your Android project with Gradle.
# Add steps that test, sign, and distribute the APK, save build artifacts, and more:
# https://learn.microsoft.com/azure/devops/pipelines/ecosystems/android

pool:
  vmImage: 'macOS-latest'
steps:

- script: sudo npm install -g appcenter-cli
- script: appcenter login --token {YOUR_TOKEN}

- task: Gradle@2
  inputs:
    workingDirectory: ''
    gradleWrapperFile: 'gradlew'
    gradleOptions: '-Xmx3072m'
    publishJUnitResults: false
    testResultsFiles: '**/TEST-*.xml'
    tasks: build

- task: CopyFiles@2
  inputs:
    contents: '**/*.apk'
    targetFolder: '$(build.artifactStagingDirectory)'

- task: PublishBuildArtifacts@1
  inputs:
    pathToPublish: '$(build.artifactStagingDirectory)'
    artifactName: 'outputs'
    artifactType: 'container'

# Run tests using the App Center CLI
- script: appcenter test run espresso --app "{APP_CENTER_SLUG}" --devices "{DEVICE}" --app-path {APP_FILE} --test-series "master" --locale "en_US" --build-dir {PAT_ESPRESSO} --debug

# Distribute the app
- task: AppCenterDistribute@3
  inputs:
    serverEndpoint: 'AppCenter'
    appSlug: '$(APP_CENTER_SLUG)'
    appFile: '$(APP_FILE)' # Relative path from the repo root to the APK or IPA file you want to publish
    symbolsOption: 'Android'
    releaseNotesOption: 'input'
    releaseNotesInput: 'Here are the release notes for this version.'
    destinationType: 'groups'

要件

要件	説明
パイプラインの種類	YAML、クラシック ビルド、クラシック リリース
実行日	エージェント、DeploymentGroup
確認要求	なし
Capabilities	このタスクは、ジョブ内の後続のタスクに対する要求を満たしていません。
コマンドの制限	Any
設定可能な変数	Any
エージェントのバージョン	2.206.1 以降
タスクのカテゴリ	デプロイ