Lokale Geräte

Überblick

Wenn Sie ein lokales Gerät für die Arbeit mit den Mobile Automation-Aktivitäten einrichten möchten, egal ob es sich um ein physisches Gerät oder einen Emulator handelt, müssen Sie eine lokale Instanz von Appium ausführen und über die erforderlichen Tools zur Automatisierung von Android- oder iOS-Geräten verfügen.

Themenabschnitte:

• Anwendungsspeicher
• Konfiguration von Android-Geräten
• Konfiguration von iOS-Geräten

Anwendungsspeicher

Sie müssen Ihre mobilen Apps auf demselben Rechner speichern, auf dem Ihr Appium-Server läuft, oder die APK- oder 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.

Konfiguration von Android-Geräten

Um ein lokales Android-Gerät zu konfigurieren, müssen Sie Ihre Umgebung vorbereiten und zum Mobile Device Manager hinzufügen.

Themen in diesem Abschnitt:

• Vorbereiten der Android-Umgebung
• Starten des Appium-Servers
• Erstellen des Android-Emulators
• Aktivieren von Web- und Hybridautomatisierung mit WebDriver
• Konfigurieren eines physischen Android-Geräts
• Hinzufügen eines lokalen Android-Geräts im Mobile Device Manager

Vorbereiten der Android-Umgebung

Bereiten Sie Ihre Umgebung vor und konfigurieren Sie sie.

1. Laden Sie Node.js herunter und installieren Sie es.
2. Öffnen Sie die Node.js-Eingabeaufforderung und führen Sie den folgenden Befehl aus, um Appium zu installieren:

   npm install -g appium

   Weitere Informationen zur Appium-Konfiguration finden Sie unter Appium – Erste Schritte.

3. Navigieren Sie in Windows zu Erweiterte Systemeinstellungen > Erweitert > Umgebungsvariablen
4. Klicken Sie unter Systemvariablen auf Neu und konfigurieren Sie die folgenden Variablen:

   a. Variable ANDROID_HOME.

Variablenname: ANDROID_HOME Variablenwert: C:\Users\Username\AppData\Local\Android\Sdk Hinweis: Der Teil Username im Pfad „Variablenwert“ muss durch den tatsächlichen Namen des Benutzers ersetzt werden, der auf der Maschine arbeitet.

b. Variable JAVA_HOME. Sie müssen bereits Java installiert haben, um diese Variable zu konfigurieren. Sie können Java hierüber eine ZIP-Datei herunterladen.

Variablenname: JAVA_HOME .

Variablenwert: der Pfad, in dem sich das JDK auf Ihrer Maschine befindet. Beispiel: C:\Program Files\Java\jdk8 .

Wichtig: Wenn Java automatisch aktualisiert wird, müssen Sie diese Variable manuell mit dem aktualisierten Pfad konfigurieren.

c. Klicken Sie zum Bestätigen auf Ok.

1. Bearbeiten Sie die Variable Path für Ihren Benutzer, um Android Debug Bridge (ADB) einzuschließen:

   a. Klicken Sie auf Neu und fügen Sie den folgenden Wert hinzu:

   %ANDROID_HOME%\platform-tools

   b. Klicken Sie zum Bestätigen auf Ok.

2. Klicken Sie auf Ok, um die Variable festzulegen.

   
   

   

   
   

Starten des Appium-Servers

Bevor Sie eine Anwendung auf Ihrem Gerät starten, müssen Sie mit der Ausführung eines Appium-Servers auf Ihrer Maschine beginnen. Öffnen Sie die Eingabeaufforderung und führen Sie Appium mit den folgenden Parametern aus:

appium -p 10001 --relaxed-security --allow-insecure chromedriver_autodownload

Hinweis:

• Wenn der automatische Download fehlschlägt, können Sie auf die bereits heruntergeladene Datei chromedriver.exe verweisen, indem Sie den folgenden Befehl verketten:

--chromedriver-executable "path_to_chromedriver"

• Um Hilfe beim Appium-Debugging zu erhalten, führen Sie den folgenden Befehl aus:

appium-doctor

• Um Appium zu beenden, verwenden Sie den Befehl ctrl + c .

Erstellen des Android-Emulators

Erstellen Sie Ihre Android-Emulatoren mithilfe von Android Studio.

1. Laden Sie Android Studio herunter und installieren Sie es.
2. Öffnen Sie Android Studio.
3. Klicken Sie auf Konfigurieren und wählen Sie SDK Manager aus der Dropdownliste aus.
4. Deaktivieren Sie die Option Veraltete Pakete ausblenden und stellen Sie sicher, dass Android SDK-Tools (veraltet) ausgewählt ist.
   
   

   

   
   
5. Klicken Sie zum Schließen auf Anwenden und dann auf Ok.
6. Navigieren Sie zu Konfigurieren > AVDManager, um ein virtuelles Gerät zu konfigurieren. Weitere Informationen finden Sie unter Erstellen und Verwalten von virtuellen Geräten.
   
   

   

   
   
7. Aktualisieren Sie die Google-Apps Ihres Geräts.

Aktivieren von Web- und Hybridautomatisierung mit WebDriver

Aktivieren Sie das WebView-Debugging.

Wenn Appium die Chrome- oder WebView-Version auf Ihrem Android-Gerät nicht automatisch erkennt, wählen Sie eine der folgenden Optionen aus:

1. Verwenden Sie den Befehl --allow-insecure chromedriver_autodownload . Dadurch kann Appium die ChromeDriver-Version, die Ihrer Umgebung entspricht, automatisch erkennen und herunterladen.
2. Geben Sie den WebDriver für Chrome manuell an und laden Sie ihn herunter:

   2.1. Öffnen Sie Ihr Gerät in Android Studio.

   2.2. Navigieren Sie zu Einstellungen > Apps und Benachrichtigungen.

   2.3 Klicken Sie auf Alle Apps anzeigen.

   2.4. Klicken Sie auf die drei vertikalen Punkte und wählen Sie System anzeigen aus der Dropdownliste aus.

   2.5. Verwenden Sie die Suchfunktion, um nach Android System WebView zu suchen.

   2.6. Öffnen Sie die App und wechseln Sie zu Erweitert.

   2.7. Kopieren Sie die Versionsnummer am unteren Rand des Bildschirms.

   2.8. Laden Sie WebDriver für Chrome herunter und berücksichtigen Sie Folgendes:

   • Wählen Sie die Version aus, die der Android System Webview-Version aus dem vorherigen Schritt entspricht, und extrahieren Sie sie in einen Ordner.
   • Sie suchen nach einer genauen Übereinstimmung für die Version (major.minor.patch.revision).
   • Falls keine exakte Übereinstimmung verfügbar ist, verwenden Sie die neueste Hauptversion von ChromeDriver, die mit der Hauptversion des Android System Webview übereinstimmt.
   • Wenn Sie die Chrome-App automatisieren möchten, führen Sie einfach die gleichen Schritte wie oben aus und notieren Sie sich stattdessen die Chrome-Version.

Konfigurieren eines physischen Android-Geräts

1. Laden Sie Android Studio herunter und installieren Sie es.
2. Öffnen Sie Android Studio.
3. Klicken Sie auf Konfigurieren und wählen Sie SDK Manager aus der Dropdownliste aus.
4. Deaktivieren Sie die Option Veraltete Pakete ausblenden und stellen Sie sicher, dass Android SDK-Tools (veraltet) ausgewählt ist.
5. Klicken Sie zum Schließen auf Anwenden und dann auf Ok.
6. Öffnen Sie eine Befehlszeile und führen Sie den folgenden Befehl aus, um einen Debugging-Server zu starten:

   %LOCALAPPDATA%\\Android\\Sdk\\platform-tools\\adb.exe start-server

7. Verbinden Sie Ihr Gerät über ein Kabel mit Ihrer Maschine.
8. Aktivieren Sie die Entwickleroptionen und das USB-Debugging auf Ihrem Gerät. Weitere Informationen finden Sie unter Konfigurieren von Entwickleroptionen auf dem Gerät.
9. Navigieren Sie auf Ihrem Telefon zu Einstellungen > Entwickleroptionen.
10. Öffnen Sie unter dem Abschnitt Netzwerke die Standard-USB-Konfiguration und stellen Sie Nur Telefon laden ein.
11. Fügen Sie Ihr Gerät zum Mobile Device Manager hinzu.
12. Führen Sie den folgenden Befehl aus, um einen Appium-Server zu starten:

    appium -p 10001 --relaxed-security --allow-insecure chromedriver_autodownload

    Weitere Parameter finden Sie unter Starten des Appium-Servers.

    Hinweis: Stellen Sie sicher, dass die Verbindung zum Appium-Server ohne Beeinträchtigungen weiterläuft. Wenn Sie zum Beispiel innerhalb des Terminals klicken, wird die Kommunikation unterbrochen – dies kann zu einem Kommunikationsfehler im Mobile Device Manager führen.

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

1. Öffnen Sie MDM 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 den localhost ein. Beispiel: http://localhost:10001/wd/hub.
   • Plattform – Klicken Sie auf das Feld, um Android aus der Dropdownliste auszuwählen.
   • Gerätename – Geben Sie den Gerätenamen ein. Eine Möglichkeit, dies zu sehen, ist über Android Studio, wenn Sie zu Konfigurieren > AVD Manager navigieren und dann zu Weitere Aktionen > Details anzeigen. wechseln.
   • Plattformversion – Fügen Sie die Versionsnummer Ihres Android-Betriebssystems hinzu.
   • Zusätzliche gewünschte Funktionen (optional) – Fügen Sie bestimmte Funktionen hinzu, um Ihre Automatisierungssitzung anzupassen. Weitere Informationen finden Sie unter Gewünschte Appium-Funktionen.
   • Geografischen Standort festlegen (optional) – Legen Sie den Standort Ihres Geräts fest, um Anwendungen zu testen, die Ortungsdienste zur Generierung von Standortdaten verwenden.
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 Lokale Geräte.

   
   

   

   
   

Konfiguration von iOS-Geräten

Um ein lokales iOS-Gerät, einen Simulator oder ein physisches Gerät zu konfigurieren und eine Anwendung zu automatisieren, müssen Sie den Appium-Server auf einer macOS-Maschine einrichten.

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.

Themen in diesem Abschnitt:

• Vorbereiten der macOS-Umgebung
• Konfigurieren eines physischen iOS-Geräts
• Hinzufügen eines lokalen iOS-Geräts im Mobile Device Manager

Vorbereiten der macOS-Umgebung

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:

   npm install -g appium

5. Öffnen Sie Xcode und lassen Sie es alle zusätzlichen erforderlichen Komponenten installieren. Schließen Sie es, sobald Sie den Startbildschirm sehen.
6. Führen Sie den folgenden Befehl aus, um Appium zu starten:

   appium --port 10001

7. Verwenden Sie die Spotlight-Suche (⌘–Leertaste), um das Netzwerkdienstprogramm zu öffnen.
8. Kopieren Sie die IP-Adresse für die spätere Verwendung, wenn Sie ein iOS-Gerät in MDM hinzufügen. Dies wird in der Appium-URL enthalten sein (z. B. http://<ipaddress>:8001/wd/hub).
   
   

   

   
   

Konfigurieren eines physischen iOS-Geräts

Wenn Sie die Mobile Automation-Aktivitäten mit einem physischen iOS-Gerät verwenden möchten, benötigen Sie ein Apple Developer-Konto.

1. Führen Sie die Schritte 1–5 unter Vorbereiten der macOS-Umgebung. aus
2. Verbinden Sie Ihr physisches Gerät mit Ihrem Mac.
3. Entsperren Sie Ihr Gerät. Wenn eine Warnmeldung erscheint, stellen Sie sicher, dass der Computer darauf zugreifen kann.
4. Öffnen Sie ein Terminal und führen Sie den folgenden Befehl aus:

   instruments -s devices

5. Kopieren Sie Ihre Geräte-ID für die spätere Verwendung, wenn Sie Ihr Gerät in MDM hinzufügen. Beispielsweise wird deviceID als udid-Funktion hinzugefügt:

   Known Devices: Username's iPhone (13.5.1) (<deviceID>)

6. Melden Sie sich bei Ihrem Apple Developer-Konto an und wechseln Sie zu Mitgliedschaft.
7. Kopieren Sie Ihre Team-ID für die spätere Verwendung, wenn Sie Ihr Gerät in MDM hinzufügen. Ihre Team-ID muss den Gerätefunktionen mit dem Namen xcodeOrgId hinzugefügt werden.
8. Öffnen Sie Xcode und navigieren Sie zu Einstellungen > Konten.
9. Fügen Sie Ihr Apple Developer-Konto hinzu.

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 den localhost ein. Beispiel: http://<ipaddress>:8001/wd/hub.
   • Plattform – Klicken Sie auf das Feld, um iOS aus der Dropdownliste auszuwählen.
   • Gerätename – Geben Sie den Gerätenamen ein.
   • Zusätzliche gewünschteFunktionen (Physische Geräte) – Fügen Sie udid und xcodeOrgId hinzu. Weitere Informationen finden Sie unter Konfigurieren eines physischen iOS-Geräts
   • Geografischen Standort festlegen (optional) – Legen Sie den Standort Ihres Geräts fest, um Anwendungen zu testen, die Ortungsdienste zur Generierung von Standortdaten verwenden.
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 Lokale Geräte.

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