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.

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

# 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. 
    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'. 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 = Android. Mapping file. 
    #symbolsIncludeParentDirectory: # boolean. Alias: packParentFolder. Optional. Use when symbolsType = Apple. Include all items in parent folder.

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.

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

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 os arquivos de símbolos PDB. O caminho pode conter caracteres curinga.

Nenhum.