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

Tester les packages d’application avec Visual Studio App Center.

Syntaxe

# 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 prepareTests = true. Test framework. Default: appium.
    #appiumBuildDirectory: # string. Alias: appiumBuildDir. Required when prepareTests = true && frameworkOption = appium. Build directory. 
    #espressoBuildDirectory: # string. Alias: espressoBuildDir. Optional. Use when prepareTests = true && frameworkOption = espresso. Build directory. 
    #espressoTestApkFile: # string. Alias: espressoTestApkPath. Optional. Use when prepareTests = true && frameworkOption = espresso. Test APK path. 
    #calabashProjectDirectory: # string. Alias: calabashProjectDir. Required when prepareTests = true && frameworkOption = calabash. Project directory. 
    #calabashConfigFile: # string. Optional. Use when prepareTests = true && frameworkOption = calabash. Cucumber config file. 
    #calabashProfile: # string. Optional. Use when prepareTests = true && frameworkOption = calabash. Profile to run. 
    #calabashSkipConfigCheck: false # boolean. Optional. Use when prepareTests = true && frameworkOption = calabash. Skip Configuration Check. Default: false.
    #uiTestBuildDirectory: # string. Alias: uitestBuildDir. Required when prepareTests = true && frameworkOption = uitest. Build directory. 
    #uitestStorePath: # string. Optional. Use when prepareTests = true && frameworkOption = uitest. Store file. 
    #uiTestStorePassword: # string. Alias: uitestStorePass. Optional. Use when prepareTests = true && frameworkOption = uitest. Store password. 
    #uitestKeyAlias: # string. Optional. Use when prepareTests = true && frameworkOption = uitest. Key alias. 
    #uiTestKeyPassword: # string. Alias: uitestKeyPass. Optional. Use when prepareTests = true && frameworkOption = uitest. Key password. 
    #uiTestToolsDirectory: # string. Alias: uitestToolsDir. Optional. Use when prepareTests = true && frameworkOption = uitest. Test tools directory. 
    #signInfo: # string. Optional. Use when frameworkOption = calabash || frameworkOption = uitest. Signing information. 
    #xcUITestBuildDirectory: # string. Alias: xcuitestBuildDir. Optional. Use when prepareTests = true && frameworkOption = xcuitest. Build directory. 
    #xcUITestIpaFile: # string. Alias: xcuitestTestIpaPath. Optional. Use when prepareTests = true && frameworkOption = xcuitest. Test IPA path. 
    #prepareOptions: # string. Alias: prepareOpts. Optional. Use when prepareTests = true. Additional options. 
  # Run Tests
    #runTests: true # boolean. Alias: enableRun. Run tests. Default: true.
    credentialsOption: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Alias: credsType. Required when runTests = true. Authentication method. Default: serviceEndpoint.
    #serverEndpoint: # string. Required when runTests = true && credentialsOption = serviceEndpoint. App Center service connection. 
    #username: # string. Required when runTests = true && credentialsOption = inputs. App Center username. 
    #password: # string. Required when runTests = true && credentialsOption = inputs. App Center password. 
    appSlug: # string. Required when runTests = true. App slug. 
    devices: # string. Required when runTests = true. Devices. 
    #series: 'master' # string. Optional. Use when runTests = true. Test series. Default: master.
    #dsymDirectory: # string. Alias: dsymDir. Optional. Use when runTests = 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 runTests = true. System language. Default: en_US.
    #userDefinedLocale: # string. Optional. Use when runTests = true && localeOption = user. Other locale. 
    #loginOptions: # string. Alias: loginOpts. Optional. Use when runTests = true && credentialsOption = inputs. Additional options for login. 
    #runOptions: # string. Alias: runOpts. Optional. Use when runTests = true. Additional options for run. 
    #skipWaitingForResults: false # boolean. Alias: async. Optional. Use when runTests = 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 d’accès au fichier d’application binaire
Alias d’entrée : app. string. Obligatoire.

Chemin relatif de la racine du dépôt vers le fichier APK ou IPA que vous souhaitez tester.


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

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


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

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


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


appiumBuildDirectory - créer un répertoire
Alias d’entrée : appiumBuildDir. string. Obligatoire lorsque prepareTests = true && frameworkOption = appium.

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


espressoBuildDirectory - créer un répertoire
Alias d’entrée : espressoBuildDir. string. Optionnel. Utilisez quand prepareTests = true && frameworkOption = espresso.

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


espressoTestApkFile - Tester le chemin APK
Alias d’entrée : espressoTestApkPath. string. Optionnel. Utilisez quand prepareTests = true && frameworkOption = 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 Project
Alias d’entrée : calabashProjectDir. string. Obligatoire lorsque prepareTests = true && frameworkOption = calabash.

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


calabashConfigFile - fichier de configuration concombre
string. Optionnel. Utilisez quand prepareTests = true && frameworkOption = calabash.

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


profil calabashProfile - pour exécuter
string. Optionnel. Utilisez quand prepareTests = true && frameworkOption = calabash.

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


calabashSkipConfigCheck - Ignorer la vérification de la configuration
boolean. Optionnel. Utilisez quand prepareTests = true && frameworkOption = calabash. Valeur par défaut : false.

Lorsqu’elle est définie sur true, cette entrée ignore la vérification de configuration spécifiée par le profil Concombre.


uiTestBuildDirectory - créer un répertoire
Alias d’entrée : uitestBuildDir. string. Obligatoire lorsque prepareTests = true && frameworkOption = uitest.

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


uitestStorePath - store de fichiers
string. Optionnel. Utilisez quand prepareTests = true && frameworkOption = uitest.

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


uiTestStorePassword - Store de mot de passe
Alias d’entrée : uitestStorePass. string. Optionnel. Utilisez quand prepareTests = true && frameworkOption = 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.


alias de clé uitestKeyAlias -
string. Optionnel. Utilisez quand prepareTests = true && frameworkOption = 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. Optionnel. Utilisez quand prepareTests = true && frameworkOption = uitest.

Spécifie le mot de passe de clé pour l’alias et le fichier de stockage. 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. Optionnel. Utilisez quand prepareTests = true && frameworkOption = 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. Optionnel. Utilisez quand frameworkOption = calabash || frameworkOption = uitest.

Signe le serveur de test.


xcUITestBuildDirectory - créer un répertoire
Alias d’entrée : xcuitestBuildDir. string. Optionnel. Utilisez quand prepareTests = true && frameworkOption = xcuitest.

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


xcUITestIpaFile - tester le chemin IPA
Alias d’entrée : xcuitestTestIpaPath. string. Optionnel. Utilisez quand prepareTests = true && frameworkOption = xcuitest.

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


prepareOptions - options supplémentaires
Alias d’entrée : prepareOpts. string. Optionnel. Utilisez quand prepareTests = true.

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.


méthode d’authentification credentialsOption -
Alias d’entrée : credsType. string. Obligatoire lorsque runTests = true. Valeurs autorisées : serviceEndpoint (connexion du service App Center), inputs (informations d’identification). Valeur par défaut : serviceEndpoint.

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


serverEndpoint - de connexion au service App Center
string. Obligatoire lorsque runTests = true && credentialsOption = 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. Obligatoire lorsque runTests = true && credentialsOption = inputs.

Créez votre nom d’utilisateur en visitant la page de connexion App Center, puis fournissez la valeur ici.


password - mot de passe App Center
string. Obligatoire lorsque runTests = true && credentialsOption = inputs.

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


appSlug - de l’application
string. Obligatoire lorsque runTests = true.

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


devices - Appareils
string. Obligatoire lorsque runTests = true.

Identifie les appareils sur utilisant ce test. Copiez et collez cette chaîne lorsque vous définissez une nouvelle exécution de test à partir de la balise test Visual Studio App Center.


series - série de tests
string. Optionnel. Utilisez quand runTests = true. Valeur par défaut : master.

Nom de la série pour organiser les exécutions de test (par exemple : master, production, bêta).


dsymDirectory - répertoire dSYM
Alias d’entrée : dsymDir. string. Optionnel. Utilisez quand runTests = true.

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


localeOption - langue système
Alias d’entrée : locale. string. Obligatoire lorsque runTests = 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)), fr_FR (Français (France)), ja_JPfr_FR (Allemand (Allemagne)), es_MX (Japonais (Japon)), es_ES (Russe (Russie)), user (Espagnol (Mexique)), (Espagnol (Espagne)), (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. Optionnel. Utilisez quand runTests = true && localeOption = user.

Entre tout code de langue ISO-639 à deux lettres, ainsi que tout code de pays ISO 3166 à deux lettres au format <language>_<country>, tel que en_US.


loginOptions - Options supplémentaires pour les de connexion
Alias d’entrée : loginOpts. string. Optionnel. Utilisez quand runTests = true && credentialsOption = 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. Optionnel. Utilisez quand runTests = true.

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


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

Exécute une commande de manière asynchrone et se ferme 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.


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.

Remarques

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

Exemples

Cet exemple exécute des tests Espresso sur une application Android à l’aide de la tâche de test 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

Spécifications

Besoin Descriptif
Types de pipelines YAML, build classique
Exécutions sur Agent, Groupe de déploiement
demandes Aucun
fonctionnalités de Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
restrictions de commande N'importe quel
variables settables N'importe quel
Version de l’agent 2.206.1 ou version ultérieure
Catégorie de tâche Essai
Besoin Descriptif
Types de pipelines YAML, build classique
Exécutions sur Agent, Groupe de déploiement
demandes Aucun
fonctionnalités de Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
restrictions de commande N'importe quel
variables settables N'importe quel
Version de l’agent 2.144.0 ou version ultérieure
Catégorie de tâche Essai
Besoin Descriptif
Types de pipelines YAML, build classique
Exécutions sur Agent, Groupe de déploiement
demandes Aucun
fonctionnalités de Cette tâche ne répond à aucune demande de tâches ultérieures dans le travail.
restrictions de commande N'importe quel
variables settables N'importe quel
Version de l’agent Toutes les versions de l’agent prises en charge.
Catégorie de tâche Essai