AppCenterDistribute@3 – Tarefa de distribuição do App Center v3

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

Syntax

# App Center distribute v3
# Distribute app builds to testers and users via Visual Studio App Center.
- task: AppCenterDistribute@3
  inputs:
    serverEndpoint: # string. Required. App Center service connection. 
    appSlug: # string. Required. App slug. 
    appFile: # string. Alias: app. Required. Binary file path. 
    #buildVersion: # string. Build version. 
    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.
    destinationType: 'groups' # 'groups' | 'store'. Required. Release destination. Default: groups.
    #distributionGroupId: # string. Alias: destinationGroupIds. Optional. Use when destinationType = groups. Destination IDs. 
    #destinationStoreId: # string. Required when destinationType = store. Destination ID. 
    #isSilent: # boolean. Optional. Use when destinationType = groups. Do not notify testers. Release will still be available to install. 
  # Symbols
    #symbolsOption: 'Apple' # 'Apple' | 'Android' | 'UWP'. Alias: symbolsType. Symbols type. Default: Apple.
    #symbolsPath: # string. Optional. Use when symbolsType == AndroidNative || symbolsType = Windows. Symbols path. 
    #appxsymPath: # string. Optional. Use when symbolsType = UWP. Symbols path (*.appxsym). 
    #symbolsDsymFiles: # string. Alias: dsymPath. Optional. Use when symbolsType = Apple. dSYM path. 
    #symbolsMappingTxtFile: # string. Alias: mappingTxtPath. Optional. Use when symbolsType = Android. Mapping file. 
    #nativeLibrariesPath: # string. Optional. Use when symbolsType == Android. Native Library File Path. 
    #symbolsIncludeParentDirectory: # boolean. Alias: packParentFolder. Optional. Use when symbolsType = Apple. 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 e 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/AAB ou IPA que você deseja publicar.

buildVersion - Versão de build
string.

A versão de build do binário de carregamento que precisa ser especificada para .zip e .msi. Esse valor será ignorado, a menos que a plataforma seja WPF ou WinForms.

symbolsOption - Tipo de símbolos
Alias de entrada: symbolsType. string. Valores permitidos: Apple, Android, UWP. 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.

appxsymPath - Caminho dos símbolos (*.appxsym)
string. Opcional. Use quando symbolsType = UWP.

O caminho relativo para o arquivo de símbolos APPXSYM. 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 = Android.

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

nativeLibrariesPath - Caminho do arquivo da biblioteca nativa
string. Opcional. Use quando symbolsType == Android.

O caminho relativo da raiz do repositório para as bibliotecas nativas adicionais que você deseja publicar (por exemplo, arquivos .so).

symbolsIncludeParentDirectory - Incluir todos os itens na pasta pai
Alias de entrada: packParentFolder. boolean. Opcional. Use quando symbolsType = Apple.

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 serã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.

destinationType - Destino da versão
string. Obrigatórios. Valores Permitidos: groups e store. Valor padrão: groups.

Cada versão é distribuída para grupos ou um repositório.

distributionGroupId - IDs de destino
Alias de entrada: destinationGroupIds. string. Opcional. Use quando destinationType = groups.

As IDs dos grupos de distribuição que receberão a versão de build. Deixe-o vazio para usar o grupo padrão e use vírgulas ou ponto e vírgula para separar várias IDs.

destinationStoreId - ID de destino
string. Obrigatório quando destinationType = store.

As IDs do repositório de distribuição que receberão a versão de build.

isSilent - Não notifique os testadores. A versão ainda estará disponível para instalação.
boolean. Opcional. Use quando destinationType = groups.

Os testadores não recebem um email para novas versões.

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

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

• Inscrever-se com o App Center primeiro.
• Para obter detalhes sobre como usar essa tarefa, confira o artigo na documentação do App Center Implantar compilações do Azure DevOps com o App Center.

Exemplos

Este pipeline de exemplo cria um aplicativo Android, executa testes e publica o aplicativo usando a Distribuição do App Center.

# Android
# Build your Android project with Gradle.
# Add steps that test, sign, and distribute the APK, save build artifacts, and more:
# https://learn.microsoft.com/azure/devops/pipelines/ecosystems/android

pool:
  vmImage: 'macOS-latest'
steps:

- script: sudo npm install -g appcenter-cli
- script: appcenter login --token {YOUR_TOKEN}

- task: Gradle@2
  inputs:
    workingDirectory: ''
    gradleWrapperFile: 'gradlew'
    gradleOptions: '-Xmx3072m'
    publishJUnitResults: false
    testResultsFiles: '**/TEST-*.xml'
    tasks: build

- task: CopyFiles@2
  inputs:
    contents: '**/*.apk'
    targetFolder: '$(build.artifactStagingDirectory)'

- task: PublishBuildArtifacts@1
  inputs:
    pathToPublish: '$(build.artifactStagingDirectory)'
    artifactName: 'outputs'
    artifactType: 'container'

# Run tests using the App Center CLI
- script: appcenter test run espresso --app "{APP_CENTER_SLUG}" --devices "{DEVICE}" --app-path {APP_FILE} --test-series "master" --locale "en_US" --build-dir {PAT_ESPRESSO} --debug

# Distribute the app
- task: AppCenterDistribute@3
  inputs:
    serverEndpoint: 'AppCenter'
    appSlug: '$(APP_CENTER_SLUG)'
    appFile: '$(APP_FILE)' # Relative path from the repo root to the APK or IPA file you want to publish
    symbolsOption: 'Android'
    releaseNotesOption: 'input'
    releaseNotesInput: 'Here are the release notes for this version.'
    destinationType: 'groups'

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.206.1 ou superior
Categoria da tarefa	Implantar