Compartir a través de


AppCenterTest@1: tarea prueba v1 de App Center

Pruebe los paquetes de aplicaciones con Visual Studio App Center.

Sintaxis

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

Entradas

appFile - ruta de acceso de 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 - de 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 utilizado por el paso de ejecución. Este directorio se creará si aún no existe.


prepareTests - Preparar pruebas
Alias de entrada: enablePrepare. boolean. Valor predeterminado: true.

Cuando se establece en true, esta entrada prepara las pruebas.


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


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

Ruta de acceso al directorio con las pruebas de Appium.


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

Ruta de acceso al directorio de salida de Espresso.


espressoTestApkFile - prueba de la ruta de acceso de APK
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, se usa build-dir para detectarlo. Se permite un carácter comodín.


de directorio de calabashProjectDirectory - Project
Alias de entrada: calabashProjectDir. string. Obligatorio cuando enablePrepare = true && framework = calabash.

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


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

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


calabashProfile - Perfil para 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 Pepino.


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

Cuando se establece en true, esta entrada omite la comprobación de configuración especificada por el perfil de Pepino.


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

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


de archivos de uitestStorePath - Store
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 de contraseñas
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 - de 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.


de contraseña de clave de uiTestKeyPassword -
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.


de directorio de herramientas de prueba de uiTestToolsDirectory -
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 - de información de firma
string. Opcional. Use cuando framework = calabash || framework = uitest.

Firma el servidor de prueba.


de directorio de compilación de xcUITestBuildDirectory -
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 - ruta de acceso de IPA de prueba
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 - Ejecutar pruebas
Alias de entrada: enableRun. boolean. Valor predeterminado: true.

Ejecuta las pruebas.


credentialsOption - método de autenticación
Alias de entrada: credsType. string. Obligatorio 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 - de conexión de servicio de App Center
string. Obligatorio 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.


de nombre de usuario de username - App Center
string. Obligatorio cuando enableRun = true && credsType = inputs.

Para crear el nombre de usuario, visite la página de inicio de sesión de App Centery proporcione el valor aquí.


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

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


appSlug - de aplicación
string. Obligatorio cuando enableRun = true.

El slug de la aplicación tiene el formato de <username>/<app_identifier>. Para buscar el <username> y el <app_identifier> de 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>.


dispositivos de devices -
string. Obligatorio 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.


serie test de series -
string. Opcional. Use cuando enableRun = true. Valor predeterminado: master.

Nombre de la serie para organizar las ejecuciones de pruebas (por ejemplo: master, production, beta).


de directorio dSYM de dsymDirectory -
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. Obligatorio cuando enableRun = true. Valores permitidos: da_DK (Danés (Dinamarca)), nl_NL (Neerlandés)), en_GB (Inglés (Reino Unido)), en_US (Inglés (Estados Unidos)), fr_FR (francés [Francia)]), fr_FR (francia)), ja_JPen_US (Alemán (Alemania),es_MX (Japón),es_ES (Ruso (Rusia)), user (Español (México)), (Español (España)), (Otros). Valor predeterminado: en_US.

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


userDefinedLocale - otros de 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 ejecutar
Alias de entrada: runOpts. string. Opcional. Use cuando enableRun = true.

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


skipWaitingForResults - No esperar de resultados 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 - Habilitar de salida de depuración
Alias de entrada: debug. boolean. Valor predeterminado: false.

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


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

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

Ejemplos

En este ejemplo se ejecutan pruebas Espresso en una aplicación Android mediante 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
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 Prueba
Requisito Descripción
Tipos de canalización YAML, compilació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.144.0 o superior
Categoría de tarea Prueba
Requisito Descripción
Tipos de canalización YAML, compilació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 Todas las versiones de agente admitidas.
Categoría de tarea Prueba