34.2 Ausgewählte Packages und Prozeduren

Wir werfen nun einen genaueren Blick auf ein paar ausgewählte Packages und Prozeduren der Standardbibliothek.

34.2.1 Das Android-Package

Das Package qfs.run-android enthält Prozeduren, um verschiedenste ADB-Befehle auszuführen oder mit dem Gerät zu interagieren.

Nachfolgend finden Sie einen Auszug aus der Liste der verfügbaren Prozeduren innerhalb des Packages:

• appControl-resetCurrentApp Setzt alle Daten und Berechtigungen der App zurück, die aktuell den Fokus hat, und startet sie neu.
• dataTransfer-pull Überträgt eine Datei oder einen Ordner vom Android-Gerät auf das lokale System.
• dataTransfer-push Überträgt eine Datei oder einen Ordner vom lokalen System auf das Android-Gerät.
• runAdbCommand Führt einen beliebigen ADB-Befehl aus.
• device-appSwitch Aktiviert die App-Wechsel-Schaltfläche auf dem Gerät.
• device-back Aktiviert die Zurück-Schaltfläche auf dem Gerät.
• device-home Aktiviert die Home-Schaltfläche auf dem Gerät.
• device-closeKeyboard Schließt eine möglicherweise geöffnete Bildschirmtastatur.
• device-setRotation Ändert die Bildschirmausrichtung des Geräts.

34.2.2 Das Run-log Package

Das Package qfs.run-log enthält Prozeduren, um Meldungen in das Protokoll zu schreiben.

Hier sehen Sie die Liste von verfügbaren Prozeduren innerhalb des Packages:

• logError Schreibt eine Fehlermeldung ins Protokoll.
• logWarning Schreibt eine Warnung ins Protokoll.
• logMessage Schreibt eine Meldung ins Protokoll.

34.2.3 Das Utils Package

Das Package qfs.utils enthält nützliche Prozeduren für häufig auftretende Anforderungen der Testentwicklung.

Hier sehen Sie einige Prozeduren des Packages:

• getDate Gibt einen String zurück, der ein Datum enthält. Standardmäßig wird das aktuelle Datum zurückgegeben. (Andere Daten sind konfigurierbar.)
• getTime Gibt einen String zurück, der eine Zeit enthält. Standardmäßig wird die aktuelle Zeit zurückgegeben. (Andere Zeiten sind konfigurierbar.)
• logMemory Schreibt den aktuellen Speicherverbrauch ins Protokoll.
• printVariable Gibt den Inhalt einer spezifizierten Variable auf der Konsole aus.
• printMessage Gibt den Inhalt einer angegebenen Nachricht auf der Konsole aus.
• writeMessageIntoFile Schreibt einen angegebenen String in eine angegebene Datei.

34.2.4 Das Check Package

Das qfs.check Package enthält Prozeduren, die Checks ausführen.

Die wichtigsten Prozeduren sind:

• checkEnabledStatus Überprüft, ob eine Komponente en- bzw. disabled ist. Im Fehlerfall wird von der Prozedur ein entsprechender Fehler ins Protokoll geloggt.
• checkSelectedStatus Überprüft, ob eine Komponente selektiert bzw. nicht selektiert ist. Im Fehlerfall wird von der Prozedur ein entsprechender Fehler ins Protokoll geloggt.
• checkText Überprüft den Text einer Komponente. Im Fehlerfall wird von der Prozedur ein entsprechender Fehler ins Protokoll geloggt.

34.2.5 Das Databinder Package

Das Package qfs.databinder enthält Prozeduren zur Ausführung innerhalb eines Datentreiber Knotens, um Daten für datengetriebenes Testen zu binden.

Die wichtigsten Prozeduren sind:

• bindList Bindet eine Liste von Werten an eine Variable. Die Werte sind durch Leerzeichen oder das als Parameter übergebene Trennzeichen getrennt.
• bindSets Bindet Sätze von Werten an einen Satz von Variablen. Die Sätze von Werten sind durch Zeilenumbrüche getrennt, die Werte innerhalb eines Satzes durch Leerzeichen oder das als Parameter übergebene Trennzeichen.