Erste Schritte mit Mobile Automation-APIs

Diese Schnellstartanleitung hilft Ihnen, Ihre erste codierte Automatisierung mithilfe von Mobile Automation-APIs zu erstellen. Das Tutorial verwendet die UiPath® Android Basic App und einen Google Pixel-Emulator von Sauce Labs für automatisierte Tests.

1. Fügen Sie das Mobilgerät und die Anwendung im Mobile Device Manager hinzu

Um das gewünschte Mobilgerät und die Anwendung in unserer codierten Automatisierung zu verwenden, müssen wir sie zuerst im MDM (Mobile Device Manager) erstellen:

1. So erstellen Sie die Anwendung:
   1. Wechseln Sie in MDM zu Anwendungen.
   2. Wählen Sie Anwendung hinzufügen aus.
   3. Geben Sie im Fenster Anwendung bearbeiten die erforderlichen Informationen ein:
      1. Name: Verwenden Sie in diesem Beispiel Basic App - Android.
      2. Typ: Wählen Sie App für eine native Anwendung aus.
      3. Plattform: Wählen Sie Android aus, um die Android-Anwendung zu automatisieren.
      4. App: Geben Sie in diesem Beispiel den folgenden Link zur Android-Standard-App ein: https://uipathtestappsto.blob.core.windows.net/testapps/BasicAppAndroid.apk.
      5. App-Paket: Geben Sie das mobile Anwendungspaket ein, z. B. com.example.basicapp.
      6. App-Aktivität: Geben Sie die Aktivitätsinstanz ein, z. B.: .core.MainActivity.
      7. Fügen Sie für Zusätzliche gewünschte Funktionen die Funktion appium:app hinzu, um sicherzustellen, dass die Anwendung wie erwartet funktioniert.

      Tabelle 1. Zusätzliche gewünschte Funktionen

      Name	Wert
      appium:app	appium:app https://uipathtestappsto.blob.core.windows.net/testapps/BasicAppAndroid.apk

   
   

   

   
   
2. So erstellen Sie das Gerät:
   1. Gehen Sie zu Geräte und wählen Sie Gerät hinzufügen aus.
   2. Benennen Sie das Gerät. Verwenden Sie für dieses Beispiel Google Pixel 3a GoogleAPI Emulator.
   3. Legen Sie die folgenden Parameter fest: Appium-URL, Plattform, Gerätename, Plattformversion.
      1. Rufen Sie die Parameter von dem von Ihnen gewählten Anbieter der mobilen Gerätefarm ab. In diesem Beispiel verwenden wir Sauce Labs.
      2. Um die Appium-URL abzurufen, wechseln Sie zu Konto und dann zu Benutzereinstellungen. Kopieren Sie die Abruf-URL unter Treibererstellung.
      3. Um Plattform, Gerätename und Plattformversion abzurufen, wechseln Sie zu Automatisiert und dann zu Plattformkonfigurator. Wählen Sie die Funktionen für Google Pixel 3a GoogleAPI Emulator und Android Emulator version 10.0 aus. Wählen Sie unter Konfigurationsskript Ihr Appium version aus. Verwenden Sie für dieses Beispiel 2.0.0.
      4. Kopieren Sie die Werte aus Sauce Labs in MDM und fügen Sie sie ein.
      5. 
         

         

         
         
   4. Klicken Sie auf Speichern und schließen.
   5. Wählen Sie Eine Anwendung auf diesem Gerät starten aus und verbinden Sie das Gerät mit der zuvor erstellten Anwendung.

2. Erstellen Sie Ihr Object Repository für die mobile Anwendung

Um Ihre bevorzugte mobile Anwendung zu automatisieren, zeichnen Sie ihre mobilen Elemente im Objekt-Repository des Projekts auf. In diesem Beispiel haben wir eine Basic App-Anwendung mit einem allgemeinen HomeScreen erstellt, die drei UI-Elemente enthält, die wir zum Automatisieren verwenden. In der folgenden Liste sehen Sie, wie die Struktur des Object Repository aussieht:

• BasicApp
  • HomeScreen
    • EditText
    • SingleClickButton
    • VerifyText
  
  

  

  
  

3. Verbindung herstellen

Nachdem Sie Ihr Gerät und Ihre Anwendung in MDM konfiguriert haben, beginnen Sie mit dem Schreiben des Codes für Ihre Automatisierung. Bevor Sie mit der Verwendung der Mobile Automation-APIs beginnen, müssen Sie mithilfe der entsprechenden APIs eine Verbindung zwischen dem von Ihnen gewählten Mobilgerät und der Anwendung herstellen.

Eine connection ist eine Klasse, die die Verbindung zwischen einem Gerät und einer Anwendung darstellt. Sie stellt die APIs bereit, die Sie zur Automatisierung von mobilen Testszenarien verwenden können. Weitere Informationen zum Erstellen eines connection finden Sie unter Verbindung.

Um eine Verbindung herzustellen, stehen Ihnen eine Reihe von speziellen APIs zur Verfügung, die Sie verwenden können. In diesem Beispiel haben wir die Connect-API mit der zweiten Überladung verwendet, die die Geräte- und Anwendungsnamen als Strings erfordert.

Erstellen Sie die Verbindung mit den folgenden Schritten:

1. Beginnen Sie mit einer using-Anweisung, um das Erstellen einer separaten Variablen zu vermeiden.
2. Rufen Sie in der using-Anweisung die Connect-API mit der zweiten Überladungsversion auf.

   Geben Sie für diese Überladung den Gerätenamen und den Anwendungsnamen ein, um die Verbindung herzustellen.

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

3. Optional können Sie zu Debugging-Zwecken eine Log-Meldung hinzufügen.

   Log("Connection established");

4. Beginnen Sie mit der Automatisierung der mobilen Anwendung und des Geräts

Der automatisierte Flow in diesem Beispiel umfasst das Tippen auf bestimmte Schaltflächen, das Abrufen von Text, der auf dem mobilen Bildschirm angezeigt wird, und das Wischen über einen Schieberegler. Diese Aktionen simulieren reale Szenarien der mobilen Automatisierung.

Um die UI-Elemente in diesem Beispiel zu automatisieren, haben wir IElementDescriptors verwendet. Dabei handelt es sich um UI-Elemente, auf die direkt über das Object Repository zugegriffen wird. Zusätzlich zu IElementDescriptors können Sie andere Selektortypen mit Mobile Automation-APIs verwenden, z. B. ObjectRepositoryTarget und SelectorTarget. Unter API-Selektoren erfahren Sie, wie und wann Sie andere Selektortypen verwenden können.

1. Rufen Sie die Tap-API auf, um in der Android Basic-App auf SingleClickButton zu klicken.

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

2. Verwenden Sie die SetText-API, um einen bestimmten Text in das EditText-Feld einzugeben.

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

3. Rufen Sie den zuvor festgelegten Text ab und überprüfen Sie, ob er mit dem Text aus dem UI-Element VerifyText übereinstimmt. Verwenden Sie die GetText- und VerifyExpression-APIs.

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

4. Verwenden Sie die PositionalSwipe-API, um den Schieberegler zu verschieben.
   Die PositionalSwipe-API erfordert zwei Point-Variablen, die die Start- und Endpunkte für die Wischaktion darstellen. Erstellen Sie diese Punkte, bevor Sie die API verwenden, um die Lesbarkeit zu verbessern.

   // 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.");

   Um die Bildschirmposition zu ermitteln, gehen Sie zur aktiven Verbindung im MDM. Zeigen Sie mit dem Mauszeiger auf den mobilen Bildschirm. Dadurch wird die Position des Cursors in Pixeln in der unteren linken Ecke des MDM angezeigt.

   
   

   

   
   

Workflow-Beispiel

Um die Schritte in dieser Schnellstartanleitung auszuführen oder sie selbst auszuprobieren, laden Sie das Beispiel für den Mobile Automation APIs-Schnellstart herunter.