Compartilhar via


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

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

Essa tarefa foi preterida; use AppCenterDistribute@3.

Use essa tarefa para distribuir builds 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.

Entradas

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

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


de lesma do aplicativo appSlug -
string. Obrigatório

A lesma do aplicativo está no formato de {username}/{app_identifier}. Para localizar {username} e {app_identifier} de um aplicativo, clique em seu nome do App Center. A URL resultante está no formato de https://appcenter.ms/users/**{username}**/apps/**{app_identifier}**. Se você estiver usando organizações, a lesma do aplicativo será do formato {orgname}/{app_identifier}.


appFile - caminho de 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.


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


de caminho de Símbolos symbolsPath -
string. Opcional. Use quando symbolsType == AndroidNative || symbolsType = Windows.

O caminho relativo da raiz do repositório para a pasta de símbolos.


symbolsPdbFiles - caminho 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 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 .


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

O caminho relativo da raiz do repositório para o arquivo de 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 selecionado 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.


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

As notas sobre a versão desta versão.


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

Seleciona um arquivo de texto codificado em UTF-8 que contém as notas de 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.


ID de destino distributionGroupId -
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 de tarefa

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

Variáveis de saída

Nenhum.

Observações

Essa tarefa foi preterida. Use AppCenterDistribute@3.

Requisitos

Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Execuções em Agent, DeploymentGroup
de demandas Nenhum
recursos Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando Qualquer
variáveis settable Qualquer
Versão do agente 2.144.0 ou superior
Categoria de tarefa Implantar
Requisito Descrição
Tipos de pipeline YAML, build clássico, versão clássica
Execuções em Agent, DeploymentGroup
de demandas Nenhum
recursos Essa tarefa não atende a nenhuma demanda para tarefas subsequentes no trabalho.
restrições de comando Qualquer
variáveis settable Qualquer
Versão do agente Todas as versões de agente com suporte.
Categoria de tarefa Implantar