AppCenterDistribute@1 - App Center 分发 v1 任务

使用此任务通过 App Center 和 Visual Studio App Center 将应用版本分发给测试人员和用户。

重要

此任务已弃用,将于 2024 年 1 月 31 日停用。 使用 AppCenterDistribute@3

使用此任务通过 App Center 和 Visual Studio App Center 将应用版本分发给测试人员和用户。

此任务已弃用;使用 AppCenterDistribute@3

使用此任务通过 App Center 和 Visual Studio App Center 将应用版本分发给测试人员和用户。

通过 App Center 将应用版本分发给测试人员和用户。

语法

# 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.
# App Center Distribute v1
# Distribute app builds to testers and users via 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. 
    #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 - 二进制文件路径
输入别名: appstring. 必需。

从存储库根目录到要发布的 APK 或 IPA 文件的相对路径。


symbolsOption - 符号类型
输入别名: symbolsTypestring. 允许的值: Apple。 默认值:Apple

包括用于在 App Center 诊断中接收符号化堆栈跟踪的符号文件。


symbolsPath - 符号路径
string. 可选。 在 时 symbolsType == AndroidNative || symbolsType = Windows使用 。

从存储库根目录到 symbols 文件夹的相对路径。


symbolsPdbFiles - 符号路径 (*.pdb)
输入别名: pdbPathstring. 可选。 在 时 symbolsType = UWP使用 。 默认值:**/*.pdb

从存储库根目录到 .pdb 符号文件的相对路径。 路径可能包含 通配符


symbolsDsymFiles - dSYM 路径
输入别名: dsymPathstring. 可选。 在 时 symbolsType = Apple使用 。

从存储库根目录到 dSYM 文件夹的相对路径。 路径可能包含 通配符


symbolsMappingTxtFile - 映射文件
输入别名: mappingTxtPathstring. 可选。 在 时 symbolsType = AndroidJava使用 。

从存储库根目录到 Android mapping.txt 文件的相对路径。


symbolsIncludeParentDirectory - 包括父文件夹中的所有项目
输入别名: packParentFolderboolean.

上传所选符号文件或文件夹以及同一父文件夹中的所有其他项目。 对于 React Native 应用,这是必需的。


releaseNotesOption - 创建发行说明
输入别名: releaseNotesSelectionstring. 必需。 允许的值: input (输入发行说明) , file (选择发行说明文件) 。 默认值:input

发行说明附加到版本,并在安装页上向测试人员显示。


releaseNotesInput - 发行说明
string. 当 releaseNotesSelection = input 时,需要此选项。

此版本的发行说明。


releaseNotesFile - 发行说明文件
string. 当 releaseNotesSelection = file 时,需要此选项。

选择包含此版本的发行说明的 UTF-8 编码文本文件。


isMandatory - 要求用户更新到此版本
boolean. 默认值:false

强制更新所需的 App Center 分发 SDK。 系统会自动提示测试人员进行更新。


distributionGroupId - 目标 ID
输入别名: destinationIdstring.

将接收生成版本的分发存储或组的 ID。 将其留空以使用默认组。


任务控制选项

除了任务输入,所有任务都有控制选项。 有关详细信息,请参阅 控制选项和常见任务属性

输出变量

无。

备注

此任务已弃用。 使用 AppCenterDistribute@3

要求

要求 说明
管道类型 YAML,经典内部版本,经典版本
运行平台 Agent、DeploymentGroup
需求
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任意
可设置的变量 任意
代理版本 2.144.0 或更高版本
任务类别 部署
要求 说明
管道类型 YAML、经典版本、经典版本
运行平台 Agent、DeploymentGroup
需求
功能 此任务不满足作业中后续任务的任何要求。
命令限制 任意
可设置变量 任意
代理版本 所有支持的代理版本。
任务类别 部署