Partilhar via


AppCenterDistribute@1 - App Center distribuir tarefa v1

Use esta tarefa para distribuir compilações de aplicativos para testadores e usuários por meio do App Center e do Visual Studio App Center.

Importante

Esta tarefa foi preterida e será desativada em 31 de janeiro de 2024. Use AppCenterDistribute@3.

Use esta tarefa para distribuir compilações de aplicativos para testadores e usuários por meio do App Center e do Visual Studio App Center.

Esta tarefa foi preterida; use AppCenterDistribute@3.

Use esta tarefa para distribuir compilações de aplicativos para testadores e usuários por meio do App Center e do Visual Studio App Center.

Sintaxe

# 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.

Insumos

serverEndpoint - de conexão de serviço do App Center
string. Obrigatório.

Seleciona a conexão de serviço para o Visual Studio App Center. Para criar uma, clique no link Manage e crie uma nova conexão de serviço.


appSlug - Lesma do aplicativo
string. Obrigatório.

O aplicativo slug está no formato de {username}/{app_identifier}. Para localizar {username} e {app_identifier} de um aplicativo, clique em seu nome App Center. O URL resultante está no formato de https://appcenter.ms/users/**{username}**/apps/**{app_identifier}**. Se você estiver usando orgs, o aplicativo slug é do formato {orgname}/{app_identifier}.


appFile - caminho do arquivo binário
Alias de entrada: app. string. Obrigatório.

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ímbolos 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 de símbolos.


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 .pdb arquivos de símbolos. O caminho pode conter curingas.


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 curingas.


do arquivo de mapeamento symbolsMappingTxtFile -
Alias de entrada: mappingTxtPath. string. Opcional. Use quando symbolsType = AndroidJava.

O caminho relativo da raiz do repositório para o arquivo mapping.txt do Android.


symbolsIncludeParentDirectory - Incluir todos os itens na pasta pai
Alias de entrada: packParentFolder. boolean.

Carrega o arquivo ou 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 de versão
Alias de entrada: releaseNotesSelection. string. Obrigatório. Valores permitidos: input (Inserir Notas de Versão), file (Selecionar Arquivo de Notas de Versão). Valor padrão: input.

As notas de versão são anexadas à versão e mostradas aos testadores na página de instalação.


releaseNotesInput - Notas de versão
string. Necessário quando releaseNotesSelection = input.

As notas de versão para esta versão.


releaseNotesFile - Arquivo de notas de versão
string. Necessário quando releaseNotesSelection = file.

Seleciona um arquivo de texto codificado UTF-8 que contém as notas de versão para esta 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 uma atualização. Os testadores são automaticamente solicitados a atualizar.


distributionGroupId - ID de destino
Alias de entrada: destinationId. string.

As IDs dos armazenamentos ou grupos de distribuição que receberão a versão de compilação. Deixe-o vazio para usar o grupo padrão.


Opções de controlo de tarefas

Todas as tarefas têm opções de controle, além de suas entradas de tarefas. Para obter mais informações, consulte Opções de controle de e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Observações

Esta tarefa foi preterida. Use AppCenterDistribute@3.

Requerimentos

Requisito Descrição
Tipos de pipeline YAML, Construção clássica, Versão clássica
Funciona em Agente, DeploymentGroup
Exigências Nenhum
Capacidades Esta tarefa não satisfaz quaisquer exigências 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 de tarefa Desplegar
Requisito Descrição
Tipos de pipeline YAML, Construção clássica, Versão clássica
Funciona em Agente, DeploymentGroup
Exigências Nenhum
Capacidades Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes no trabalho.
Restrições de comando Qualquer
Variáveis configuráveis Qualquer
Versão do agente Todas as versões de agente suportadas.
Categoria de tarefa Desplegar