Lokale iOS-Geräte

Einrichten lokaler iOS-Geräte

Um ein lokales Gerät für die Arbeit mit Mobile Automation-Aktivitäten einzurichten, müssen Sie:

• Haben Sie eine macOS-Umgebung.
• Führen Sie eine lokale Instanz von Appium auf dem macOS-Gerät aus.

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

Voraussetzungen

1. Installieren Sie Xcode.
2. Öffnen Sie ein Terminal und führen Sie den folgenden Befehl aus, um Homebrew zu installieren:

   /usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

3. Führen Sie den folgenden Befehl aus, um NodeJS zu installieren:

   brew install node

4. Installieren Sie Appium:
   • Führen Sie für Appium 1.0den folgenden Befehl aus: npm install -g appium . Dadurch werden automatisch alle benötigten Treiber installiert.
   • Führen Sie für Appium 2.0den folgenden Befehl aus: npm install -g appium@next .
   Appium 2.0 wird ohne installierte Treiber geliefert. Führen Sie daher zum Installieren der erforderlichen Treiber auch den folgenden Befehl aus: appium driver install xcuitest .

   Wichtig:

   • Wir empfehlen die Verwendung von Appium 2.0 mit Mobile Automation Version 22.10 oder höher.

   • Installieren Sie Appium 2.0 , wenn Sie Ihre mobilen Automatisierungen auf einem physischen iOS-Gerättesten möchten.

5. Öffnen Sie Xcode und lassen Sie es alle zusätzlichen erforderlichen Komponenten installieren. Schließen Sie es, sobald Sie den Startbildschirm sehen.
6. Starten Sie den Appium-Server mit dem folgenden Befehl: appium --port 8001 --default-capabilities "{\"appium:systemPort\":9001}" --relaxed-security .
   
   

   

   
   

Konfigurieren des lokalen physischen iOS-Geräts

1. Verbinden Sie Ihr physisches Gerät mit Ihrem Mac.
2. Entsperren Sie Ihr Gerät. Wenn eine Warnmeldung erscheint, stellen Sie sicher, dass der Computer darauf zugreifen kann.
3. Rufen Sie die Appium-URL ab und speichern Sie sie für später:
   • Gehen Sie zu Systemeinstellungen, dann zur Registerkarte Netzwerk und wählen Sie das Wi-Fi-Netzwerk aus, mit dem das physische Gerät verbunden ist.
   • Kopieren Sie die IP-Adresse für das Wi-Fi-Netzwerk, mit dem das Gerät verbunden ist. Das Format der Appium-URL ist http://<ipaddress>:8001 ( 8001 ist die Portnummer, unter der Sie Appium starten).
     
     

     

     
     
4. Rufen Sie die UDID des physischen iOS-Geräts ab, das Sie mit Ihrer Maschine verbunden haben, von XCode.
   • Wechseln Sie zu Fenster > Geräte und Simulatoren > Geräte.
   • Klicken Sie auf das iOS-Gerät, mit dem Sie eine Verbindung hergestellt haben.
   • Kopieren Sie den Bezeichner. Dies ist die UDID, die Sie später als zusätzliche gewünschte Funktion hinzufügen, wenn Sie dieses physische iOS-Gerät zu MDM hinzufügen.
5. Erstellen Sie WebDriverAgent mit XCode auf Ihrem Mac.
   • Navigieren Sie zum Ordner appium-webdriveragent , indem Sie den folgenden Pfad verwenden: /Users/<username>/appium2/node_modules/appium-xcuitest-driver/node_modules/appium-webdriveragent , und öffnen Sie die Datei xcodeproj .
   • Wählen Sie WebDriverAgentaus, und öffnen Sie WebDriverAgentRunnerim Abschnitt Ziele .
   • 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.
   • Ändern Sie die Bundle-ID in einen eindeutigen Wert.

   • Kopieren und speichern Sie diese Bundle-ID. Sie verwenden sie, um Ihre Anwendung in MDM (Bundle-ID) hinzuzufügen.

     
     

     

     
     
6. Installieren Sie den WebDriverAgent auf Ihrem physischen iOS-Gerät.
   • Wählen Sie WebDriverAgentRunner in der WebDriverAgent-Navigationsleiste aus.
   • Wechseln Sie in XCode zu Produkt, und klicken Sie auf Testen. Auf Ihrem verbundenen physischen iOS-Gerät wird der WebDriverAgent installiert.
7. 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.

   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.