Utilisation d’Azure DevOps pour les tests de l’interface utilisateur

Important

La mise hors service de Visual Studio App Center est prévue pour le 31 mars 2025. Bien que vous puissiez continuer à utiliser Visual Studio App Center jusqu’à sa mise hors service complète, il existe plusieurs alternatives recommandées vers lesquelles vous pouvez envisager la migration.

En savoir plus sur les chronologies et les alternatives de support.

Ce guide explique comment modifier votre build Azure Pipelines existante qui crée un fichier binaire d’application (.apk ou .ipa fichier) pour ajouter une tâche de test App Center qui exécute votre suite de tests dans App Center Test.

Azure Pipelines est disponible dans le cadre de Azure DevOps Services. Azure Pipelines vous aide à implémenter un pipeline de build, test et déploiement pour toute application. Pour plus d’informations sur Azure DevOps Services ou Azure Pipelines, consultez la documentation Azure DevOps ou Azure Pipelines, respectivement.

La tâche de test App Center pour Azure Pipelines vous permet d’exécuter vos suites de tests dans App Center Test. Vous pouvez utiliser les frameworks Appium, XCUItest, Espresso et Xamarin.UITest. Pour en savoir plus sur les frameworks, consultez la page Frameworks pris en charge par les tests App Center .

Chaque infrastructure a sa propre section dans ce guide, où vous pouvez en savoir plus sur les exigences de base pour la configuration d’une définition de tâche de test App Center dans Azure Pipelines.

Étapes de configuration générales

Avant de commencer

Vous avez besoin des éléments suivants avant de pouvoir commencer les tests,

• Une build Azure Pipelines qui crée votre fichier binaire d’application (.apk ou fichier .ipa ).
• Un compte de test App Center actif. Vous pouvez activer une version d’évaluation d’App Center Test sur App Center. Sélectionnez d’abord votre application, puis sélectionnez Tester dans le menu de gauche.
• Configurez le pipeline pour utiliser Node 10.x.x. Lisez comment dans la documentation Azure DevOps, la documentation concerne Javascript, mais le principe s’applique également ici.

Configuration générale d’Azure Pipelines

Recherchez votre projet Azure Pipelines et ouvrez-le pour Modifier. Cliquez + pour ajouter une nouvelle tâche, puis recherchez Centre d’application.

Cliquez sur Ajouter en regard de la tâche de test App Center . Sur le côté gauche de l’écran, cliquez sur la tâche De test avec Visual Studio App Center ajoutée pour la sélectionner et la modifier. La tâche de test App Center est divisée en sections.

Dans la section supérieure, insérez le chemin d’accès à votre fichier binaire d’application (.apk ou .ipa) dans le champ Chemin du fichier d’application binaire .

Connexion au test App Center

Connectez-vous à App Center avant d’utiliser le service ; deux méthodes d’authentification sont disponibles.

La première méthode utilise un jeton d’API ; pour acquérir le jeton d’API de votre compte :

• Connectez-vous à App Center et cliquez sur l’icône des paramètres utilisateur dans le coin supérieur gauche du portail App Center.
• Dans le menu qui s’affiche, sélectionnez Paramètres du compte.
• Dans le panneau Paramètres , sélectionnez Jetons d’API.
• Cliquez sur le bouton Nouveau jeton d’API dans le coin supérieur droit du panneau.
• Nommez le nouveau jeton d’API : pour instance, vous pouvez l’appeler Azure DevOps. À l’avenir, ce nom vous aidera à identifier le service qui utilise le service.
• Cliquez sur le bouton Ajouter un nouveau jeton d’API . Une fenêtre contextuelle affiche le nouveau jeton d’API ; cette fenêtre contextuelle est le seul moment où App Center affiche ce jeton. Cliquez sur le bouton du Presse-papiers pour copier le jeton d’API dans le Presse-papiers du navigateur. Enregistrez le jeton d’API quelque part (Azure Key Vault, par exemple) où vous pouvez le référencer de manière sécurisée ultérieurement si nécessaire.

Avec le jeton d’API dans le Presse-papiers :

• Basculez vers votre fenêtre Azure DevOps Services. Dans le champ Connexion App Center , dans la section Exécuter de la tâche de test App Center, cliquez sur le bouton Ajouter .
• Remplissez le champ Nom du formulaire avec un nom approprié pour la connexion (par exemple : App Center).
• Collez le jeton d’API App Center dans le champ jeton d’API .
• Terminez la configuration en cliquant sur Fermer.

Assurez-vous que votre connexion nouvellement créée s’affiche dans le champ Connexion App Center.

La deuxième méthode utilise les informations d’identification de votre compte App Center :

• Sélectionnez Informations d’identification dans le menu déroulant Méthode d’authentification .
• Renseignez les champs Nom d’utilisateur App Center et Mot de passe App Center avec les informations d’identification de votre compte App Center.

Notes

Votre nom d’utilisateur App Center se trouve dans votre profil de compte App Center. Si vous vous connectez à l’aide de vos informations d’identification Microsoft, configurez votre compte avec un mot de passe ou la tâche ne peut pas se connecter. Vous pouvez configurer un mot de passe dans App Center.

Appium

• Avant de créer une série de tests, suivez les étapes de la section Avant de commencer de ce guide.
• Préparez votre dépôt pour App Center Test, test Appium.

Configuration d’Azure Pipelines pour Appium

Commencez par ajouter la tâche de test App Center à la définition de build, comme décrit précédemment dans Configuration générale d’Azure Pipelines.

Dans la section Préparer les tests, vérifiez que la case Préparer les tests est cochée, puis pour Infrastructure de test, sélectionnez Appium Test Framework. Insérez le chemin d’accès à Appium test-classes, dependency-jars et au pom.xml fichier dans le champ Répertoire de build. Ces trois artefacts se trouvent généralement dans le upload dossier .

Vous pouvez maintenant configurer la série de tests. Toutes les informations dont vous avez besoin sont trouvées en créant un nouveau test sous Test dans App Center. Suivez les instructions fournies dans Démarrage d’une série de tests. Laissez la page d’envoi (dernière page de la configuration de la série de tests) ouverte, afin de pouvoir utiliser ces informations lorsque vous configurez la tâche de test App Center.

appcenter test run appium --app "username/appname" --devices 209ed689
 --app-path pathToFile.apk --test-series "main" --locale "en_US"
  --build-dir target/upload

• Sur la page d’envoi, l’application slug est le --app paramètre . Insérez-le dans le champ Application Slug .
• La sélection des appareils est le --devices paramètre . Insérez-le dans le champ Appareils .
• La série de tests est un champ de texte libre. Il peut s’agir de n’importe quoi. Il s’agit du --test-series paramètre .
• La langue système est un menu déroulant. Si Autre est sélectionné, un champ Autres paramètres régionaux s’affiche dans lequel vous pouvez entrer l’indicatif de langue et de pays comme suit : en_US.

Enregistrez la configuration et vous êtes prêt à démarrer la build et l’exécution de test App Center.

Espresso

• Avant de créer une série de tests, suivez les étapes de la section Avant de commencer de ce guide.
• Découvrez comment préparer votre dépôt pour le test App Center, le test Espresso.

Configuration d’Azure Pipelines pour Espresso

Commencez par ajouter la tâche de test App Center à la définition de build, comme décrit précédemment dans Configuration générale d’Azure Pipelines.

Dans la section Préparer les tests, vérifiez que la case Préparer les tests est cochée, puis pour Infrastructure de test, sélectionnez Espresso Test Framework.

Vous pouvez maintenant configurer la série de tests. Toutes les informations dont vous avez besoin sont trouvées en créant un nouveau test sous Test dans App Center. Suivez les instructions fournies dans Démarrage d’une série de tests. Laissez la page d’envoi (dernière page de la configuration de la série de tests) ouverte, afin de pouvoir utiliser ces informations lorsque vous configurez la tâche de test App Center.

appcenter test run espresso --app "username/appname" --devices 209ed689
 --app-path pathToFile.apk --test-series "main" --locale "en_US"
  --build-dir pathToEspressoBuildFolder

• Sur la page d’envoi, l’application slug est le --app paramètre . Insérez-le dans le champ Application Slug .
• La sélection des appareils est le --devices paramètre . Insérez-le dans le champ Appareils .
• La série de tests est un champ de texte libre. Il peut s’agir de n’importe quoi. Il s’agit du --test-series paramètre .
• La langue système est un menu déroulant. Si Autre est sélectionné, un champ Autres paramètres régionaux s’affiche dans lequel vous pouvez entrer l’indicatif de langue et de pays comme suit : en_US.

Enregistrez la configuration et vous êtes prêt à démarrer la build et l’exécution de test App Center.

Xamarin.UITest

• Avant de créer une série de tests, suivez les étapes de la section Avant de commencer de ce guide.
• Découvrez comment préparer votre dépôt Xamarin.Android pour le test App Center et le test Xamarin.UITest.
• Découvrez comment préparer votre dépôt Xamarin.iOS pour le test App Center et le test Xamarin.UITest.

Configuration d’Azure Pipelines pour Xamarin.UITest

Commencez par ajouter la tâche de test App Center à la définition de build, comme décrit précédemment dans Configuration générale d’Azure Pipelines.

Dans la section Préparer les tests, vérifiez que la case Préparer les tests est cochée et que Xamarin UI Ui Test est sélectionné sous Infrastructure de test. Insérez le chemin d’accès à votre répertoire de build ; dans la plupart des cas, le dossier de build est : <ProjectName>/bin/<configuration>.

Vous pouvez maintenant configurer la série de tests. Toutes les informations dont vous avez besoin sont trouvées en créant un nouveau test sous Test dans App Center. Suivez les instructions fournies dans Démarrage d’une série de tests. Laissez la page d’envoi (dernière page de la configuration de la série de tests) ouverte, afin de pouvoir utiliser ces informations lorsque vous configurez la tâche de test App Center.

appcenter test run uitest --app "username/appname" --devices 209ed689
 --app-path pathToFile.apk --test-series "main" --locale "en_US"
  --build-dir pathTUITestBuildDir

• Sur la page d’envoi, l’application slug est le --app paramètre . Insérez-le dans le champ Application Slug .
• La sélection des appareils est le --devices paramètre . Insérez-le dans le champ Appareils .
• La série de tests est un champ de texte libre. Il peut s’agir de n’importe quoi. Il s’agit du --test-series paramètre .
• La langue système est un menu déroulant. Si Autre est sélectionné, un champ Autres paramètres régionaux s’affiche dans lequel vous pouvez entrer l’indicatif de langue et de pays comme suit : en_US.

Enregistrez la configuration et vous êtes prêt à démarrer la build et l’exécution de test App Center.

XCUITest

• Avant de créer une série de tests, suivez les étapes de la section Avant de commencer de ce guide.
• Découvrez comment préparer votre dépôt pour le test App Center, le test XCUITest.

Notes

Dans votre pipeline, avant la tâche de test App Center, vous aurez besoin d’une étape de tâche Xcode avec une action de pour générer l’application d’exécuteur de build-for-testing test nécessaire au test. Dans cette tâche, sous Arguments dans la section Avancé , spécifiez un chemin de données dérivé, généralement à l’aide -derivedDataPath DerivedDatade . Vous aurez également besoin d’un .ipa file pour votre application. Vous pouvez générer le .ipa file dans la même tâche Xcodebuild-for-testing en cochant l’option Create app package , ou dans une étape de génération Xcode distincte ou dans une étape de script Bash .

Configuration d’Azure Pipelines pour XCUITest

Commencez par ajouter la tâche de test App Center à la définition de build, comme décrit précédemment dans Configuration générale d’Azure Pipelines.

Dans la section Préparer les tests, vérifiez que la case Préparer les tests est cochée et que XCUITest est sélectionné sous Infrastructure de test. Insérez le chemin d’accès à votre répertoire de build à partir de l’étape Xcode build-for-testing . En règle générale, le dossier de build est : DerivedData/Build/Products/Debug-iphoneos/.

Vous pouvez maintenant configurer la série de tests. Toutes les informations dont vous avez besoin sont trouvées en créant un nouveau test sous Test dans App Center. Suivez les instructions fournies dans Démarrage d’une série de tests. Laissez la page d’envoi (dernière page de la configuration de la série de tests) ouverte, afin de pouvoir utiliser ces informations lorsque vous configurez la tâche de test App Center.

appcenter test run xcuitest --app "username/appname" --devices 209ed689 --test-series "main" --locale "en_US" --build-dir pathToXCUItestBuildFolder

• Sur la page d’envoi, l’application slug est le --app paramètre . Insérez-le dans le champ Application Slug .
• La sélection des appareils est le --devices paramètre . Insérez-le dans le champ Appareils .
• La série de tests est un champ de texte libre. Il peut s’agir de n’importe quoi. Il s’agit du --test-series paramètre .
• La langue système est un menu déroulant. Si Autre est sélectionné, un champ Autres paramètres régionaux s’affiche dans lequel vous pouvez entrer l’indicatif de langue et de pays comme suit : en_US.

Enregistrez la configuration et vous êtes prêt à démarrer la build et l’exécution de test App Center.