AppCenterTest@1 - Tâche de test App Center v1

Article
07/02/2024

Tester les packages d'applications avec 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.

Entrées

appFile - Chemin du fichier d’application binaire
Alias d’entrée : app. string. Obligatoire.

Chemin relatif de la racine du référentiel vers le fichier APK ou IPA que vous souhaitez tester.

artifactsDirectory - Répertoire Artefacts
Alias d’entrée : artifactsDir. string. Obligatoire. Valeur par défaut : $(Build.ArtifactStagingDirectory)/AppCenterTest.

Spécifie où placer les artefacts produits par l’étape de préparation et utilisés par l’étape d’exécution. Ce répertoire sera créé s’il n’existe pas déjà.

prepareTests - Préparer les tests
Alias d’entrée : enablePrepare. boolean. Valeur par défaut : true.

Lorsqu’elle trueest définie sur , cette entrée prépare les tests.

frameworkOption - Infrastructure de test
Alias d’entrée : framework. string. Nécessaire lorsque enablePrepare = true. Valeurs autorisées : appium, espresso, calabash, uitest (test de l’interface utilisateur Xamarin), xcuitest. Valeur par défaut : appium.

appiumBuildDirectory - Répertoire de build
Alias d’entrée : appiumBuildDir. string. Nécessaire lorsque enablePrepare = true && framework = appium.

Chemin d’accès au répertoire avec les tests Appium.

espressoBuildDirectory - Répertoire de build
Alias d’entrée : espressoBuildDir. string. facultatif. Utilisez quand enablePrepare = true && framework = espresso.

Chemin d’accès au répertoire de sortie Espresso.

espressoTestApkFile - Test APK path
Alias d’entrée : espressoTestApkPath. string. facultatif. Utilisez quand enablePrepare = true && framework = espresso.

Chemin d’accès au fichier APK avec les tests Espresso. S’il n’est pas défini, build-dir est utilisé pour le découvrir. Un caractère générique est autorisé.

calabashProjectDirectory - Répertoire du projet
Alias d’entrée : calabashProjectDir. string. Nécessaire lorsque enablePrepare = true && framework = calabash.

Chemin d’accès au répertoire de l’espace de travail Calabash.

calabashConfigFile - Fichier de configuration concombre
string. facultatif. Utilisez quand enablePrepare = true && framework = calabash.

Chemin d’accès au fichier de configuration Concombre, généralement cucumber.yml.

calabashProfile - Profil à exécuter
string. facultatif. Utilisez quand enablePrepare = true && framework = calabash.

Profil à exécuter. Cette valeur doit exister dans le fichier de configuration Concombre.

calabashSkipConfigCheck - Ignorer la vérification de configuration
boolean. facultatif. Utilisez quand enablePrepare = true && framework = calabash. Valeur par défaut : false.

Lorsqu’elle trueest définie sur , cette entrée ignore la configuration case activée spécifiée par le profil Concombre.

uiTestBuildDirectory - Répertoire de build
Alias d’entrée : uitestBuildDir. string. Nécessaire lorsque enablePrepare = true && framework = uitest.

Chemin d’accès au répertoire avec les assemblys de test générés.

uitestStorePath - Fichier store
string. facultatif. Utilisez quand enablePrepare = true && framework = uitest.

Chemin d’accès au fichier store utilisé pour signer l’application.

uiTestStorePassword - Stocker le mot de passe
Alias d’entrée : uitestStorePass. string. facultatif. Utilisez quand enablePrepare = true && framework = uitest.

Mot de passe du fichier store utilisé pour signer l’application. Pour chiffrer cette valeur, utilisez une nouvelle variable avec son verrou activé sous l’onglet Variables.

uitestKeyAlias - Alias de clé
string. facultatif. Utilisez quand enablePrepare = true && framework = uitest.

Spécifie l’alias qui identifie la paire de clés publique/privée utilisée dans le fichier de magasin.

uiTestKeyPassword - Mot de passe de clé
Alias d’entrée : uitestKeyPass. string. facultatif. Utilisez quand enablePrepare = true && framework = uitest.

Spécifie le mot de passe de clé pour l’alias et le fichier de magasin. Pour chiffrer cette valeur, utilisez une nouvelle variable avec son verrou activé sous l’onglet Variables.

uiTestToolsDirectory - Répertoire des outils de test
Alias d’entrée : uitestToolsDir. string. facultatif. Utilisez quand enablePrepare = true && framework = uitest.

Chemin d’accès au répertoire avec les outils de test de l’interface utilisateur Xamarin qui contiennent test-cloud.exe.

signInfo - Informations de signature
string. facultatif. Utilisez quand framework = calabash || framework = uitest.

Signe le serveur de test.

xcUITestBuildDirectory - Répertoire de build
Alias d’entrée : xcuitestBuildDir. string. facultatif. Utilisez quand enablePrepare = true && framework = xcuitest.

Chemin d’accès au répertoire de sortie de build (généralement $(ProjectDir)/Build/Products/Debug-iphoneos).

xcUITestIpaFile - Chemin d’accès IPA de test
Alias d’entrée : xcuitestTestIpaPath. string. facultatif. Utilisez quand enablePrepare = true && framework = xcuitest.

Chemin d’accès au fichier .ipa avec les tests XCUITest.

prepareOptions - Options supplémentaires
Alias d’entrée : prepareOpts. string. facultatif. Utilisez quand enablePrepare = true.

Les arguments supplémentaires passés à l’étape de préparation du test App Center.

runTests - Exécuter des tests
Alias d’entrée : enableRun. boolean. Valeur par défaut : true.

Exécute les tests.

credentialsOption - Méthode d’authentification
Alias d’entrée : credsType. string. Nécessaire lorsque enableRun = true. Valeurs autorisées : serviceEndpoint (connexion au service App Center), inputs (Informations d’identification). Valeur par défaut : serviceEndpoint.

Utilise la connexion au service App Center ou entre les informations d’identification pour se connecter à Visual Studio App Center.

serverEndpoint - Connexion au service App Center
string. Nécessaire lorsque enableRun = true && credsType = serviceEndpoint.

Sélectionne la connexion de service pour Visual Studio App Center. Si nécessaire, cliquez sur le lien Gérer pour créer une connexion de service.

username - Nom d’utilisateur App Center
string. Nécessaire lorsque enableRun = true && credsType = inputs.

Créez votre nom d’utilisateur en accédant à la page de connexion d’App Center et fournissez la valeur ici.

password - Mot de passe app Center
string. Nécessaire lorsque enableRun = true && credsType = inputs.

Définissez votre mot de passe en accédant à la page de connexion App Center, puis indiquez la valeur ici. Les variables définies dans les pipelines de build ou de mise en production sont $(passwordVariable) acceptées. Vous pouvez marquer le type de variable comme secret pour le sécuriser.

appSlug - Limace d’application
string. Nécessaire lorsque enableRun = true.

La limace d’application est au format de <username>/<app_identifier>. Pour localiser le <username> et <app_identifier> pour une application, cliquez sur son nom à partir de Visual Studio App Center. L’URL résultante est au format https://appcenter.ms/users/<username>/apps/<app_identifier>.

devices - Dispositifs
string. Nécessaire lorsque enableRun = true.

Identifie les appareils sur 2000 que ce test s’exécutera. Copiez et collez cette chaîne lorsque vous définissez une nouvelle série de tests à partir de la balise de test Visual Studio App Center.

series - Série de tests
string. facultatif. Utilisez quand enableRun = true. Valeur par défaut : master.

Nom de série pour l’organisation des séries de tests (par exemple : master, production, bêta).

dsymDirectory - Répertoire dSYM
Alias d’entrée : dsymDir. string. facultatif. Utilisez quand enableRun = true.

Chemin d’accès aux fichiers de symbole iOS.

localeOption - Langue système
Alias d’entrée : locale. string. Nécessaire lorsque enableRun = true. Valeurs autorisées : da_DK (Danois (Danemark)), nl_NL (Néerlandais (Pays-Bas)), en_GB (Anglais (Royaume-Uni)), en_US (Anglais (États-Unis)), fr_FR (Français (France)), de_DE (Allemand (Allemagne)), (Japonais)), ru_RUja_JP (Russe (Russie)), es_MX (Espagnol (Mexique)), es_ES (Espagnol (Espagne)), user (Autre). Valeur par défaut : en_US.

Utilisez si votre langue n’est pas affichée. Sélectionnez Other et entrez ses paramètres régionaux, tels que en_US.

userDefinedLocale - Autres paramètres régionaux
string. facultatif. Utilisez quand enableRun = true && locale = user.

Entre n’importe quel code de langue ISO-639 à deux lettres ainsi que tout code de pays ISO 3166 à deux lettres au format <language>_<country>, par en_USexemple .

loginOptions - Options supplémentaires pour la connexion
Alias d’entrée : loginOpts. string. facultatif. Utilisez quand enableRun = true && credsType = inputs.

Arguments supplémentaires passés à l’étape de connexion de Visual Studio App Center.

runOptions - Options supplémentaires pour l’exécution
Alias d’entrée : runOpts. string. facultatif. Utilisez quand enableRun = true.

Arguments supplémentaires passés à l’exécution de test de Visual Studio App Center.

skipWaitingForResults - N’attendez pas le résultat du test
Alias d’entrée : async. boolean. facultatif. Utilisez quand enableRun = true. Valeur par défaut : false.

Exécute une commande de manière asynchrone et se termine lorsque les tests sont chargés sans attendre les résultats des tests.

cliFile - Emplacement de l’interface CLI App Center
Alias d’entrée : cliLocationOverride. string.

Chemin d’accès à l’interface CLI de Visual Studio App Center sur l’agent de build ou de mise en production.

showDebugOutput - Activer la sortie de débogage
Alias d’entrée : debug. boolean. Valeur par défaut : false.

Ajoute --debug à l’interface CLI de Visual Studio App Center.

uitestStoreFile - Fichier store
string. facultatif. Utilisez quand enablePrepare = true && framework = uitest.

Options de contrôle de la tâche

Toutes les tâches ont des options de contrôle en plus de leurs entrées de tâches. Pour plus d’informations, consultez Options de contrôle et propriétés de tâche courantes.

Variables de sortie

Aucun.

Notes

Cette tâche vous permet d’exécuter des suites de tests sur un fichier binaire d’application (fichier .apk ou .ipa ) à l’aide d’App Center Test.

Inscrivez-vous auprès d’App Center d’abord.
Pour plus de détails sur l'utilisation de cette tâche, consultez l'article de la documentation de l'App Center Utilisation d'Azure DevOps pour les tests d'interface utilisateur.

Exemples

Cet exemple exécute des tests Espresso sur une application Android à l’aide de la tâche App Center Test.

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

Configuration requise

Condition requise	Description
Types de pipelines	YAML, build classique
S’exécute sur	Agent, DeploymentGroup
Demandes	None
Capabilities	Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commande	Quelconque
Variables paramétrables	Quelconque
Version de l’agent	2.206.1 ou version ultérieure
Catégorie de la tâche	Test

Condition requise	Description
Types de pipelines	YAML, build classique
S’exécute sur	Agent, DeploymentGroup
Demandes	None
Capabilities	Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commande	Quelconque
Variables paramétrables	Quelconque
Version de l’agent	2.144.0 ou version ultérieure
Catégorie de la tâche	Test

Condition requise	Description
Types de pipelines	YAML, build classique
S’exécute sur	Agent, DeploymentGroup
Demandes	None
Capabilities	Cette tâche ne répond à aucune demande pour les tâches suivantes dans le travail.
Restrictions de commande	Quelconque
Variables paramétrables	Quelconque
Version de l’agent	Toutes les versions d’agent prises en charge.
Catégorie de la tâche	Test

Partager via