AppCenterDistribute@1 – Tarefa de distribuição do App Center v1

Use essa tarefa para distribuir builds de aplicativo para testadores e usuários por meio do App Center e do Visual Studio App Center.

Importante

Essa tarefa foi preterida e será desativada em 31 de janeiro de 2024. Use 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.

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. 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 .pdb os arquivos de símbolos. 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 uma atualização. Os testadores são solicitados automaticamente a atualizar.

distributionGroupId - ID de destino
Alias de entrada: 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