AppCenterDistribute@1 - App Center 散發 v1 工作

使用此工作，透過 App Center 和 Visual Studio App Center 將應用程式組建散發給測試人員和使用者。

重要

此工作已被取代，且將于 2024 年 1 月 31 日淘汰。 使用 AppCenterDistribute@3。

Syntax

# 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 - 應用程式 slug
string. 必要。

應用程式 slug 的格式 {username}/{app_identifier} 為 。 若要尋找 {username} 應用程式，請 {app_identifier} 從 App Center按一下其名稱。 產生的 URL 格式 https://appcenter.ms/users/**{username}**/apps/**{app_identifier}** 為 。 如果您使用組織，應用程式 slug 的格式 {orgname}/{app_identifier} 為 。

appFile - 二進位檔案路徑
輸入別名： app 。 string. 必要。

從存放庫根目錄到您要發佈的 APK 或 IPA 檔案的相對路徑。

symbolsOption - 符號類型
輸入別名： symbolsType 。 string. 允許的值： Apple 。 預設值：Apple。

包含符號檔，可接收 App Center 診斷中的符號堆疊追蹤。

symbolsPath - 符號路徑
string. 選擇性。 使用 時 symbolsType == AndroidNative || symbolsType = Windows 。

從存放庫根目錄到符號資料夾的相對路徑。

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 散發 SDK。 系統會自動提示測試人員更新。

distributionGroupId - 目的地識別碼
輸入別名： destinationId 。 string.

將接收組建版本的散發套件存放區或群組的識別碼。 將它保留空白，以使用預設群組。

工作控制選項

除了工作輸入之外，所有工作都有控制選項。 如需詳細資訊，請參閱 控制選項和一般工作屬性。

輸出變數

無。

備註

此工作已被取代。 使用 AppCenterDistribute@3。

規格需求

需求	描述
管線類型	YAML、傳統組建、傳統版本
在 上執行	Agent、DeploymentGroup
要求	無
Capabilities	此工作不符合作業中後續工作的任何需求。
命令限制	任何
可設定變數	任何
代理程式版本	2.144.0 或更新版本
工作類別	部署