AppCenterDistribute@1 - App Center の v1 タスクの配布

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

重要

このタスクは非推奨であり、2024 年 1 月 31 日に廃止される予定です。 AppCenterDistribute@3を使用 します。

構文

# App Center distribute v1
# Distribute app builds to testers and users via Visual Studio App Center.
- task: AppCenterDistribute@1
  inputs:
    serverEndpoint: # string. Required. App Center service connection. 
    appSlug: # string. Required. App slug. 
    appFile: # string. Alias: app. Required. Binary file path. 
    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.
    #distributionGroupId: # string. Alias: destinationId. Destination ID. 
  # Symbols
    #symbolsOption: 'Apple' # 'Apple'. Alias: symbolsType. Symbols type. Default: Apple.
    #symbolsPath: # string. Optional. Use when symbolsType == AndroidNative || symbolsType = Windows. Symbols path. 
    #symbolsPdbFiles: '**/*.pdb' # string. Alias: pdbPath. Optional. Use when symbolsType = UWP. Symbols path (*.pdb). Default: **/*.pdb.
    #symbolsDsymFiles: # string. Alias: dsymPath. Optional. Use when symbolsType = Apple. dSYM path. 
    #symbolsMappingTxtFile: # string. Alias: mappingTxtPath. Optional. Use when symbolsType = AndroidJava. Mapping file. 
    #symbolsIncludeParentDirectory: # boolean. Alias: packParentFolder. Include all items in parent folder.

入力

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

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

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

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

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

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

symbolsOption - シンボルの種類
入力エイリアス: symbolsType。 string. 使用できる値: Apple。 既定値: Apple。

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

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

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

symbolsPdbFiles - シンボル パス (*.pdb)
入力エイリアス: pdbPath。 string. 省略可能。 の場合は symbolsType = UWPを使用します。 既定値: **/*.pdb。

リポジトリ ルートからシンボル ファイルへの .pdb 相対パス。 パスには ワイルドカードを含めることがあります。

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

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

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

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

symbolsIncludeParentDirectory - 親フォルダーにすべてのアイテムを含める
入力エイリアス: packParentFolder。 boolean.

選択したシンボル ファイルまたはフォルダー、および同じ親フォルダー内の他のすべてのアイテムをアップロードします。 これは、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。 テスト担当者は自動的に更新を求められます。

distributionGroupId - 宛先 ID
入力エイリアス: destinationId。 string.

ビルド リリースを受け取る配布ストアまたはグループの ID。 既定のグループを使用するには、空のままにします。

タスク制御オプション

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

出力変数

[なし] :

解説

このタスクは非推奨とされます。 AppCenterDistribute@3を使用 します。

要件

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