Share via


VSMobileCenterTest@0 - Tâche de test Mobile Center v0

Utilisez cette tâche pour tester des packages d’applications mobiles avec Visual Studio Mobile Center.

Syntax

# Mobile Center Test v0
# Test mobile app packages with Visual Studio Mobile Center.
- task: VSMobileCenterTest@0
  inputs:
    app: # string. Required. Binary Application File Path. 
    artifactsDir: '$(Build.ArtifactStagingDirectory)/MobileCenterTest' # string. Required. Artifacts Directory. Default: $(Build.ArtifactStagingDirectory)/MobileCenterTest.
  # Prepare Tests
    #enablePrepare: true # boolean. Prepare Tests. Default: true.
    framework: 'appium' # 'appium' | 'espresso' | 'calabash' | 'uitest' | 'xcuitest'. Required when enablePrepare = true. Test Framework. Default: appium.
    #appiumBuildDir: # string. Required when enablePrepare = true && framework = appium. Build Directory. 
    #espressoBuildDir: # string. Optional. Use when enablePrepare = true && framework = espresso. Build Directory. 
    #espressoTestApkPath: # string. Optional. Use when enablePrepare = true && framework = espresso. Test APK Path. 
    #calabashProjectDir: # string. 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.
    #uitestBuildDir: # string. Required when enablePrepare = true && framework = uitest. Build Directory. 
    #uitestStoreFile: # string. Optional. Use when enablePrepare = true && framework = uitest. Store File. 
    #uitestStorePass: # string. Optional. Use when enablePrepare = true && framework = uitest. Store Password. 
    #uitestKeyAlias: # string. Optional. Use when enablePrepare = true && framework = uitest. Key Alias. 
    #uitestKeyPass: # string. Optional. Use when enablePrepare = true && framework = uitest. Key Password. 
    #uitestToolsDir: # string. Optional. Use when enablePrepare = true && framework = uitest. Test Tools Directory. 
    #signInfo: # string. Optional. Use when framework = calabash || framework = uitest. Signing Information. 
    #xcuitestBuildDir: # string. Optional. Use when enablePrepare = true && framework = xcuitest. Build Directory. 
    #xcuitestTestIpaPath: # string. Optional. Use when enablePrepare = true && framework = xcuitest. Test IPA Path. 
    #prepareOpts: # string. Optional. Use when enablePrepare = true. Additional Options. 
  # Run Tests
    #enableRun: true # boolean. Run Tests. Default: true.
    credsType: 'serviceEndpoint' # 'serviceEndpoint' | 'inputs'. Required when enableRun = true. Authentication Method. Default: serviceEndpoint.
    #serverEndpoint: # string. Required when enableRun = true && credsType = serviceEndpoint. Mobile Center Connection. 
    #username: # string. Required when enableRun = true && credsType = inputs. Mobile Center Username. 
    #password: # string. Required when enableRun = true && credsType = inputs. Mobile 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.
    #dsymDir: # string. Optional. Use when enableRun = true. dSYM Directory. 
    locale: 'en_US' # 'da_DK' | 'nl_NL' | 'en_GB' | 'en_US' | 'fr_FR' | 'de_DE' | 'ja_JP' | 'ru_RU' | 'es_MX' | 'es_ES' | 'user'. Required when enableRun = true. System Language. Default: en_US.
    #userDefinedLocale: # string. Optional. Use when enableRun = true && locale = user. Other Locale. 
    #loginOpts: # string. Optional. Use when enableRun = true && credsType = inputs. Addtional Options for Login. 
    #runOpts: # string. Optional. Use when enableRun = true. Additional Options for Run. 
    #async: false # boolean. Optional. Use when enableRun = true. Do not wait for test result. Default: false.
  # Advanced
    #cliLocationOverride: # string. mobile-center CLI Location. 
    #debug: false # boolean. Enable Debug Output. Default: false.

Entrées

app - Chemin du fichier d’application binaire
string. Obligatoire.

Spécifie le chemin d’accès relatif de la racine du dépôt au . APK ou . Fichier IPA que vous souhaitez tester.


artifactsDir - Répertoire des artefacts
string. Obligatoire. Valeur par défaut : $(Build.ArtifactStagingDirectory)/MobileCenterTest.

Spécifie le répertoire pour placer les artefacts qui sont produits par l’étape de préparation et utilisés par l’étape d’exécution. Le répertoire est créé s’il n’existe pas.


enablePrepare - Préparer les tests
boolean. Valeur par défaut : true.

Si la valeur trueest définie sur , prépare les tests.


framework - Infrastructure de test
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.

Spécifie l’infrastructure de test que la tâche utilisera.


appiumBuildDir - Répertoire de build
string. Nécessaire lorsque enablePrepare = true && framework = appium.

Spécifie le chemin d’accès au répertoire qui contient les tests Appium.


espressoBuildDir - Répertoire de build
string. facultatif. Utilisez quand enablePrepare = true && framework = espresso.

Spécifie le chemin d’accès pour le répertoire de sortie Espresso.


espressoTestApkPath - Test APK Path
string. facultatif. Utilisez quand enablePrepare = true && framework = espresso.

Spécifie le chemin d’accès au fichier APK avec des tests Espresso. Si aucune valeur n’est définie, build-dir est utilisée pour rechercher le fichier APK. Les caractères génériques sont autorisés.


calabashProjectDir - Répertoire du projet
string. Nécessaire lorsque enablePrepare = true && framework = calabash.

Spécifie le chemin d’accès pour le répertoire de l’espace de travail Calabash.


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

Spécifie le chemin d’accès au fichier de configuration Concombre, qui est généralement cucumber.yml.


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

Spécifie le 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.

Force l’exécution de la tâche sans profil Concombre.


uitestBuildDir - Répertoire de build
string. Nécessaire lorsque enablePrepare = true && framework = uitest.

Spécifie le chemin d’accès au répertoire avec des assemblys de test générés.


uitestStoreFile - Stocker le fichier
string. facultatif. Utilisez quand enablePrepare = true && framework = uitest.

Spécifie le chemin d’accès au fichier de magasin.


uitestStorePass - Stocker le mot de passe
string. facultatif. Utilisez quand enablePrepare = true && framework = uitest.

Spécifie le mot de passe du fichier de magasin. Pour chiffrer cette valeur, utilisez une nouvelle variable en activant son verrou 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.


uitestKeyPass - Mot de passe de clé
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 en activant son verrou sous l’onglet Variables.


uitestToolsDir - répertoire Outils de test
string. facultatif. Utilisez quand enablePrepare = true && framework = uitest.

Spécifie le chemin d’accès au répertoire avec les outils de test de l’interface utilisateur Xamarin qui contient test-cloud.exe.


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

Utilise les informations de signature pour signer le serveur de test.


xcuitestBuildDir - Répertoire de build
string. facultatif. Utilisez quand enablePrepare = true && framework = xcuitest.

Spécifie le chemin d’accès au répertoire de sortie de build, qui est généralement $(ProjectDir)/Build/Products/Debug-iphoneos.


xcuitestTestIpaPath - Chemin d’accès IPA de test
string. facultatif. Utilisez quand enablePrepare = true && framework = xcuitest.

Spécifie le chemin d’accès au *.ipa fichier avec les tests XCUITest.


prepareOpts - Options supplémentaires
string. facultatif. Utilisez quand enablePrepare = true.

Spécifie des arguments supplémentaires à passer à mobile-center test prepare step.


enableRun - Exécuter des tests
boolean. Valeur par défaut : true.


credsType - Méthode d’authentification
string. Nécessaire lorsque enableRun = true. Valeurs autorisées : serviceEndpoint (Connexion Mobile Center), inputs (Informations d’identification). Valeur par défaut : serviceEndpoint.

Spécifie la méthode d’authentification. Utilisez une connexion de point de terminaison de service Mobile Center ou spécifiez les informations d’identification pour vous connecter à Visual Studio Mobile Center.


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

Spécifie le point de terminaison de service pour votre connexion Visual Studio Mobile Center. Pour en créer un, cliquez sur le lien Gérer et créez un point de terminaison de service.


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

Visitez Azure Mobile Center pour définir votre nom d’utilisateur.


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

Visitez Azure Mobile Center pour définir votre mot de passe. Cette chaîne peut accepter une variable définie dans les définitions de build/mise en production en tant que $(passwordVariable). Vous pouvez marquer le type de variable comme secret pour le sécuriser.


appSlug - Application Slug
string. Nécessaire lorsque enableRun = true.

Le slug d’application est au format de {username}/{app_identifier}. Pour localiser {username} et {app_identifier} pour une application, recherchez la description de l’application sur Azure Mobile Apps. L’URL se présente au format suivant : https://mobile.azure.com/users/{username}/apps/{app_identifier}


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

Identifie sur quels appareils 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 Mobile Center.


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

Spécifie le nom de la série pour l’organisation des séries de tests (par exemple master, , productionbeta).


dsymDir - Répertoire dSYM
string. facultatif. Utilisez quand enableRun = true.

Spécifie le chemin d’accès au répertoire dSYM, qui contient les fichiers de symboles iOS.


locale - Langue système
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)), ja_JP (Japonais (Japon)), ru_RU (Russe (Russie)), es_MX (Espagnol (Mexique)), es_ES (Espagnol (Espagne)), user (Autre). Valeur par défaut : en_US.

Si votre langue n’est pas affichée, spécifiez 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.

Spécifie tout code de langue ISO-639 à deux lettres, ainsi que tout code de pays ISO 3166 à deux lettres, au format [language]_[country], par exemple en_US.


loginOpts - Options supplémentaires pour la connexion
string. facultatif. Utilisez quand enableRun = true && credsType = inputs.

Spécifie des arguments supplémentaires qui sont passés à mobile-center login step.


runOpts - Options supplémentaires pour exécuter
string. facultatif. Utilisez quand enableRun = true.

Spécifie des arguments supplémentaires qui sont passés à mobile-center test run.


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

Quand la valeur est définie sur true, exécute les commandes de manière asynchrone et se ferme lorsque les tests sont chargés sans attendre les résultats des tests.


cliLocationOverride - Emplacement de l’interface CLI mobile-center
string.

Spécifie le chemin d’accès à l’interface mobile-center de ligne de commande (CLI).


debug - Activer la sortie de débogage
boolean. Valeur par défaut : false.

Ajoute --debug à l’interface mobile-center de ligne de commande (CLI).


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.

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 Toutes les versions d’agent prises en charge.
Catégorie de la tâche Test