Prise en main d’UITest et de Xamarin.Forms

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.

UITest peut être utilisé avec Xamarin.Forms pour écrire des tests d’interface utilisateur à exécuter dans le cloud sur des centaines d’appareils.

Vue d’ensemble

App Center Test permet aux développeurs d’écrire des tests d’interface utilisateur automatisés pour les applications Android et iOS. Avec quelques modifications mineures, les applications Xamarin.Forms peuvent être testées à l’aide de Xamarin.UITest, avec le partage du même code de test. Cet article présente des conseils spécifiques pour que Xamarin.UITest fonctionne avec Xamarin.Forms.

Ce guide part du principe que vous connaissez Xamarin.UITest. Les guides suivants sont recommandés pour se familiariser avec Xamarin.UITest :

• Introduction à App Center Test
• Introduction à UITest pour Xamarin.Android
• Présentation d’UITest pour Xamarin.iOS

Une fois qu’un projet UITest a été ajouté à une solution Xamarin.Forms, les étapes de l’écriture et de l’exécution des tests pour une application Xamarin.Forms sont les mêmes que pour une application Xamarin.Android ou Xamarin.iOS.

Configuration requise

Reportez-vous à Xamarin.UITest pour confirmer que votre projet est prêt pour les tests automatisés de l’interface utilisateur.

Ajout de la prise en charge d’UITest aux applications Xamarin.Forms

UITest automatise l’interface utilisateur en activant les contrôles à l’écran et en fournissant des entrées partout où un utilisateur interagirait normalement avec l’application. Pour activer des tests qui peuvent appuyer sur un bouton ou entrer du texte dans une zone, le code de test a besoin d’un moyen d’identifier les contrôles à l’écran.

Pour permettre au code UITest de référencer des contrôles, chaque contrôle a besoin d’un identificateur unique. Dans Xamarin.Forms, la méthode recommandée pour définir cet identificateur est d’utiliser la propriété AutomationId comme indiqué ci-dessous :

var b = new Button {
    Text = "Click me",
    AutomationId = "MyButton"
};
var l = new Label {
    Text = "Hello, Xamarin.Forms!",
    AutomationId = "MyLabel"
};

La propriété AutomationId peut également être définie en XAML :

<Button x:Name="b" AutomationId="MyButton" Text="Click me"/>
<Label x:Name="l" AutomationId="MyLabel" Text="Hello, Xamarin.Forms!" />

Notes

AutomationId est une BindableProperty et peut donc être aussi définie avec une expression de liaison.

Une valeur AutomationId unique doit être ajoutée à tous les contrôles requis pour les tests (notamment les boutons, entrées de texte et étiquettes dont la valeur peut être interrogée).

Avertissement

Un InvalidOperationException est levée si une tentative est effectuée pour définir la AutomationId propriété d’un Element plusieurs fois.

Projet d’application iOS

Pour exécuter des tests sur iOS, le package NuGet de l’agent cloud de test Xamarin doit être ajouté au projet. Une fois qu’il a été ajouté, copiez le code suivant dans la AppDelegate.FinishedLaunching méthode :

#if ENABLE_TEST_CLOUD
// requires Xamarin Test Cloud Agent
Xamarin.Calabash.Start();
#endif

L’assembly Calabash utilise des API Apple non publiques, ce qui entraîne le rejet des applications par le App Store. Toutefois, l’éditeur de liens Xamarin.iOS supprimera l’assembly Calabash de la dernière IPA s’il n’est pas explicitement référencé à partir du code.

Notes

Par défaut, les builds release n’ont pas la ENABLE_TEST_CLOUD variable du compilateur, ce qui entraîne la suppression de l’assembly Calabash du bundle d’applications. Toutefois, les builds de débogage ont la directive du compilateur définie par défaut, ce qui empêche l’éditeur de liens de supprimer l’assembly.

La capture d’écran suivante affiche la variable de compilateur ENABLE_TEST_CLOUD définie pour les versions Debug :

Visual Studio

de Visual Studio

Visual Studio pour Mac

Projet d’application Android

Contrairement à iOS, les projets Android n’ont pas besoin de code de démarrage spécial.

Écriture de tests UITest

Pour plus d’informations sur l’écriture de tests UITest, consultez Documentation UITest. Les étapes ci-dessous sont un récapitulatif décrivant plus précisément comment la démonstration Xamarin.Forms UsingUITest est générée.

Utiliser AutomationId dans l’interface utilisateur Xamarin.Forms

Avant de pouvoir écrire tout test UITest, l’interface utilisateur de l’application Xamarin.Forms doit pouvoir contenir des scripts. Vérifiez que tous les contrôles dans l’interface utilisateur ont une valeur AutomationId afin de pouvoir être référencés dans le code de test.

Référence à AutomationId dans les tests UITest

Lors de l’écriture de tests UITest, la valeur AutomationId est exposée différemment sur chaque plateforme :

• iOS utilise le champ id.
• Android utilise le champ label.

Pour écrire des tests UITest multiplateformes qui recherchent la valeur AutomationId à la fois sur iOS et Android, utilisez la requête de test Marked :

app.Query(c=>c.Marked("MyButton"))

La forme abrégée app.Query("MyButton") fonctionne également.

Ajout d’un projet UITest à une solution existante

Visual Studio

Visual Studio propose un modèle qui permet d’ajouter un projet Xamarin.UITest à une solution Xamarin.Forms existante :

1. Cliquez avec le bouton droit sur la solution, puis sélectionnez Fichier > Nouveau projet.

2. Dans les modèles Visual C#, sélectionnez la catégorie Test. Sélectionnez le modèle application de test d’interface > utilisateur multiplateforme :

   

   Cette étape ajoute un nouveau projet avec les packages NuGet NUnit, Xamarin.UITest et NUnitTestAdapter à la solution :

   

   NUnitTestAdapter est un exécuteur de test tiers qui permet à Visual Studio d’exécuter des tests NUnit à partir de Visual Studio.

   Le nouveau projet comporte également deux classes. AppInitializer contient du code pour aider à initialiser et configurer les tests. L’autre classe, Tests, contient un code réutilisable pour aider à démarrer les tests UITest.

3. Ajoutez une référence de projet à partir du projet UITest au projet Xamarin.Android :

   

   Cette étape permet à NUnitTestAdapter d’exécuter les UITests pour l’application Android à partir de Visual Studio.

Visual Studio pour Mac

Il est possible d’ajouter un nouveau projet Xamarin.UITest à une solution existante manuellement :

1. Commencez par ajouter un nouveau projet. Cliquez avec le bouton droit sur la solution Ajouter un > nouveau projet. Dans la boîte de dialogue Nouveau projet, sélectionnez Application de test de l’interface utilisateur de test > multiplateforme > Test > App Center :

   

   Cette étape ajoute un nouveau projet qui contient déjà les packages NuGet NUnit et Xamarin.UITest dans la solution :

   

   Le nouveau projet comporte également deux classes. AppInitializer contient du code pour aider à initialiser et configurer les tests. L’autre classe, Tests, contient un code réutilisable pour aider à démarrer les tests UITest.

2. Sélectionnez Afficher les > tests pour afficher le panneau Test unitaire. Développez UsingUITest > UsingUITest.UITests > Test Apps :

   Pad

3. Cliquez avec le bouton droit sur Applications de test, cliquez sur Ajouter un projet d’application, puis sélectionnez projets iOS et Android dans la boîte de dialogue qui s’affiche :

   

   Le bloc Tests unitaires doit maintenant comporter une référence aux projets iOS et Android. Cette référence permet à l’exécuteur de test Visual Studio pour Mac d’exécuter des tests UITests localement sur les deux projets Xamarin.Forms.

Ajout d’UITest à l’application iOS

Quelques modifications supplémentaires doivent être apportées à l’application iOS avant que Xamarin.UITest fonctionne :

1. Ajoutez le paquet NuGet Xamarin.TestCloud.Agent. Cliquez avec le bouton droit sur Packages, sélectionnez Ajouter des packages, recherchez nuGet l’agent cloud de test Xamarin et ajoutez-le au projet Xamarin.iOS :

   

2. Modifiez la FinishedLaunching méthode de la classe AppDelegate du projet pour initialiser l’agent cloud de test Xamarin au démarrage de l’application iOS et pour définir la AutomationId propriété des vues. La méthode FinishedLaunching doit ressembler à l’exemple de code suivant :

public override bool FinishedLaunching(UIApplication app, NSDictionary options)
{
    #if ENABLE_TEST_CLOUD
    Xamarin.Calabash.Start();
    #endif

    global::Xamarin.Forms.Forms.Init();

    LoadApplication(new App());

    return base.FinishedLaunching(app, options);
}

Après avoir ajouté Xamarin.UITest à la solution Xamarin.Forms, il est possible de créer des UITests, de les exécuter localement et de les envoyer à App Center Test.

Résumé

Les applications Xamarin.Forms peuvent être facilement testées avec Xamarin.UITest à l’aide d’un mécanisme simple permettant d’exposer AutomationId comme identificateur de vue unique pour l’automatisation de test. Une fois qu’un projet UITest a été ajouté à une solution Xamarin.Forms, les étapes de l’écriture et de l’exécution des tests pour une application Xamarin.Forms sont les mêmes que pour une application Xamarin.Android ou Xamarin.iOS.

Pour plus d’informations sur la façon de soumettre des tests à App Center Test, consultez Envoi d’UITests pour Xamarin.Android ou Envoi d’UITests pour Xamarin.iOS. Pour plus d’informations sur UITest, consultez Documentation App Center Test.

Liens connexes

• UITestSample
• NUnit