AppCenterDistribute@3: tarea distribuir v3 de App Center

Use esta tarea para distribuir compilaciones de aplicaciones a evaluadores y usuarios a través de Visual Studio App Center.

Sintaxis

# 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 - de conexión de servicio de App Center
string. Obligatorio.

Selecciona la conexión de servicio para Visual Studio App Center. Para crear uno, haga clic en el vínculo Manage y cree una nueva conexión de servicio.

appSlug - de aplicación
string. Obligatorio.

El slug de la aplicación tiene el formato de {username}/{app_identifier}. Para buscar {username} y {app_identifier} para una aplicación, haga clic en su nombre en App Centery la dirección URL resultante tiene el formato de https://appcenter.ms/users/**{username}**/apps/**{app_identifier}**. Si usa organizaciones, el slug de la aplicación tiene el formato {orgname}/{app_identifier}.

appFile - ruta de acceso de archivo binario
Alias de entrada: app. string. Obligatorio.

Ruta de acceso relativa de la raíz del repositorio al archivo APK/AAB o IPA que desea publicar.

buildVersion - versión de compilación
string.

Versión de compilación del binario de carga que debe especificarse para .zip y .msi. Este valor se omitirá a menos que la plataforma sea WPF o WinForms.

tipo símbolos de symbolsOption -
Alias de entrada: symbolsType. string. Valores permitidos: Apple, Android, UWP. Valor predeterminado: Apple.

Incluye archivos de símbolos para recibir seguimientos simbólicos de la pila en Diagnósticos de App Center.

symbolsPath - ruta de acceso símbolos
string. Opcional. Use cuando symbolsType == AndroidNative || symbolsType = Windows.

Ruta de acceso relativa de la raíz del repositorio a la carpeta de símbolos.

ruta de acceso símbolos de appxsymPath - (*.appxsym)
string. Opcional. Use cuando symbolsType = UWP.

Ruta de acceso relativa al archivo de símbolos APPXSYM. La ruta de acceso puede contener caracteres comodín .

symbolsDsymFiles - ruta de acceso dSYM
Alias de entrada: dsymPath. string. Opcional. Use cuando symbolsType = Apple.

Ruta de acceso relativa de la raíz del repositorio a la carpeta dSYM. La ruta de acceso puede contener caracteres comodín .

de archivos de asignación de symbolsMappingTxtFile -
Alias de entrada: mappingTxtPath. string. Opcional. Use cuando symbolsType = Android.

Ruta de acceso relativa desde la raíz del repositorio al archivo mapping.txt de Android.

nativeLibrariesPath - ruta de acceso de archivo de biblioteca nativa
string. Opcional. Use cuando symbolsType == Android.

Ruta de acceso relativa de la raíz del repositorio a las bibliotecas nativas adicionales que desea publicar (por ejemplo, archivos .so).

symbolsIncludeParentDirectory - Incluir todos los elementos de la carpeta primaria
Alias de entrada: packParentFolder. boolean. Opcional. Use cuando symbolsType = Apple.

Carga el archivo o carpeta de símbolos seleccionados y todos los demás elementos dentro de la misma carpeta primaria. Esto es necesario para las aplicaciones nativas de React.

releaseNotesOption - Crear notas de la versión
Alias de entrada: releaseNotesSelection. string. Obligatorio. Valores permitidos: input (Escriba notas de la versión), file (seleccione Archivo de notas de la versión). Valor predeterminado: input.

Las notas de la versión se adjuntarán a la versión y se mostrarán a los evaluadores en la página de instalación.

notas de la versión de releaseNotesInput -
string. Obligatorio cuando releaseNotesSelection = input.

Notas de la versión de esta versión.

releaseNotesFile - archivo de notas de la versión
string. Obligatorio cuando releaseNotesSelection = file.

Selecciona un archivo de texto codificado UTF-8 que contiene las notas de la versión de esta versión.

isMandatory - Requerir que los usuarios actualicen a esta versión
boolean. Valor predeterminado: false.

El SDK de Distribución de App Center necesario para exigir una actualización. Se solicita automáticamente a los evaluadores que actualicen.

destinationType - de destino de versión
string. Obligatorio. Valores permitidos: groups, store. Valor predeterminado: groups.

Cada versión se distribuye a grupos o a un almacén.

distributionGroupId - identificadores de destino
Alias de entrada: destinationGroupIds. string. Opcional. Use cuando destinationType = groups.

Identificadores de los grupos de distribución que recibirán la versión de compilación. Deje vacío para usar el grupo predeterminado y use comas o punto y coma para separar varios identificadores.

id. de destino de destinationStoreId -
string. Obligatorio cuando destinationType = store.

Identificadores del almacén de distribución que recibirán la versión de compilación.

isSilent - No notificar a los evaluadores. La versión seguirá estando disponible para instalarse.
boolean. Opcional. Use cuando destinationType = groups.

Los evaluadores no reciben un correo electrónico para nuevas versiones.

Opciones de control de tareas

Todas las tareas tienen opciones de control además de sus entradas de tarea. Para obtener más información, consulte Opciones de control y propiedades de tareas comunes.

Variables de salida

Ninguno.

Observaciones

Use esta tarea para distribuir compilaciones de aplicaciones a evaluadores y usuarios a través de App Center.

• Regístrate primero en App Center.
• Para más información sobre el uso de esta tarea, consulte el artículo de documentación de App Center Implementación de compilaciones de Azure DevOps con App Center.

Ejemplos

En esta canalización de ejemplo se compila una aplicación de Android, se ejecutan pruebas y se publica la aplicación mediante App Center Distribute.

# 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	Descripción
Tipos de canalización	YAML, compilación clásica, versión clásica
Se ejecuta en	Agente, DeploymentGroup
demandas	Ninguno
funcionalidades de	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
restricciones de comandos	Cualquiera
variables settable	Cualquiera
Versión del agente	2.206.1 o superior
Categoría de tarea	Desplegar