Partager via


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

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 enablePrepare = 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 enablePrepare = true && framework = 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 enablePrepare = true && framework = 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 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 Project
Alias d’entrée : calabashProjectDir. string. Obligatoire lorsque enablePrepare = true && framework = calabash.

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


calabashConfigFile - fichier de configuration concombre
string. Optionnel. Utilisez quand enablePrepare = true && framework = calabash.

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


profil calabashProfile - pour exécuter
string. Optionnel. 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 la configuration
boolean. Optionnel. Utilisez quand enablePrepare = true && framework = 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 enablePrepare = true && framework = 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 enablePrepare = true && framework = 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 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.


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

Signe le serveur de test.


xcUITestBuildDirectory - créer un répertoire
Alias d’entrée : xcuitestBuildDir. string. Optionnel. 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 - tester le chemin IPA
Alias d’entrée : xcuitestTestIpaPath. string. Optionnel. 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. Optionnel. Utilisez quand enablePrepare = 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 enableRun = 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 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. Obligatoire lorsque enableRun = true && credsType = 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 enableRun = true && credsType = 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 enableRun = 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 enableRun = 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 enableRun = 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 enableRun = true.

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


localeOption - langue système
Alias d’entrée : locale. string. Obligatoire 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)), 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 enableRun = true && locale = 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 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. Optionnel. Utilisez quand enableRun = 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 enableRun = 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, DeploymentGroup
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, DeploymentGroup
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, DeploymentGroup
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