AppCenterDistribute@2 – Tarefa de distribuição do App Center v2
Use essa tarefa para distribuir builds de aplicativo para testadores e usuários por meio do Visual Studio App Center.
Importante
Essa tarefa foi preterida e será desativada em 31 de janeiro de 2024. Use AppCenterDistribute@3.
Use essa tarefa para distribuir builds de aplicativo para testadores e usuários por meio do Visual Studio App Center.
Esta tarefa foi preterida; use AppCenterDistribute@3.
Use essa tarefa para distribuir builds de aplicativo para testadores e usuários por meio do Visual Studio App Center.
Syntax
# App Center distribute v2
# Distribute app builds to testers and users via Visual Studio App Center.
- task: AppCenterDistribute@2
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: destinationIds | destinationId. Destination IDs.
# 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.
Entradas
serverEndpoint
-
Conexão de serviço do App Center
string
. Obrigatórios.
Seleciona a conexão de serviço para o Visual Studio App Center. Para criar uma, clique no Manage
link e crie uma nova conexão de serviço.
appSlug
-
Lesma do aplicativo
string
. Obrigatórios.
A lesma do aplicativo está no formato .{username}/{app_identifier}
Para localizar {username}
e {app_identifier}
para um aplicativo, clique em seu nome no App Center e a URL resultante está no formato de https://appcenter.ms/users/**{username}**/apps/**{app_identifier}**
. Se você estiver usando organizações, o slug do aplicativo será do formato {orgname}/{app_identifier}
.
appFile
-
Caminho do arquivo binário
Alias de entrada: app
.
string
. Obrigatórios.
O caminho relativo da raiz do repositório para o arquivo APK ou IPA que você deseja publicar.
symbolsOption
-
Tipo de símbolos
Alias de entrada: symbolsType
.
string
. Valores permitidos: Apple
. Valor padrão: Apple
.
Inclui arquivos de símbolo para receber rastreamentos de pilha simbólicos no Diagnóstico do App Center.
symbolsPath
-
Caminho dos símbolos
string
. Opcional. Use quando symbolsType == AndroidNative || symbolsType = Windows
.
O caminho relativo da raiz do repositório para a pasta symbols.
symbolsPdbFiles
-
Caminho dos símbolos (*.pdb)
Alias de entrada: pdbPath
.
string
. Opcional. Use quando symbolsType = UWP
. Valor padrão: **/*.pdb
.
O caminho relativo da raiz do repositório para os arquivos de símbolos PDB. O caminho pode conter caracteres curinga.
symbolsDsymFiles
-
Caminho dSYM
Alias de entrada: dsymPath
.
string
. Opcional. Use quando symbolsType = Apple
.
O caminho relativo da raiz do repositório para a pasta dSYM. O caminho pode conter caracteres curinga.
symbolsMappingTxtFile
-
Arquivo de mapeamento
Alias de entrada: mappingTxtPath
.
string
. Opcional. Use quando symbolsType = AndroidJava
.
O caminho relativo da raiz do repositório para o arquivo do mapping.txt
Android.
symbolsIncludeParentDirectory
-
Incluir todos os itens na pasta pai
Alias de entrada: packParentFolder
.
boolean
.
Carrega o arquivo ou a pasta de símbolos selecionados e todos os outros itens dentro da mesma pasta pai. Isso é necessário para aplicativos React Native.
releaseNotesOption
-
Criar notas sobre a versão
Alias de entrada: releaseNotesSelection
.
string
. Obrigatórios. Valores permitidos: input
(Insira Notas sobre a Versão) file
(Selecione Arquivo de Notas de Versão). Valor padrão: input
.
As notas sobre a versão são anexadas à versão e mostradas aos testadores na página de instalação.
releaseNotesInput
-
Notas sobre a versão
string
. Obrigatório quando releaseNotesSelection = input
.
As notas sobre a versão desta versão.
releaseNotesFile
-
Arquivo de notas sobre a versão
string
. Obrigatório quando releaseNotesSelection = file
.
Seleciona um arquivo de texto codificado em UTF-8 que contém as notas sobre a versão desta versão.
isMandatory
-
Exigir que os usuários atualizem para esta versão
boolean
. Valor padrão: false
.
O SDK de Distribuição do App Center necessário para exigir a atualização. Os testadores são solicitados automaticamente a atualizar.
distributionGroupId
-
IDs de destino
Alias de entrada: destinationIds | destinationId
.
string
.
As IDs dos repositórios de distribuição ou grupos que receberão a versão de build. Deixe-o vazio para usar o grupo padrão.
Opções de controle da tarefa
Todas as tarefas têm opções de controle além de suas entradas de tarefa. Para obter mais informações, consulte Opções de controle e propriedades comuns da tarefa.
Variáveis de saída
Nenhum.
Comentários
Essa tarefa foi preterida. Use AppCenterDistribute@3.
Requisitos
Requisito | Descrição |
---|---|
Tipos de pipeline | YAML, build clássico, versão clássica |
Executa em | Agent, DeploymentGroup |
Demandas | Nenhum |
Funcionalidades | Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho. |
Restrições de comando | Qualquer |
Variáveis configuráveis | Qualquer |
Versão do agente | 2.144.0 ou superior |
Categoria da tarefa | Implantar |
Requisito | Descrição |
---|---|
Tipos de pipeline | YAML, build clássico, versão clássica |
Executa em | Agent, DeploymentGroup |
Demandas | Nenhum |
Funcionalidades | Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho. |
Restrições de comando | Qualquer |
Variáveis configuráveis | Qualquer |
Versão do agente | Todas as versões do agente com suporte. |
Categoria da tarefa | Implantar |