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:

• Physical - a physical iOS device that you can connect to your local machine, through a USB cable.
• Emulator - an emulator for an iOS device that's stored locally.

Am häufigsten verwendete Appium-Befehle

In der folgenden Liste werden die am häufigsten verwendeten Befehle zum Einrichten von Appium im Kontext der Automatisierung von Mobilgeräten beschrieben (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.

Warnung:

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:

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

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

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

brew install node 4. Installieren Sie Appium:

• For Appium 1.0, run the following command: npm install -g appium. This automatically installed all drivers needed.
• For Appium 2.0, run the following command: npm install -g appium@next.

Appium 2.0 comes without the drivers installed. Therefore, to install the needed drivers, also run the following command: appium driver install xcuitest.

Warnung:

• We recommend using Appium 2.0 with Mobile Automation version 22.10 or higher.
• Install Appium 2.0 if you want to test your mobile automations on a iOS Physical Device. 1. Open Xcode and allow it to install any additional components it may require. Close it once you see the splash screen. 2. Start the Appium server, using the following command: 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:

   • Go to System Settings, then the Network tab, and select the Wi-Fi network that the physical device is connected to.
   • Copy the IP Address for the Wi-Fi network that the device is connected to. The format of the Appium URL is http://<ipaddress>:8001 (8001 is the port number where you start Appium).
     

4. Rufen Sie die UDID des physischen iOS-Geräts ab, das Sie mit Ihrer Maschine verbunden haben, von XCode.

   • Go to Window > Devices and Simulators > Devices.
   • Klicken Sie auf das iOS-Gerät, mit dem Sie eine Verbindung hergestellt haben.
   • Copy the Identifier. This is the UDID, that you'll later add as an additional desired capability, when adding this iOS physical device to MDM.

5. Erstellen Sie den 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 .
   • Select WebDriverAgent, and open WebDriverAgentRunner, under the Targets section.
   • Switch to the Signing & Capabilities tab, select Automatically manage signing, and choose a user account from the Team dropdown.
   • Change the Bundle Identifier to a unique value.
   • Copy and save this Bundle Identifier. You'll use it to add your Application inside MDM (Bundle Id).
     

6. Install the WebDriverAgent on your iOS physical device.

   • Select WebDriverAgentRunner in the WebDriverAgent navigation bar.
   • In XCode, go to Product, and click Test. On your connected iOS physical device, you'll see the WebDriverAgent installing.

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 - Enter the Appium URL, that you previously copied, using the following format: http://<ipaddress>:8001.

   • Plattform – Klicken Sie auf das Feld, um iOS aus der Dropdownliste auszuwählen.

   • Gerätename – Geben Sie den Gerätenamen ein.

   • Additional Desired Capabilities - Add the following capabilities:

     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.

Your device is added to the Devices list. To add a local device, see . If you cannot start your device, see Troubleshooting: Physical device fails to start.

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.