Lokale iOS-Geräte

Einrichten lokaler iOS-Geräte

Um ein lokales Gerät für die Arbeit mit den Mobile Automation-Aktivitäten einzurichten, müssen Sie eine lokale Instanz von Appium ausführen und über die erforderlichen Tools zur Automatisierung von iOS-Geräten verfügen.

Es gibt zwei Arten von lokalen iOS-Geräten, die Sie automatisieren können:

• Physisch – ein physisches iOS-Gerät, das Sie über ein USB-Kabel mit Ihrer lokalen Maschine verbinden können.
• Emulator – ein Emulator für ein lokal gespeichertes iOS-Gerät.

Am häufigsten verwendete Appium-Befehle

Die folgende Liste beschreibt die am häufigsten verwendeten Befehle zum Einrichten von Appium im Kontext von Mobile Device Automation (empfohlen für Appium 2.0):

• xcrun simctl list – Listet verfügbare Geräte, Gerätetypen, Laufzeiten oder Gerätepaare auf.
• xcrun simctl list devices – Listet die verfügbaren Geräte auf.
• xcrun simctl list devicetypes – Listet die Gerätetypen auf.
• xcrun simctl list runtimes – Listet die Laufzeiten auf.
• xcrun simctl list runtimes – listet die Gerätepaare auf.

Anwendungsspeicher

Sie müssen Ihre mobilen Apps auf derselben Maschine speichern, auf der Ihr Appium-Server läuft, oder die IPA-Datei auf eine URL hochladen, auf die der Appium-Server anonym zugreifen kann (z. B. Blobspeicher).

Die Installation von Anwendungen über den Play Store oder App Store ist nicht möglich, es sei denn, Sie automatisieren diese Anwendungen manuell, um Ihre spezifische Anwendung zu installieren.

Wichtig:

Wenn Ihr App-Artefakt die APP-Erweiterung verwendet und Sie die App in eine öffentliche URL hochladen möchten, müssen Sie einen Ordner mit dem Namen Payload erstellen, die APP darin platzieren, den Payload-Ordner archivieren und die Erweiterung in IPA anstatt ZIP ändern.

Stellen Sie außerdem sicher, dass die Anwendung, die Sie automatisieren möchten, für die Zielarchitektur (Simulator oder physisches Gerät) kompiliert ist.

Konfigurieren eines physischen iOS-Geräts

Architektur

Wenn Sie mit physischen iOS-Geräten arbeiten, benötigen Sie die folgende Infrastruktur:

1. WindowsOS-Gerät
   • UiPath Studio (Hardware/Software) – Installationsanleitung
2. macOS-Gerät
   • Appium-Server
     • Homebrew
     • NodeJS
   • X-code
     • Erforderlich zum Installieren von Appium Driver auf einem iOS-Gerät
3. iOS-Gerät
   • Appium WebDriver

Abbildung 1. Architektur für lokale physische iOS-Geräte

Voraussetzungen

1. macOS 13+ (Ventura oder höher)
2. Apple ID (für Xcode und Bereitstellung)
3. Physisches iOS-Gerät (iTelefon/iPad)
4. UiPath Studio 2023.10 (oder höher)
5. USB-über-laden, um das Gerät zu verbinden

Konfigurieren des lokalen physischen iOS-Geräts

1. Installieren Sie Homebrew.
   1. Öffnen Sie das Terminal (wählen Sie Command+Space).
   2. Führen Sie den folgenden Befehl aus:

      /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" 

      Abbildung 2. Homebrew-Installation – Befehlszeile
      

      

      
      
   3. Wenn Sie dazu aufgefordert werden, führen Sie den folgenden Befehl aus, um Homebrew zu Ihrer PATH -Umgebungsvariablen hinzuzufügen:

      echo >> /Users/<username>/.zprofile
        echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> /Users/<username>/.zprofile
        eval "$(/opt/homebrew/bin/brew shellenv)"

   4. Überprüfen.

      brew -version

2. Installieren Sie Xcode und Befehlszeilentools.
   • Installieren Sie Xcode über den App Store und öffnen Sie ihn einmal.
   • Führen Sie über das Terminal Folgendes aus:

   • 1. xcode-select –install

     2. sudo xcodebuild -license accept

     3. Überprüfen Sie:

        xcodebuild -version

3. Aktivieren Sie den Entwicklermodus auf dem iOS-Gerät.
   1. Gehen Sie auf Ihrem iPhone oder iPad zu Einstellungen > Datenschutz und Sicherheit > Entwicklermodus.
      Abbildung 3. Entwicklermodus auf iOS-Gerät
      

      

      
      
   2. Einschalten und neu starten.
   3. Genehmigen Sie nach dem Neustart das Popup.
   4. Stellen Sie eine Verbindung über USB her und vertrauen Sie dem Computer.
      Abbildung 4. Aktivieren Sie die Vertrauensstellung von iOS-Geräten
      

      

      
      
4. Installieren Sie Node.js.
   1. Führen Sie den folgenden Befehl aus:

      brew install node

      Abbildung 5. Node.js-Installation
      

      

      
      
   2. Überprüfen.

      node -v

      npm -v

5. Installieren Sie Appium v3.
   1. Führen Sie den folgenden Befehl aus:

      npm install -g appium@3

      Abbildung 6. Appium-Installation
      

      

      
      
   2. Überprüfen.

      appium -v

      Abbildung 7. Appium-Verifizierung
      

      

      
      
6. Installieren Sie Appium-Treiber und -Plugins.
   1. Installieren Sie den iOS-Treiber.

      appium driver install xcuitest

      Abbildung 8. Appium xcuitest
      

      

      
      
   2. (Optional) Konfigurieren Sie die Option Android.

      appium driver install uiautomator2

   3. Listen Sie die Treiber auf.

      appium driver list

      Abbildung 9. Appium-Treiber
      

      

      
      
7. Richten Sie WebDriverAgent ein.
   1. Installieren Sie Stellen.
   2. Richten Sie WebDriverAgent ein.
      1. Navigieren Sie mit dem folgenden Pfad zum Ordner appium-webdriveragent : /Usetrs/<username>/appium2/node_modules/appium-xcuitest-driver/node_modules/appium-webdriversalent und öffnen Sie die Datei xcodeproj .
         Abbildung 10. WebDriverAgent-Ordner
         

         

         
         
      2. Wählen Sie WebDriverAgent aus und öffnen Sie im Abschnitt Ziele WebDriverAgentRunner.
         Abbildung 11. WebDriverAgent-Ausführung
         

         

         
         
      3. Wechseln Sie zur Registerkarte Signatur und Funktionen, wählen Sie Signaturen automatisch verwalten aus, und wählen Sie ein Benutzerkonto aus der Dropdownliste Team aus.
      4. Ändern Sie die Bundle-ID in einen eindeutigen Wert.
         Abbildung 12. Bezeichner des WebDriverAgent-Pakets
         

         

         
         
      5. Kopieren und speichern Sie diese Paketkennung, die Sie verwenden werden, um Ihre Anwendung im Mobile Device Manager (Paket-ID) hinzuzufügen.
      Problem: Ein häufiges Problem ist ein nicht vertrauenswürdiges Entwicklerzertifikat. Um das Problem zu beheben, befolgen Sie die Anweisungen im Popup.

      Abbildung 13. Fehlerbehebung bei WebDriverAgent
      

      

      
      
8. Überprüfen Sie den Zugriff auf das physische Gerät.
   1. Bestätigen Sie, dass IntegrationApp auf Ihrem physischen Gerät installiert ist.
      Abbildung 14. IntegrationApp auf physischem Gerät
      

      

      
      
   2. Ausführen: xcrun xctrace list devices.
   3. Stellen Sie sicher, dass Ihr iPhone in der Liste angezeigt wird. Wenn nicht, überprüfen Sie die Einstellungen für Entwicklermodus und Vertrauen . Sie benötigen den UDID oder Informationen in der Klammer nach Ihrem Gerätenamen.
      Abbildung 15. Physischer Gerätezugriff
      

      

      
      
9. Starten Sie den Appium-Server.
   1. Öffnen Sie das Terminal und geben Sie appium ein.
      Abbildung 16. Appium-Server gestartet
      

      

      
      
   2. Kopieren Sie die Appium-URL (im nächsten Schritt zu verwenden).
      Hinweis: Verwenden Sie nicht den Speicherort 127.
10. Verbinden Sie UiPath mit Appium.
    1. Öffnen Sie UiPath Studio und installieren Sie Mobile Automation-Aktivitäten.
    2. Öffnen Sie den Mobile Device Manager und wählen Sie Gerät hinzufügen aus.
       
       
       
       
       
       
       
       

Fügen Sie das konfigurierte lokale physische iOS-Gerät im Mobile Device Manager hinzu, indem Sie das Verfahren zum Hinzufügen eines iOS-Geräts im Mobile Device Manager verwenden.

Hinzufügen eines lokalen iOS-Geräts im Mobile Device Manager

1. Öffnen Sie den Mobile Device Manager in Studio.
2. Wechseln Sie im linken Navigationsbereich zu Geräte.
3. Konfigurieren Sie Ihr Gerät wie folgt:
   • Name – Geben Sie einen Namen ein, um Ihr Gerät auf der Registerkarte Geräte zu identifizieren.
   • Appium-URL – Geben Sie die Appium-URL, die Sie zuvor kopiert haben, im folgenden Format ein: http://<ipaddress>:8001 .
   • Plattform – Klicken Sie auf das Feld, um iOS aus der Dropdownliste auszuwählen.
   • Gerätename – Geben Sie den Gerätenamen ein.

   • Zusätzliche gewünschte Funktionen – Fügen Sie die folgenden Funktionen hinzu:

     Name	Wert
     automationName	xcuitest (Diese Funktion aktiviert den Appium iOS-Treiber)
     udid	the Identifier of the connected physical iOS device

4. (Optional) Konfigurieren Sie die Protokollierungs- und Videoaufzeichnungsdetails auf der Registerkarte Protokollierung.
5. (Optional) Konfigurieren Sie Ihren Entwicklungsprozess auf der Registerkarte Development.
   • Ähnliche Registerkarten schließen (standardmäßig aktiviert): Schließen Sie Registerkarten, auf denen Verbindungen mit ähnlichen Geräten und Anwendungen ausgeführt werden.
   • Auf Aktualisierung der Seite warten (standardmäßig aktiviert): Warten Sie, bis die Seitenquelle einen Screenshot jeder Aktion abruft.
6. Klicken Sie auf Speichern und Schließen, um Ihr Gerät hinzuzufügen.

   Ihr Gerät wird der Liste Geräte hinzugefügt. Informationen zum Hinzufügen eines lokalen Geräts finden Sie unter https://uipath.atlassian.net/browse/DP-888.

   Wenn Sie Ihr Gerät nicht starten können, siehe Fehlerbehebung: Physisches Gerät kann nicht gestartet werden.

   
   

   

   
   

Hybrid- und Webautomatisierung unter iOS

Hybride Automatisierung funktioniert standardmäßig für iOS-Geräte, vorausgesetzt, Sie versuchen nicht, eine für die Produktion entwickelte App zu automatisieren. Bei der Automatisierung von Produktions-Apps können die in WKWebView gehosteten Inhalte nicht automatisiert werden. Allerdings können alle Webinhalte, die in einem SFSafariViewController gehostet werden, auch in Produktions-Apps automatisiert werden. Weitere Informationen finden Sie unter SFSafariViewController.