Premiers pas avec les API d’automatisation mobile

Ce guide de démarrage rapide vous aide à créer votre première automatisation codée, à l’aide d’API d’automatisation mobile. Le tutoriel utilise l’application UiPath® Android Basic App et un émulateur Google pixels de Sauce Labs pour les tests automatisés.

1. Ajouter l’appareil mobile et l’application dans le gestionnaire d’appareils mobiles

Pour utiliser l’appareil mobile et l’application souhaités dans notre automatisation codée, nous devons d’abord les créer dans le gestionnaire d’appareils mobiles :

1. Pour créer l’application :
   1. Dans le gestionnaire d’appareils mobiles, accédez à Applications.
   2. Sélectionnez Ajouter une application (Add an application).
   3. Dans la fenêtre Modifier l’application (Edit application), saisissez les informations requises :
      1. Nom (Name) : pour cet exemple, utilisez Basic App - Android.
      2. Type : sélectionnez App pour une application native.
      3. Plate-forme (Platform) : sélectionnez Android pour automatiser l’application Android.
      4. Application : pour cet exemple, saisissez le lien suivant vers l’application Basic Android App : https://uipathtestappsto.blob.core.windows.net/testapps/BasicAppAndroid.apk.
      5. Package d’application (App Package) : saisissez le package d’application mobile, par exemple com.example.basicapp.
      6. Activité de l’application (App activity) : saisissez l’instance de l’activité, par exemple : .core.MainActivity.
      7. Pour Capacités supplémentaires souhaitées (Additional Desired Capabilities), ajoutez la capacité appium:app pour vous assurer que l’application fonctionne comme prévu.

      Tableau 1. Capacités supplémentaires souhaitées

      Nom	Valeur (Value)
      appium:app	appium:app https://uipathtestappsto.blob.core.windows.net/testapps/BasicAppAndroid.apk

   
   

   

   
   
2. Pour créer l’appareil :
   1. Accédez à Appareils (Devices) et sélectionnez Ajouter un appareil (Add a device).
   2. Nommez l’appareil. Pour cet exemple, utilisez Google Pixel 3a GoogleAPI Emulator.
   3. Définissez les paramètres suivants : URL Appium (Appium URL), Plate-forme (Platform), Nom de l’appareil (Device Name), Version de la plate-forme (Platform Version).
      1. Récupérez les paramètres de votre fournisseur de parc d’appareils mobiles choisi. Dans cet exemple, nous utilisons Sauce Labs.
      2. Pour obtenir l’URL Appium (Appium Url), accédez à Compte (Account), puis Paramètres utilisateur (User Settings). Copiez l’URL à la demande (On-demand URL) sous Création de pilote (Driver Creation).
      3. Pour obtenir la plate-forme (Platform), le nom de l’appareil (Device Name) et la version de la plate-forme (Platform Version), accédez à Automatisé (Automated), puis Configurateur de plate-forme (Platform Configurator). Sélectionnez les capacités pour Google Pixel 3a GoogleAPI Emulator et Android Emulator version 10.0. Sous Script de configuration (Config Script), choisissez votre Appium version. Pour cet exemple, utilisez 2.0.0.
      4. Copiez et collez les valeurs de Sauce Labs dans le gestionnaire d’appareils mobiles.
      5. 
         

         

         
         
   4. Cliquez sur Enregistrer et fermer (Save and Close).
   5. Sélectionnez Démarrer une application sur cet appareil (Start an application on this device) et connectez l’appareil à l’application créée précédemment.

2. Créer votre référentiel d’objets pour l’application mobile

Pour automatiser votre application mobile préférée, enregistrez ses éléments mobiles dans le référentiel d’objets du projet. Pour cet exemple, nous avons créé une Basic App avec un écran d’accueil général, contenant trois éléments d’IU que nous utilisons à des fins d’automatisation. Consultez la liste suivante pour voir comment s’affiche la structure du référentiel d’objets :

• BasicApp
  • HomeScreen
    • EditText
    • SingleClickButton
    • VerifyText
  
  

  

  
  

3. Établir une connexion

Après avoir configuré votre appareil et votre application dans le gestionnaire d’appareils mobiles, commencez à écrire le code pour votre automatisation. Avant de commencer à utiliser les API d’automatisation mobile, vous devez établir une connexion entre l’appareil mobile que vous avez choisi et l’application à l’aide des API correspondantes.

Un objet connection est une classe qui représente la connexion que vous créez entre un appareil et une application, qui affiche les API que vous pouvez utiliser pour automatiser les scénarios de test sur mobile. Consultez Connexion pour plus d’informations sur la création d’un objet connection.

Pour créer une connexion, vous disposez d’un ensemble d’API dédiées que vous pouvez utiliser. Dans cet exemple, nous avons utilisé l’API Connecter (Connect), avec la deuxième surcharge, qui requiert les noms d’appareil et d’application sous forme de chaînes.

Créez la connexion en procédant comme suit :

1. Commencez par une instruction using pour éviter de créer une variable distincte.
2. Dans l’instruction using, appelez l’API Connecter (Connect), avec la deuxième version de surcharge.

   Pour cette surcharge, saisissez le nom du périphérique et le nom de l’application, pour établir la connexion.

   [TestCase]
           public void Execute()
           {
           using (Connection connection = mobile.Connect(
               "Google Pixel 3a GoogleAPI Emulator", 
               "Basic App - Android"))

3. Vous pouvez ajouter un message Log à des fins de débogage.

   Log("Connection established");

4. Commencer à automatiser l’application mobile et l’appareil mobile

Le flux d’automatisation dans cet exemple comprend le fait d’appuyer sur certains boutons, l’obtention d’un texte qui s’affiche sur l’écran mobile et le fait de balayer un contrôle de curseur. Ces actions simulent des scénarios d’automatisation mobile réels.

Pour automatiser les éléments d’IU de cet exemple, nous avons utilisé IElementDescriptors. Il s’agit d’éléments d’IU accessibles directement depuis le référentiel d’objets. En plus de IElementDescriptors, vous pouvez utiliser d’autres types de sélecteurs avec les API d’automatisation mobile, tels que ObjectRepositoryTarget et SelectorTarget. Consultez la page Sélecteurs d’API pour savoir comment et quand utiliser d’autres types de sélecteurs.

1. Appelez l’API Appuyer (Tap) pour cliquer sur SingleClickButton dans l’application Android Basic App.

   // Tap the SingleClickButton
               connection.Tap(Descriptors.BasicApp.HomeScreen.SingleClickButton);
               Log("Tapped SingleClickButton ");

2. Utilisez l’API DéfinirTexte (SetText) pour saisir un texte spécifique dans le champ EditText.

   string expectText = "Random text";
               connection.SetText(Descriptors.BasicApp.HomeScreen.EditText, expectText);
               Log("Inserted random text");

3. Récupérez le texte que vous avez défini précédemment et vérifiez s’il correspond au texte de l’élément d’IU VérifierTexte (VerifyText). Utilisez les API ObtenirTexte (GetText) et VérifierExpression (VerifyExpression).

   var actualText = connection.GetText(Descriptors.BasicApp.HomeScreen.VerifyText);
               testing.VerifyExpression(expectText == actualText, "EditText validation failed.");
               SelectorTarget selector = null;

4. Utilisez l’API BalayagePositionnel (PositionalSwipe) pour déplacer le contrôle du curseur.
   L’API BalayagePositionnel (PositionalSwipe) nécessite deux variables Point, représentant les points de départ et de fin de l’action de balayage. Créez ces points avant d’utiliser l’API pour une meilleure lisibilité.

   // Perform a positional swipe operation to use the slider
   
               var startPoint = new Point(226, 304);
               var endPoint = new Point(296, 304);
               
               connection.PositionalSwipe(startPoint, endPoint);
   
               Log("Performed Swipe action.");

   Pour obtenir la position d’écran, accédez à la connexion active dans le gestionnaire d’appareils mobiles. Placez votre curseur sur l’écran mobile. Cela affichera l’emplacement du curseur en pixels dans le coin inférieur gauche du gestionnaire d’appareils mobiles.

   
   

   

   
   

Exemple de workflow

Pour suivre les étapes de ce guide de démarrage rapide, ou pour essayer par vous-même, téléchargez l’exemple de démarrage rapide des API d’automatisation mobile.