Bien démarrer avec UITest et Xamarin.Forms

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
• Présentation de UITest pour Xamarin.Android
• Présentation de 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.

Spécifications

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 UITest aux applications Xamarin.Forms

UITest automatise l’interface utilisateur en activant des contrôles sur l’écran et en fournissant une entrée n’importe 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!" />

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

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’elle a été ajoutée, 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 l’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.

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

Projet d’application Android

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

Écriture de tests UITest

Pour plus d’informations sur l’écriture de tests UITest, consultez Documentation UITest.

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

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 soumettre au test App Center.

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 l’envoi de tests à App Center Test, consultez Soumission d’UITests pour Xamarin.Android ou Envoi de UITests pour Xamarin.iOS. Pour plus d’informations sur UITest, consultez Documentation App Center Test.

Liens connexes

• NUnit