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.

Use essa tarefa para distribuir builds de aplicativo para testadores e usuários por meio do App Center e 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 App Center e do Visual Studio App Center.

Distribua builds de aplicativo para testadores e usuários por meio do App Center.

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

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
Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
É executado em Agent, DeploymentGroup
Demandas Nenhum
Funcionalidades Essa tarefa não atende a nenhuma demanda por 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