Mobile-Module

Der Ordner Engines->Mobile in der Standard-Untermenge enthält Module, die bestimmte Aufgaben für die Mobile Engine 3.0 ausführen.

Capabilities

Mit Desired Capabilities können Sie Schlüsselparameter definieren, die Ihr Test-Session-Verhalten in Appium steuern. Diese Einstellungen weisen den Appium-Server an, wie Ihre Tests ausgeführt werden sollen. Weitere Informationen zur Verwendung von Desired Capabilities in Ihren Tests finden Sie hier: Desired Capabilities einrichten.

Der Ordner Engines->Mobile->Capabilities in der Standard-Untermenge enthält die Module, mit denen Sie Ihre Testausführungsumgebung mit Capabilities anpassen können.

Set Desired Capabilities

Mit dem Modul Set Desired Capabilities können Sie Desired Capabilities auf Ihre Testausführung anwenden. Es muss der erste Testschritt Ihres Testfalls sein (siehe Kapitel "Desired Capabilities für die Testausführung einrichten").

Das Modul hat das folgende Modulattribut:

Modulattribut

Beschreibung

Capability

Geben Sie an, welche Desired Capability Sie anwenden möchten:

Namen und Werte unterscheiden zwischen Groß- und Kleinschreibung.

In diesem Beispiel wenden Sie die Desired Capabilities skipServerInstallation und skipDeviceInitialization an, um die Startzeit der Android-Testausführung zu verkürzen.

Modul Set Desired Capabilities in einem Testfall

Add Desired Capabilities

Mit dem Modul Add Desired Capabilities können Sie Ihrer Testausführung neue Capabilities hinzufügen, ohne die bereits definierten zu überschreiben. Nähere Informationen zur Verwendung dieses Moduls finden Sie unter „Desired Capabilities für die Testausführung hinzufügen“.

Das Modul hat das folgende Modulattribut:

Modulattribut

Beschreibung

Capability

Geben Sie an, welche Desired Capability Sie anwenden möchten:

Die Groß- und Kleinschreibung muss bei Namen und Werten beachtet werden.

In diesem Beispiel führen Sie Ihren Testfall auf mehreren Cloud-Anbietern aus und ändern die Capabilities dynamisch. Gleichzeitig behalten Sie eine Reihe gemeinsamer Capabilities bei, die für alle Anbieter gelten. Verwenden Sie dazu sowohl das Modul Set Desired Capabilities als auch das Modul Add Desired Capabilities .

Wenn Sie Ihre Tests auf der Tricentis Device Cloud (TDC) ausführen, stellen Sie Ihre Desired Capabilities so ein, dass Ihre Tests wie folgt angepasst werden:

  • Warten Sie bis zu 300 Sekunden, bevor Sie einen Timeout durchführen, da Sie Ihren Tests genügend Zeit zum Beenden geben möchten, falls es aufgrund des Geräts oder des Netzwerks zu Verzögerungen kommt.

  • Wählen Sie ein zufälliges Gerät aus dem Cloud-Pool zum Testen aus, da Sie eine Vielzahl von Geräten testen möchten. Dies hilft, gerätespezifische Probleme zu erkennen, und bietet Ihnen eine breitere Testabdeckung.

  • Deaktivieren Sie Geräte-Screenshots, da Sie die Testausführungszeit beschleunigen möchten, indem Sie unnötige Screenshot-Aufnahmen überspringen, insbesondere wenn Sie keine visuelle Überprüfung benötigen.

  • Konfigurieren Sie das Gerät so, dass es zu Beginn jeder Session neu gestartet wird, da Sie eine saubere Umgebung für jeden Testdurchlauf sicherstellen möchten, um Probleme mit übrig gebliebenen Prozessen oder Daten zu vermeiden.

Beim Testen in nativen Apps fügen Sie eine Desired Capability hinzu, um die App-ID anzugeben, was den korrekten App-Start auf dem Gerät sicherstellt, und wenden gleichzeitig die zuvor definierten Capabilities an.

Ohne das Modul Add Desired Capabilities müssten Sie das Modul Set Desired Capabilities verwenden. Dies würde erfordern, dass Sie die vorherigen Capabilities manuell neu konfigurieren, um die App-ID aufzunehmen. Der stückweise Aufbau Ihrer Capabilities macht Ihre Test-Setups reibungsloser, flexibler und weniger fehleranfällig.

Module Set Desired Capabilities und Add Desired Capabilities in einem Testfall

Android Snackbar

Das Modul Android Snackbar ermöglicht es Ihnen, die Snackbar in Android-Applikationen zu steuern.

Es besitzt die folgenden Modulattribute:

Modulattribut

Beschreibung

Text

Geben Sie den Text an, der auf der Snackbar erscheint.

Action

Wenn die Snackbar eine Schaltfläche enthält, geben Sie die Aktion an, die Sie darauf ausführen möchten.

In diesem Beispiel führen Sie die folgenden Aktionen durch:

  • Sie öffnen die mobile Applikation mit dem Modul Open Mobile App.

  • Sie klicken auf die Schaltfläche Show SnackBar With Delay, wodurch die Snackbar ausgelöst wird.

  • Mit der Aktion WaitOn warten Sie, bis die Snackbar mit der Textnachricht Speed changes everything erscheint.

  • Sie überprüfen, ob die Nachricht Speed changes everything lautet.

  • Sie klicken auf eine Schaltfläche in der Snackbar, um sie zu schließen.

Modul Android Snackbar in einem Testfall

Click On Screen

Mit diesem Modul können Sie eine Tippbewegung auf einen bestimmten Punkt des Bildschirms des mobilen Geräts ausführen.

Es besitzt die folgenden Modulattribute:

Modulattribut

Beschreibung

X

Horizontale Klickposition. Geben Sie die X-Koordinate entweder in Prozent oder in Pixeln an:

  • Geben Sie für einen Prozentsatz des Bildschirms eine positive Ganzzahl von 0 (links) bis 100 (rechts) ein. Zum Beispiel 50 oder 50%.

  • Geben Sie für Pixel eine positive Ganzzahl von 0 (links) bis zur maximalen Bildschirmauflösung mit dem Suffix px ein. Zum Beispiel 250px.

Y

Vertikale Klickposition. Geben Sie die Y-Koordinate entweder in Prozent oder in Pixeln an:

  • Geben Sie für einen Prozentsatz des Bildschirms eine positive Ganzzahl von 0 (oben) bis 100 (unten) ein. Zum Beispiel 50 oder 50%.

  • Geben Sie für Pixel eine positive Ganzzahl von 0 (oben) bis zur maximalen Bildschirmauflösung mit dem Suffix px ein. Zum Beispiel 250px.

In diesem Beispiel führen Sie eine Tippbewegung bei 10% der X-Koordinate und bei 50% der Y-Koordinate von der linken oberen Ecke des Bildschirms aus.

Modul Click on Screen in einem Testfall

Download File from Mobile Device

Mit dem Modul Download File from Mobile Device können Sie eine Datei von einem Android-Gerät auf einen Rechner herunterladen (siehe Kapitel " Dateien auf Android übertragen").

Wenn die Datei bereits auf dem Rechner vorhanden ist, überschreibt die Mobile Engine 3.0 sie.

Es besitzt die folgenden Modulattribute:

Modulattribut

Beschreibung

Mobile Device Path

Geben Sie den vollständigen Pfad zu der Datei an, die Sie hochladen möchten, einschließlich Dateiname und -endung.

Verwenden Sie Schrägstriche (/) im Pfad.

Beispiel: /sdcard/Download/abc.pdf

Ersetzen Sie auf Samsung-Geräten im Dateipfad Internal Storage durch sdcard. Ersetzen Sie beispielsweise /Internal storage/Download/abc.txt durch /sdcard/Download/abc.txt.

Desktop Path

Geben Sie den vollständigen Pfad zu dem Speicherort an, an dem Sie die Datei speichern möchten, einschließlich Dateiname und -endung.

Beispiel: D:\abc.pdf

Sie können einen anderen Namen für Ihre Datei angeben.

In diesem Beispiel laden Sie die Datei example.png von Ihrem Android-Gerät auf Ihren Rechner herunter.

Modul Download File from Mobile Device in einem Testfall

Draw On Screen

Das Modul Draw On Screen ermöglicht es Ihnen, eine Form direkt auf dem Bildschirm zu zeichnen.

Das Modul hat die folgenden Modulattribute:

Modulattribut

Beschreibung

Long Tap

Geben Sie an, ob Sie die Zeichnung mit einer kurzen oder langen Tippbewegung beginnen möchten.

Mögliche Werte sind:

  • True: mit einer langen Tippbewegung beginnen.

  • False: mit einer kurzen Tippbewegung beginnen.

Duration

Geben Sie die Dauer der Bewegung in Millisekunden an.

Ein höherer Wert macht die Bewegung langsamer und kürzer. Ein niedrigerer Wert macht die Bewegung schneller und länger.

Dieses Modulattribut ist optional. Der Standardwert beträgt 300 ms.

Point->X

Geben Sie die X-Startkoordinate in Prozent an. Der ganz linke Wert ist 0 und der ganz rechte Wert ist 100.

Point->Y

Geben Sie die Y-Startkoordinate in Prozent an. Der oberste Wert ist 0 und der unterste Wert ist 100.

In diesem Beispiel zeichnen Sie eine einfache Form mit drei Wischbewegungen. Jede Bewegung dauert eine Sekunde.

Modul Draw on Screen in einem Testfall

End Appium Session

Mit dem Modul End Appium Session können Sie die aktuelle Appium-Session beenden.

In diesem Beispiel führen Sie die folgenden Aktionen durch:

  • Sie starten eine neue Appium-Session und öffnen die URL http://sampleapp.tricentis.com/101/app.php.

  • Sie interagieren mit den mobilen Controls auf dem Bildschirm.

  • Im Testschritt End Appium Session verwenden Sie das Modul End Appium Session, um Ihre aktuelle Appium-Session zu beenden.

  • Sie starten eine neue Appium-Session und interagieren mit demselben Bildschirm.

Modul End Appium Session in einem Testfall

Execute Driver Script

Mit dem Modul Execute Driver Script können Sie viele Befehle aus einem JavaScript bündeln und auf dem Appium-Server gleichzeitig ausführen. Der Appium-Server führt diesen Code in der aktuellen Session aus und gibt alle im Skript angegebenen Werte zurück. Weitere Informationen zum Schreiben des JavaScript-Codes finden Sie in der Appium-Dokumentation execute-driver-plugin (wird in einem neuen Reiter geöffnet) und WebdriverIO (wird in einem neuen Reiter geöffnet).

Dieses Modul funktioniert für Geräte, die über den Tricentis Mobile Agent und die Tricentis Device Cloud verbunden sind.

Das Modul hat die folgenden Modulattribute:

Modulattribut

Beschreibung

Driver Script from File

Geben Sie den Namen der JavaScript-Datei an, die auf dem Gerät gespeichert ist, auf dem Tosca ausgeführt wird.

Sie müssen entweder einen Wert Driver Script from File oder Inline Driver Script angeben.

Inline Driver Script

Geben Sie das Treiberskript als Testschrittwert ein.

Sie müssen entweder einen Wert Driver Script from File oder Inline Driver Script angeben.

Result

Gibt alle vom Skript angegebenen Werte zurück.

In diesem Beispiel überprüfen Sie, ob das Treiberskript die Eigenschaft username mit dem Wert testuser1 zurückgibt.

Modul Execute Driver Script in einem Testfall

Get Appium Session Id

Das Modul Get Appium Session Id ermöglicht es Ihnen, die Appium-Session-ID in einen Buffer zu schreiben.

Das Modul hat das folgende Modulattribut:

Modulattribut

Beschreibung

Buffer Name

Geben Sie den Namen des Buffers an, in dem Sie die ID Ihrer aktuellen Appium-Session speichern möchten.

In diesem Beispiel schreiben Sie die Appium-Session-ID in einen Buffer namens SampleBuffer.

Modul Get Appium Session Id in einem Testfall

ME3.0 Hardware Button Operations

Das Modul ME3.0 Hardware Button Operations ermöglicht es Ihnen, die folgenden plattformspezifischen Hardwaretasten zu steuern:

  • Home-Taste für iOS und Android

  • Back-Taste in Android

  • App Selection-Taste in Android

Es hat das folgende Modulattribut:

Modulattribut

Beschreibung

Button

Geben Sie an, auf welche Taste Sie klicken möchten. Mögliche Werte sind:

  • Home

  • Back

  • ApplicationSelector

In diesem Beispiel drücken Sie die Back-Taste in Android.

Modul ME 3.0 Hardware Button Operations in einem Testfall

ME3.0 Set Device Orientation

Mit dem Modul ME3.0 Set Device Orientation können Sie festlegen, ob die Mobile Engine 3.0 Ihr Gerät im Hoch- oder Querformat steuern soll.

Es hat das folgende Modulattribut:

Modulattribut

Beschreibung

Orientation

Geben Sie die Ausrichtung Ihres Geräts an und verwenden Sie die Aktion Select. Folgende Einstellungen stehen zur Verfügung:

  • Portrait

  • Landscape

Im folgenden Beispiel stellen Sie die Bildschirmausrichtung auf Landscape ein.

Modul ME3.0 Set Device Orientation in einem Testfall

Open Mobile App

Mit dem Modul Open Mobile App können Sie native und hybride mobile Applikationen auf Ihrem Android- oder iOS-Gerät öffnen.

Dieser Schritt ist ein obligatorischer erster Testschritt in Mobile Engine 3.0-Testfällen. Die einzige Ausnahme ist, wenn Sie Desired Capabilities festlegen möchten.

Weitere Informationen zum Modul Open Mobile App finden Sie hier: Mobile Applikationen öffnen.

Das Modul hat die folgenden Modulattribute:

Modulattribut

Beschreibung

Application

Geben Sie bei Android-Geräten und -Emulatoren den vollständigen Pfad oder den PackageName und die Activity der Applikation an, die Sie steuern möchten. Trennen Sie den PackageName von der Activity durch einen Schrägstrich (/). Wir empfehlen Ihnen jedoch, die Modulattribute AppPackage und AppActivity zu verwenden.

Geben Sie bei iOS-Geräten und -Simulatoren den vollständigen Pfad oder die BundleID der Applikation an, die Sie steuern möchten. Wir empfehlen Ihnen jedoch, das Modulattribut BundleID zu verwenden.

BundleID

Geben Sie bei iOS-Geräten und -Simulatoren die BundleID der Applikation an, die Sie steuern möchten.

AppPackage

Geben Sie bei Android-Geräten und -Emulatoren den PackageName der Applikation an, die Sie steuern möchten.

AppActivity

Geben Sie bei Android-Geräten und -Emulatoren die Activity der Applikation an, die Sie steuern möchten.

Application Path

Geben Sie bei Geräten, die mit dem Tricentis Mobile Agent verbunden sind, den vollständigen Pfad der Applikation an, die Sie steuern möchten.

In diesem Beispiel öffnen Sie die mobile Applikation mit dem Modul Open Mobile App, indem Sie den PackageName und die Activity der Applikation angeben, die Sie steuern möchten.

Modul Open Mobile App in einem Testfall

Wenn Sie eine native oder hybride App öffnen möchten, verwenden Sie das Modul OpenURL aus der Standard-Untermenge.

Wenn Sie Tricentis Tosca 12.3 oder eine frühere Version auf 2024.2 LTS aktualisieren, müssen Sie eine XEngines-Migration durchführen, um sicherzustellen, dass das Modul Open Mobile App ordnungsgemäß funktioniert. Klicken Sie dazu mit der rechten Maustaste auf das Projektwurzelelement und wählen Sie XEngines Migration->Update project to current version.

Send Text Input To Focused Control

Das Modul Send Text Input To Focused Control ermöglicht es Ihnen, Texteingaben an ein fokussiertes Control zu senden, um Benutzeraktionen zu simulieren.

Das Modul hat das folgende Modulattribut:

Modulattribut

Beschreibung

Text

Geben Sie die Texteingabe an, die Sie an ein fokussiertes Control senden möchten.

In diesem Beispiel senden Sie Texteingaben an ein dynamisches Suchfeld.

  • Der Testschritt Focused Control setzt den Fokus auf das dynamische Suchfeld.

  • Der nächste Testschritt verwendet das Modul Send Text Input To Focused Control, um Texteingaben an das Suchfeld zu senden.

  • Nach der Suche erscheint eine Aufklappliste mit Ergebnissen, die Ihrer Suchanfrage entsprechen. Der Testschritt Destination Airport wählt das richtige Ergebnis aus der Dropdown-Liste aus.

Modul Send Text Input To Focused Control in einem Testfall

Set Autohide Keyboard

Mit dem Modul Set Autohide Keyboard können Sie den automatischen Ausblendungsmodus für Tastaturen in nativen Applikationen deaktivieren. Dies wirkt sich auf die Leistung bei der Steuerung von Textfeldern aus (siehe Kapitel "Automatische Ausblendung der Tastatur in iOS deaktivieren").

Das Modul hat das folgende Modulattribut:

Modulattribut

Beschreibung

Autohide Keyboard

Geben Sie an, ob Sie den automatischen Ausblendungsmodus der iOS-Bildschirmtastatur aktivieren möchten.

Mögliche Werte sind:

  • True: automatischen Ausblendungsmodus aktivieren.

  • False: automatischen Ausblendungsmodus deaktivieren.

In diesem Beispiel deaktivieren Sie den standardmäßigen automatischen Ausblendungsmodus der iOS-Bildschirmtastatur.

Modul Set Autohide Keyboard in einem Testfall

Set iOS biometrics enrollment

Mit dem Modul Set iOS biometrics enrollment können Sie die FaceID- oder TouchID-Benutzerauthentifizierung auf Ihrem iOS-Simulator aktivieren oder deaktivieren.

Das Modul hat das folgende Modulattribut:

Modulattribut

Beschreibung

State

Aktivieren oder deaktivieren Sie die biometrische Registrierung auf Ihrem iOS-Simulator.

Mögliche Werte sind:

  • True: biometrische Registrierung aktivieren.

  • False: biometrische Registrierung deaktivieren.

In diesem Beispiel führen Sie die folgenden Aktionen durch:

  • Sie öffnen die mobile Applikation mit dem Modul Open Mobile App.

  • Sie aktivieren die biometrische Authentifizierung auf Ihrem iOS-Simulator. Im Testschritt Set iOS biometrics enrollment setzen Sie das Modulattribut State auf True.

  • Im Testschritt Click the Login button klicken Sie auf eine Schaltfläche, die eine Aktion auslöst, die wiederum eine Benutzerauthentifizierung erfordert.

  • Im Testschritt Use iOS biometric authentication setzen Sie den Typ der Benutzerauthentifizierung auf TouchID.

  • Um eine positive Authentifizierung auszulösen, setzen Sie den Testschrittwert Positive authentication auf True.

Modul Set iOS biometrics enrollment und Modul Use iOS biometric authentication in einem Testfall

Swipe On Screen

Der Modul Swipe On Screen ermöglicht es Ihnen, eine Wischbewegung direkt auf dem Bildschirm durchzuführen. Die Länge der Wischbewegung entspricht einem Drittel der mobilen Bildschirmgröße.

Das Modul hat die folgenden Modulattribute:

Modulattribut

Beschreibung

Direction

Geben Sie die Art der Wischbewegung an, die Sie durchführen möchten. Mögliche Werte sind:

  • SWIPELEFT zum Ausführen einer Wischbewegung von rechts nach links.

  • SWIPERIGHT zum Ausführen einer Wischbewegung von links nach rechts.

  • SWIPEUP zum Ausführen einer Wischbewegung von unten nach oben.

  • SWIPEDOWN zum Ausführen einer Wischbewegung von oben nach unten.

  • SWIPE zum Ausführen einer Wischbewegung, indem Sie nur den Start Point, nur den End Point oder beide definieren. Beachten Sie, dass Sie mindestens einen der Punkte angeben müssen.

Duration

Geben Sie die Dauer der Wischbewegung in Millisekunden an.

Ein höherer Wert macht die Wischbewegung langsamer und kürzer. Ein niedrigerer Wert macht die Wischbewegung schneller und länger.

Der Standardwert beträgt 300 ms.

Start Point

Definieren Sie die Startkoordinaten der Wischbewegung.

Sie können verschiedene Koordinaten angeben. Wenn Sie eine Koordinate angeben, müssen Sie auch einen Wert für die andere eingeben.

Wenn Sie keinen Startpunkt angeben, liegt die Standardeinstellung für die Wischbewegung bei 10 % vom Bildschirmrand entgegen der Wischrichtung. Wenn Sie beispielsweise die Richtung auf SWIPEUP einstellen, beginnt die Bewegung 10 % vom unteren Rand.

Start Point->X

Geben Sie die X-Koordinate entweder in Prozent oder in Pixeln an:

  • Geben Sie für einen Prozentsatz des Bildschirms eine positive Ganzzahl von 0 (links) bis 100 (rechts) ein. Zum Beispiel 50 oder 50%.

  • Geben Sie für Pixel eine positive Ganzzahl von 0 (links) bis zur maximalen Bildschirmauflösung mit dem Suffix px ein. Zum Beispiel 250px.

Start Point->Y

Geben Sie die Y-Koordinate entweder in Prozent oder in Pixeln an:

  • Geben Sie für einen Prozentsatz des Bildschirms eine positive Ganzzahl von 0 (oben) bis 100 (unten) ein. Zum Beispiel 50 oder 50%.

  • Geben Sie für Pixel eine positive Ganzzahl von 0 (oben) bis zur maximalen Bildschirmauflösung mit dem Suffix px ein. Zum Beispiel 250px.

End Point

Definieren Sie die Endkoordinaten der Wischbewegung.

Wenn Sie Endkoordinaten eingeben, setzen Sie die Direction auf SWIPE.

Wenn Sie eine Koordinate angeben, müssen Sie auch einen Wert für die andere eingeben.

Beachten Sie, dass, wenn Sie keinen Endpunkt angeben, die Standardeinstellung für die Wischbewegung die Mitte des Bildschirms ist. Wenn Sie beispielsweise die Richtung für SWIPE mit einem Startpunkt bei den Koordinaten 90 % (x) und 10 % (y) festlegen, beginnt die Bewegung in der oberen rechten Ecke und endet mit einer vertikalen Wischbewegung in der Mitte des Bildschirms mit den Koordinaten 90 % (x) und 50 % (y).

End Point->X

Geben Sie die X-Koordinate entweder in Prozent oder in Pixeln an:

  • Geben Sie für einen Prozentsatz des Bildschirms eine positive Ganzzahl von 0 (links) bis 100 (rechts) ein. Zum Beispiel 50 oder 50%.

  • Geben Sie für Pixel eine positive Ganzzahl von 0 (links) bis zur maximalen Bildschirmauflösung mit dem Suffix px ein. Zum Beispiel 250px.

End Point->Y

Geben Sie die Y-Koordinate entweder in Prozent oder in Pixeln an:

  • Geben Sie für einen Prozentsatz des Bildschirms eine positive Ganzzahl von 0 (oben) bis 100 (unten) ein. Zum Beispiel 50 oder 50%.

  • Geben Sie für Pixel eine positive Ganzzahl von 0 (oben) bis zur maximalen Bildschirmauflösung mit dem Suffix px ein. Zum Beispiel 250px.

In diesem Beispiel führen Sie eine Wischbewegung nach oben aus, die 1 Sekunde dauert.

Modul Swipe On Screen in einem Testfall

Switch Mobile App

Mit dem Modul Switch Mobile App können Sie während eines einzelnen Testfalls zu einer anderen mobilen Applikation wechseln.

Das Modul hat das folgende Modulattribut:

Modulattribut

Beschreibung

Application

Geben Sie die Applikation an, zu der Sie wechseln möchten:

  • Verwenden Sie für eine iOS-Applikation deren BundleID.

  • Verwenden Sie für eine Android-Applikation deren PackageName. Geben Sie die Activity nicht an.

In diesem Beispiel führen Sie die folgenden Aktionen durch:

  • Sie öffnen die erste mobile Applikation mit dem Modul Open Mobile App.

  • Sie klicken auf eine Bildschirmposition in der ersten Applikation.

  • Mit dem Modul Switch Mobile App wechseln Sie in die zweite mobile Applikation.

  • Sie klicken auf eine Bildschirmposition in der zweiten mobilen Applikation.

Modul Switch Mobile App in einem Testfall

Upload File to Mobile Device

Mit dem Modul Upload File to Mobile Device können Sie eine Datei von einem Rechner auf ein Android-Gerät hochladen (siehe Kapitel " Dateien auf Android übertragen"). Der Datei-Upload ist auf 2 GB begrenzt.

Wenn die Datei bereits auf dem Android-Gerät vorhanden ist, überschreibt die Mobile Engine 3.0 sie.

Es besitzt die folgenden Modulattribute:

Modulattribut

Beschreibung

Desktop Path

Geben Sie den vollständigen Pfad zu der Datei an, die Sie hochladen möchten, einschließlich Dateiname und -endung.

Beispiel: D:\abc.pdf

Mobile Device Path

Geben Sie den vollständigen Pfad zu dem Speicherort an, an dem Sie die Datei speichern möchten, einschließlich Dateiname und -endung.

Verwenden Sie Schrägstriche (/) im Pfad.

Beispiel: /sdcard/Download/abc.pdf

Sie können einen anderen Namen für Ihre Datei angeben.

Ersetzen Sie auf Samsung-Geräten im Dateipfad Internal Storage durch sdcard. Ersetzen Sie beispielsweise /Internal storage/Download/abc.txt durch /sdcard/Download/abc.txt.

Use Android fingerprint authentication

Mit dem Modul Use Android fingerprint authentication können Sie die Fingerabdruck-Authentifizierung auf Ihrem Android-Emulator verwenden.

Um dieses Modul in Ihrem Testfall zu verwenden, müssen Sie zuerst die Fingerabdruck-ID(s) auf Ihrem Android-Emulator konfigurieren.

Das Modul hat das folgende Modulattribut:

Modulattribut

Beschreibung

FingerprintId

Geben Sie die Fingerabdruck-ID ein, die Sie auf Ihrem Emulator konfiguriert haben und für die Benutzerauthentifizierung verwenden möchten.

In diesem Beispiel führen Sie die folgenden Aktionen durch:

  • Sie öffnen die mobile Applikation mit dem Modul Open Mobile App.

  • Klicken Sie im Testschritt Click the Login button auf eine Schaltfläche, die eine Benutzerauthentifizierung erfordert.

  • Im Testschritt Use Android fingerprint authentication geben Sie die Fingerabdruck-ID an. Wenn Sie die gleiche ID auf Ihrem Emulator eingestellt haben, ist die Authentifizierung positiv. Entsprechend gilt der Testschritt als bestanden.

Modul Use Android fingerprint authentication in einem Testfall

Use iOS biometric authentication

Mit dem Modul Use iOS biometric authentication können Sie die FaceID- oder TouchID-Benutzerauthentifizierung auf Ihrem iOS-Simulator verwenden.

Um dieses Modul zu verwenden, müssen Sie die biometrische Registrierung auf Ihrem iOS-Simulator aktivieren. Verwenden Sie dazu das Modul Set iOS biometrics enrollment.

Das Modul hat die folgenden Modulattribute:

Modulattribut

Beschreibung

Type of biometric authentication

Geben Sie an, welche Art von biometrischer Authentifizierung Sie verwenden möchten.

Mögliche Werte sind:

  • FaceID: Gesichts-Authentifizierung verwenden.

  • TouchID: Fingerabdruck-Authentifizierung verwenden.

Positive authentication

Geben Sie an, ob die Authentifizierung positiv oder negativ ist.

Mögliche Werte sind:

  • True: positive Authentifizierung verwenden.

  • False: negative Authentifizierung verwenden.

In diesem Beispiel führen Sie die folgenden Aktionen durch:

  • Sie öffnen die mobile Applikation mit dem Modul Open Mobile App.

  • Sie aktivieren die biometrische Authentifizierung auf Ihrem iOS-Simulator. Im Testschritt Set iOS biometrics enrollment setzen Sie das Modulattribut State auf True.

  • Im Testschritt Click the Login button klicken Sie auf eine Schaltfläche, die eine Aktion auslöst, die wiederum eine Benutzerauthentifizierung erfordert.

  • Im Testschritt Use iOS biometric authentication setzen Sie den Typ der Benutzerauthentifizierung auf TouchID.

  • Um eine positive Authentifizierung auszulösen, setzen Sie den Testschrittwert Positive authentication auf True.

Modul Set iOS biometrics enrollment und Modul Use iOS biometric authentication in einem Testfall