AppCenterDistribute@1 - Distribuir tarefa v1 pelo Centro de Aplicações

Utilize esta tarefa para distribuir compilações de aplicações a testadores e utilizadores através do Centro de Aplicações e do Centro de Aplicações do Visual Studio.

Importante

Esta tarefa foi preterida e será descontinuada a 31 de janeiro de 2024. Utilize 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 - Ligação ao serviço do Centro de Aplicações
string. Obrigatório.

Seleciona a ligação de serviço para o Centro de Aplicações do Visual Studio. Para criar uma, clique na Manage ligação e crie uma nova ligação de serviço.

appSlug - Lesma da aplicação
string. Obrigatório.

O slug da aplicação está no formato de {username}/{app_identifier}. Para localizar {username} e {app_identifier} para uma aplicação, clique no respetivo nome a partir do Centro de Aplicações. O URL resultante está no formato de https://appcenter.ms/users/**{username}**/apps/**{app_identifier}**. Se estiver a utilizar organizações, a lesma da aplicação é do formato {orgname}/{app_identifier}.

appFile - Caminho do ficheiro binário
Alias de entrada: app. string. Obrigatório.

O caminho relativo da raiz do repositório para o ficheiro APK ou IPA que pretende publicar.

symbolsOption - Tipo de símbolos
Alias de entrada: symbolsType. string. Valores permitidos: Apple. Valor predefinido: Apple.

Inclui ficheiros de símbolos para receber rastreios de pilhas simbólicas no Diagnóstico do Centro de Aplicações.

symbolsPath - Caminho dos símbolos
string. Opcional. Utilize 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. Utilize quando symbolsType = UWP. Valor predefinido: **/*.pdb.

O caminho relativo da raiz do repositório para os .pdb ficheiros de símbolos. O caminho pode conter carateres universais.

symbolsDsymFiles - caminho dSYM
Alias de entrada: dsymPath. string. Opcional. Utilize quando symbolsType = Apple.

O caminho relativo da raiz do repositório para a pasta dSYM. O caminho pode conter carateres universais.

symbolsMappingTxtFile - Ficheiro de mapeamento
Alias de entrada: mappingTxtPath. string. Opcional. Utilize quando symbolsType = AndroidJava.

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

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

Carrega o ficheiro ou pasta de símbolos selecionados e todos os outros itens dentro da mesma pasta principal. Isto é necessário para React Native aplicações.

releaseNotesOption - Criar notas de versão
Alias de entrada: releaseNotesSelection. string. Obrigatório. Valores permitidos: input (Introduza Notas de Versão), file (Selecione Ficheiro de Notas de Versão). Valor predefinido: input.

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

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

As notas de versão desta versão.

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

Seleciona um ficheiro de texto codificado UTF-8 que contém as notas de versão para esta versão.

isMandatory - Exigir que os utilizadores atualizem para esta versão
boolean. Valor predefinido: false.

O SDK de Distribuição do Centro de Aplicações necessário para ordenar uma atualização. Os testadores são automaticamente solicitados a atualizar.

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

Os IDs dos arquivos de distribuição ou grupos que irão receber a versão de compilação. Deixe-o vazio para utilizar o grupo predefinido.

Opções de controlo de tarefas

Todas as tarefas têm opções de controlo para além das entradas de tarefas. Para obter mais informações, veja Opções de controlo e propriedades de tarefas comuns.

Variáveis de saída

Nenhum.

Observações

Esta tarefa foi preterida. Utilize AppCenterDistribute@3.

Requisitos

Requisito	Description
Tipos de pipeline	YAML, Compilação clássica, Versão clássica
É executado em	Agente, DeploymentGroup
Exigências	Nenhuma
Capacidades	Esta tarefa não satisfaz quaisquer exigências para tarefas subsequentes na tarefa.
Restrições de comandos	Qualquer
Variáveis de tabelas definidas	Qualquer
Versão do agente	2.144.0 ou superior
Categoria da tarefa	Implementar