AppCenterTest@1: tarea de prueba v1 de App Center

Artículo
07/02/2024

Pruebe paquetes de aplicaciones con Visual Studio App Center.

Syntax

# App Center test v1
# Test app packages with Visual Studio App Center.
- task: AppCenterTest@1
  inputs:
    appFile: # string. Alias: app. Required. Binary application file path. 
    artifactsDirectory: '$(Build.ArtifactStagingDirectory)/AppCenterTest' # string. Alias: artifactsDir. Required. Artifacts directory. Default: $(Build.ArtifactStagingDirectory)/AppCenterTest.
  # Prepare Tests
    #prepareTests: true # boolean. Alias: enablePrepare. Prepare tests. Default: true.
    frameworkOption: 'appium' # 'appium' | 'espresso' | 'calabash' | 'uitest' | 'xcuitest'. Alias: framework. Required when enablePrepare = true. Test framework. Default: appium.
    #appiumBuildDirectory: # string. Alias: appiumBuildDir. Required when enablePrepare = true && framework = appium. Build directory. 
    #espressoBuildDirectory: # string. Alias: espressoBuildDir. Optional. Use when enablePrepare = true && framework = espresso. Build directory. 
    #espressoTestApkFile: # string. Alias: espressoTestApkPath. Optional. Use when enablePrepare = true && framework = espresso. Test APK path. 
    #calabashProjectDirectory: # string. Alias: calabashProjectDir. Required when enablePrepare = true && framework = calabash. Project directory. 
    #calabashConfigFile: # string. Optional. Use when enablePrepare = true && framework = calabash. Cucumber config file. 
    #calabashProfile: # string. Optional. Use when enablePrepare = true && framework = calabash. Profile to run. 
    #calabashSkipConfigCheck: false # boolean. Optional. Use when enablePrepare = true && framework = calabash. Skip Configuration Check. Default: false.
    #uiTestBuildDirectory: # string. Alias: uitestBuildDir. Required when enablePrepare = true && framework = uitest. Build directory. 
    #uitestStorePath: # string. Optional. Use when enablePrepare = true && framework = uitest. Store file. 
    #uiTestStorePassword: # string. Alias: uitestStorePass. Optional. Use when enablePrepare = true && framework = uitest. Store password. 
    #uitestKeyAlias: # string. Optional. Use when enablePrepare = true && framework = uitest. Key alias. 
    #uiTestKeyPassword: # string. Alias: uitestKeyPass. Optional. Use when enablePrepare = true && framework = uitest. Key password. 
    #uiTestToolsDirectory: # string. Alias: uitestToolsDir. Optional. Use when enablePrepare = true && framework = uitest. Test tools directory. 
    #signInfo: # string. Optional. Use when framework = calabash || framework = uitest. Signing information. 
    #xcUITestBuildDirectory: # string. Alias: xcuitestBuildDir. Optional. Use when enablePrepare = true && framework = xcuitest. Build directory. 
    #xcUITestIpaFile: # string. Alias: xcuitestTestIpaPath. Optional. Use when enablePrepare = true && framework = xcuitest. Test IPA path. 
    #prepareOptions: # string. Alias: prepareOpts. Optional. Use when enablePrepare = true. Additional options. 
  # Run Tests
    #runTests: true # boolean. Alias: enableRun. Run tests. Default: true.
    credentialsOption: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Alias: credsType. Required when enableRun = true. Authentication method. Default: serviceEndpoint.
    #serverEndpoint: # string. Required when enableRun = true && credsType = serviceEndpoint. App Center service connection. 
    #username: # string. Required when enableRun = true && credsType = inputs. App Center username. 
    #password: # string. Required when enableRun = true && credsType = inputs. App Center password. 
    appSlug: # string. Required when enableRun = true. App slug. 
    devices: # string. Required when enableRun = true. Devices. 
    #series: 'master' # string. Optional. Use when enableRun = true. Test series. Default: master.
    #dsymDirectory: # string. Alias: dsymDir. Optional. Use when enableRun = true. dSYM directory. 
    localeOption: 'en_US' # 'da_DK' | 'nl_NL' | 'en_GB' | 'en_US' | 'fr_FR' | 'de_DE' | 'ja_JP' | 'ru_RU' | 'es_MX' | 'es_ES' | 'user'. Alias: locale. Required when enableRun = true. System language. Default: en_US.
    #userDefinedLocale: # string. Optional. Use when enableRun = true && locale = user. Other locale. 
    #loginOptions: # string. Alias: loginOpts. Optional. Use when enableRun = true && credsType = inputs. Additional options for login. 
    #runOptions: # string. Alias: runOpts. Optional. Use when enableRun = true. Additional options for run. 
    #skipWaitingForResults: false # boolean. Alias: async. Optional. Use when enableRun = true. Do not wait for test result. Default: false.
  # Advanced
    #cliFile: # string. Alias: cliLocationOverride. App Center CLI location. 
    #showDebugOutput: false # boolean. Alias: debug. Enable debug output. Default: false.

# App Center Test v1
# Test app packages with Visual Studio App Center.
- task: AppCenterTest@1
  inputs:
    appFile: # string. Alias: app. Required. Binary application file path. 
    artifactsDirectory: '$(Build.ArtifactStagingDirectory)/AppCenterTest' # string. Alias: artifactsDir. Required. Artifacts directory. Default: $(Build.ArtifactStagingDirectory)/AppCenterTest.
  # Prepare Tests
    #prepareTests: true # boolean. Alias: enablePrepare. Prepare tests. Default: true.
    frameworkOption: 'appium' # 'appium' | 'espresso' | 'calabash' | 'uitest' | 'xcuitest'. Alias: framework. Required when enablePrepare = true. Test framework. Default: appium.
    #appiumBuildDirectory: # string. Alias: appiumBuildDir. Required when enablePrepare = true && framework = appium. Build directory. 
    #espressoBuildDirectory: # string. Alias: espressoBuildDir. Optional. Use when enablePrepare = true && framework = espresso. Build directory. 
    #espressoTestApkFile: # string. Alias: espressoTestApkPath. Optional. Use when enablePrepare = true && framework = espresso. Test APK path. 
    #calabashProjectDirectory: # string. Alias: calabashProjectDir. Required when enablePrepare = true && framework = calabash. Project directory. 
    #calabashConfigFile: # string. Optional. Use when enablePrepare = true && framework = calabash. Cucumber config file. 
    #calabashProfile: # string. Optional. Use when enablePrepare = true && framework = calabash. Profile to run. 
    #calabashSkipConfigCheck: false # boolean. Optional. Use when enablePrepare = true && framework = calabash. Skip Configuration Check. Default: false.
    #uiTestBuildDirectory: # string. Alias: uitestBuildDir. Required when enablePrepare = true && framework = uitest. Build directory. 
    #uitestStoreFile: # string. Optional. Use when enablePrepare = true && framework = uitest. Store file. 
    #uiTestStorePassword: # string. Alias: uitestStorePass. Optional. Use when enablePrepare = true && framework = uitest. Store password. 
    #uitestKeyAlias: # string. Optional. Use when enablePrepare = true && framework = uitest. Key alias. 
    #uiTestKeyPassword: # string. Alias: uitestKeyPass. Optional. Use when enablePrepare = true && framework = uitest. Key password. 
    #uiTestToolsDirectory: # string. Alias: uitestToolsDir. Optional. Use when enablePrepare = true && framework = uitest. Test tools directory. 
    #signInfo: # string. Optional. Use when framework = calabash || framework = uitest. Signing information. 
    #xcUITestBuildDirectory: # string. Alias: xcuitestBuildDir. Optional. Use when enablePrepare = true && framework = xcuitest. Build directory. 
    #xcUITestIpaFile: # string. Alias: xcuitestTestIpaPath. Optional. Use when enablePrepare = true && framework = xcuitest. Test IPA path. 
    #prepareOptions: # string. Alias: prepareOpts. Optional. Use when enablePrepare = true. Additional options. 
  # Run Tests
    #runTests: true # boolean. Alias: enableRun. Run tests. Default: true.
    credentialsOption: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Alias: credsType. Required when enableRun = true. Authentication method. Default: serviceEndpoint.
    #serverEndpoint: # string. Required when enableRun = true && credsType = serviceEndpoint. App Center service connection. 
    #username: # string. Required when enableRun = true && credsType = inputs. App Center username. 
    #password: # string. Required when enableRun = true && credsType = inputs. App Center password. 
    appSlug: # string. Required when enableRun = true. App slug. 
    devices: # string. Required when enableRun = true. Devices. 
    #series: 'master' # string. Optional. Use when enableRun = true. Test series. Default: master.
    #dsymDirectory: # string. Alias: dsymDir. Optional. Use when enableRun = true. dSYM directory. 
    localeOption: 'en_US' # 'da_DK' | 'nl_NL' | 'en_GB' | 'en_US' | 'fr_FR' | 'de_DE' | 'ja_JP' | 'ru_RU' | 'es_MX' | 'es_ES' | 'user'. Alias: locale. Required when enableRun = true. System language. Default: en_US.
    #userDefinedLocale: # string. Optional. Use when enableRun = true && locale = user. Other locale. 
    #loginOptions: # string. Alias: loginOpts. Optional. Use when enableRun = true && credsType = inputs. Additional options for login. 
    #runOptions: # string. Alias: runOpts. Optional. Use when enableRun = true. Additional options for run. 
    #skipWaitingForResults: false # boolean. Alias: async. Optional. Use when enableRun = true. Do not wait for test result. Default: false.
  # Advanced
    #cliFile: # string. Alias: cliLocationOverride. App Center CLI location. 
    #showDebugOutput: false # boolean. Alias: debug. Enable debug output. Default: false.

Entradas

appFile - Ruta de acceso del archivo de aplicación binaria
Alias de entrada: app. string. Obligatorio.

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

artifactsDirectory - Directorio artifacts
Alias de entrada: artifactsDir. string. Obligatorio. Valor predeterminado: $(Build.ArtifactStagingDirectory)/AppCenterTest.

Especifica dónde colocar los artefactos generados por el paso de preparación y utilizados por el paso de ejecución. Este directorio se creará si aún no existe.

prepareTests - Preparación de pruebas
Alias de entrada: enablePrepare. boolean. Valor predeterminado: true.

Cuando se establece trueen , esta entrada prepara las pruebas.

frameworkOption - Marco de pruebas
Alias de entrada: framework. string. Necesario cuando enablePrepare = true. Valores permitidos: appium, espresso, calabash, uitest (prueba de IU de Xamarin), xcuitest. Valor predeterminado: appium.

appiumBuildDirectory - Directorio de compilación
Alias de entrada: appiumBuildDir. string. Necesario cuando enablePrepare = true && framework = appium.

Ruta de acceso al directorio con las pruebas de Appium.

espressoBuildDirectory - Directorio de compilación
Alias de entrada: espressoBuildDir. string. Opcional. Use cuando enablePrepare = true && framework = espresso.

Ruta de acceso al directorio de salida Espresso.

espressoTestApkFile - Ruta de acceso del APK de prueba
Alias de entrada: espressoTestApkPath. string. Opcional. Use cuando enablePrepare = true && framework = espresso.

Ruta de acceso al archivo APK con las pruebas Espresso. Si no se establece, build-dir se usa para detectarlo. Se permite un carácter comodín.

calabashProjectDirectory - Directorio del proyecto
Alias de entrada: calabashProjectDir. string. Necesario cuando enablePrepare = true && framework = calabash.

Ruta de acceso al directorio del área de trabajo de Calabash.

calabashConfigFile - Archivo de configuración de pepinero
string. Opcional. Use cuando enablePrepare = true && framework = calabash.

La ruta de acceso al archivo de configuración de Pepinillo, normalmente cucumber.yml.

calabashProfile - Perfil que se va a ejecutar
string. Opcional. Use cuando enablePrepare = true && framework = calabash.

Perfil que se va a ejecutar. Este valor debe existir en el archivo de configuración de Pepinillo.

calabashSkipConfigCheck - Omitir comprobación de configuración
boolean. Opcional. Use cuando enablePrepare = true && framework = calabash. Valor predeterminado: false.

Cuando se establece trueen , esta entrada omite la comprobación de configuración especificada por el perfil de Pepero.

uiTestBuildDirectory - Directorio de compilación
Alias de entrada: uitestBuildDir. string. Necesario cuando enablePrepare = true && framework = uitest.

Ruta de acceso al directorio con los ensamblados de prueba compiladas.

uitestStorePath - Almacenar archivo
string. Opcional. Use cuando enablePrepare = true && framework = uitest.

Ruta de acceso al archivo de almacén que se usa para firmar la aplicación.

uiTestStorePassword - Almacenar contraseña
Alias de entrada: uitestStorePass. string. Opcional. Use cuando enablePrepare = true && framework = uitest.

Contraseña del archivo de almacén que se usa para firmar la aplicación. Para cifrar este valor, use una nueva variable con su bloqueo habilitado en la pestaña Variables.

uitestKeyAlias - Alias de clave
string. Opcional. Use cuando enablePrepare = true && framework = uitest.

Especifica el alias que identifica el par de claves pública y privada que se usa en el archivo de almacén.

uiTestKeyPassword - Contraseña de clave
Alias de entrada: uitestKeyPass. string. Opcional. Use cuando enablePrepare = true && framework = uitest.

Especifica la contraseña de clave para el alias y el archivo de almacenamiento. Para cifrar este valor, use una nueva variable con su bloqueo habilitado en la pestaña Variables.

uiTestToolsDirectory - Directorio de herramientas de prueba
Alias de entrada: uitestToolsDir. string. Opcional. Use cuando enablePrepare = true && framework = uitest.

Ruta de acceso al directorio con las herramientas de prueba de Xamarin UI que contienen test-cloud.exe.

signInfo - Información de firma
string. Opcional. Use cuando framework = calabash || framework = uitest.

Firma el servidor de prueba.

xcUITestBuildDirectory - Directorio de compilación
Alias de entrada: xcuitestBuildDir. string. Opcional. Use cuando enablePrepare = true && framework = xcuitest.

Ruta de acceso al directorio de salida de compilación (normalmente $(ProjectDir)/Build/Products/Debug-iphoneos).

xcUITestIpaFile - Prueba de la ruta de acceso de IPA
Alias de entrada: xcuitestTestIpaPath. string. Opcional. Use cuando enablePrepare = true && framework = xcuitest.

Ruta de acceso al archivo .ipa con las pruebas XCUITest.

prepareOptions - Opciones adicionales
Alias de entrada: prepareOpts. string. Opcional. Use cuando enablePrepare = true.

Argumentos adicionales que se pasan al paso de preparación de pruebas de App Center.

runTests - Ejecución de pruebas
Alias de entrada: enableRun. boolean. Valor predeterminado: true.

Ejecuta las pruebas.

credentialsOption - Método de autenticación
Alias de entrada: credsType. string. Necesario cuando enableRun = true. Valores permitidos: serviceEndpoint (conexión de servicio de App Center), inputs (credenciales). Valor predeterminado: serviceEndpoint.

Usa la conexión del servicio App Center o escribe las credenciales para conectarse a Visual Studio App Center.

serverEndpoint - Conexión del servicio App Center
string. Necesario cuando enableRun = true && credsType = serviceEndpoint.

Selecciona la conexión de servicio para Visual Studio App Center. Si es necesario, haga clic en el vínculo Administrar para crear una nueva conexión de servicio.

username - Nombre de usuario de App Center
string. Necesario cuando enableRun = true && credsType = inputs.

Cree su nombre de usuario visitando la página de inicio de sesión de App Center y proporcione el valor aquí.

password - Contraseña de App Center
string. Necesario cuando enableRun = true && credsType = inputs.

Establezca la contraseña visitando la página de inicio de sesión de App Center y proporcione el valor aquí. Se aceptan variables definidas en canalizaciones $(passwordVariable) de compilación o versión. Puede marcar el tipo de variable como secret para protegerlo.

appSlug - Aplicación slug
string. Necesario cuando enableRun = true.

El slug de la aplicación tiene el formato de <username>/<app_identifier>. Para buscar y <username><app_identifier> para una aplicación, haga clic en su nombre en Visual Studio App Center. La dirección URL resultante tiene el formato https://appcenter.ms/users/<username>/apps/<app_identifier>.

devices - Dispositivos
string. Necesario cuando enableRun = true.

Identifica los dispositivos en los que se ejecutará esta prueba. Copie y pegue esta cadena al definir una nueva ejecución de prueba desde la baliza de prueba de Visual Studio App Center.

series - Serie de pruebas
string. Opcional. Use cuando enableRun = true. Valor predeterminado: master.

El nombre de la serie para organizar las ejecuciones de prueba (por ejemplo: master, production, beta).

dsymDirectory - Directorio dSYM
Alias de entrada: dsymDir. string. Opcional. Use cuando enableRun = true.

Ruta de acceso a los archivos de símbolos de iOS.

localeOption - Idioma del sistema
Alias de entrada: locale. string. Necesario cuando enableRun = true. Valores permitidos: da_DK (Danés (Dinamarca)), nl_NL (Neerlandés (Países Bajos)), en_GB (Inglés (Reino Unido)), en_US (Inglés (Estados Unidos)), fr_FR (Francés (Francia)), de_DE (Alemán (Alemania)), ja_JP (Japonés (Japón)), ru_RU (Ruso (Rusia)), es_MX (Español (México)), es_ES (Español (España)), user (Otros). Valor predeterminado: en_US.

Utilice si el idioma no se muestra. Seleccione Other y escriba su configuración regional, como en_US.

userDefinedLocale - Otra configuración regional
string. Opcional. Use cuando enableRun = true && locale = user.

Escribe cualquier código de idioma ISO-639 de dos letras junto con cualquier código de país ISO 3166 de dos letras en el formato <language>_<country>, como en_US.

loginOptions - Opciones adicionales para el inicio de sesión
Alias de entrada: loginOpts. string. Opcional. Use cuando enableRun = true && credsType = inputs.

Argumentos adicionales que se pasan al paso de inicio de sesión de Visual Studio App Center.

runOptions - Opciones adicionales para la ejecución
Alias de entrada: runOpts. string. Opcional. Use cuando enableRun = true.

Argumentos adicionales que se pasan a la ejecución de prueba de Visual Studio App Center.

skipWaitingForResults - No espere el resultado de la prueba
Alias de entrada: async. boolean. Opcional. Use cuando enableRun = true. Valor predeterminado: false.

Ejecuta un comando de forma asincrónica y se cierra cuando las pruebas se cargan sin esperar los resultados de la prueba.

cliFile - Ubicación de la CLI de App Center
Alias de entrada: cliLocationOverride. string.

Ruta de acceso a la CLI de Visual Studio App Center en el agente de compilación o versión.

showDebugOutput - Habilitación de la salida de depuración
Alias de entrada: debug. boolean. Valor predeterminado: false.

Agrega --debug a la CLI de Visual Studio App Center.

uitestStoreFile - Almacenar archivo
string. Opcional. Use cuando enablePrepare = true && framework = uitest.

Opciones de control de tareas

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

Variables de salida

Ninguno.

Comentarios

Esta tarea permite ejecutar conjuntos de pruebas en un archivo binario de aplicación (.apk o .ipa ) mediante App Center Test.

Primero, regístrese en App Center.
Para obtener más información sobre el uso de esta tarea, consulte el artículo Uso de Azure DevOps para pruebas de UI en la documentación de App Center.

Ejemplos

En este ejemplo se ejecutan pruebas de Espresso en una aplicación de Android con la tarea Prueba de App Center.

steps:
- task: AppCenterTest@1
  displayName: 'Espresso Test - Synchronous'
  inputs:
    appFile: 'Espresso/espresso-app.apk'
    artifactsDirectory: '$(Build.ArtifactStagingDirectory)/AppCenterTest'
    frameworkOption: espresso
    espressoBuildDirectory: Espresso
    serverEndpoint: 'myAppCenterServiceConnection'
    appSlug: 'xplatbg1/EspressoTests'
    devices: a84c93af

Requisitos

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica
Se ejecuta en	Agente, DeploymentGroup
Peticiones	None
Capabilities	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos	Any
Variables que se pueden establecer	Any
Versión del agente	2.206.1 o superior
Categoría de la tarea:	Prueba

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica
Se ejecuta en	Agente, DeploymentGroup
Peticiones	None
Capabilities	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos	Any
Variables que se pueden establecer	Any
Versión del agente	2.144.0 o superior
Categoría de la tarea:	Prueba

Requisito	Descripción
Tipos de canalización	YAML, compilación clásica
Se ejecuta en	Agente, DeploymentGroup
Peticiones	None
Capabilities	Esta tarea no satisface ninguna demanda de tareas posteriores en el trabajo.
Restricciones de comandos	Any
Variables que se pueden establecer	Any
Versión del agente	Todas las versiones de agente compatibles.
Categoría de la tarea:	Prueba

Compartir a través de

AppCenterTest@1: tarea de prueba v1 de App Center

Syntax

Entradas

Opciones de control de tareas

Variables de salida

Comentarios

Ejemplos

Requisitos

Comentarios

Recursos adicionales