Umgebungsvariablen für benutzerdefinierte Testumgebungen - AWS Device Farm

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Umgebungsvariablen für benutzerdefinierte Testumgebungen

Device Farm konfiguriert dynamisch mehrere Umgebungsvariablen für die Verwendung als Teil Ihrer benutzerdefinierten Testumgebung.

Benutzerdefinierte Umgebungsvariablen

Device Farm unterstützt die Konfiguration von Schlüssel-Wert-Paaren, die als Umgebungsvariablen auf dem Testhost angewendet werden. Diese können in einem Device Farm Farm-Projekt oder während der Lauferstellung konfiguriert werden. Alle Variablen, die bei einem Lauf konfiguriert wurden, ersetzen alle Variablen, die für das übergeordnete Projekt konfiguriert wurden. Beachten Sie die folgenden Einschränkungen:

  • Benutzerdefinierte Umgebungsvariablen werden auf älteren iOS-Testhosts nicht unterstützt. Weitere Informationen finden Sie unter Legacy-iOS-Testhost.

  • Variablennamen, die mit beginnen, $DEVICEFARM_ sind für die interne Verwendung durch Dienste reserviert.

  • Benutzerdefinierte Umgebungsvariablen dürfen nicht verwendet werden, um die Computerauswahl für den Testhost in Ihrer Testspezifikation zu konfigurieren.

Allgemeine Umgebungsvariablen

In diesem Abschnitt werden Umgebungsvariablen beschrieben, die allen Tests in Device Farm gemeinsam sind.

$DEVICEFARM_DEVICE_NAME

Das Gerät, auf dem Ihre Tests ausgeführt werden. Es stellt die eindeutige Gerätekennung (UDID) des Geräts dar.

$DEVICEFARM_DEVICE_UDID

Die eindeutige Kennung des Geräts.

$DEVICEFARM_DEVICE_PLATFORM_NAME

Der Plattformname des Geräts. Es ist entweder Android oderiOS.

$DEVICEFARM_DEVICE_OS_VERSION

Die Betriebssystemversion des Geräts.

$DEVICEFARM_APP_PATH

(Tests für mobile Apps)

Der Pfad zur mobilen App auf dem Host-Computer, auf dem die Tests ausgeführt werden. Diese Variable ist bei Webtests nicht verfügbar.

$DEVICEFARM_LOG_DIR

Der Pfad zum Standardverzeichnis, in dem Kundenprotokolle, Artefakte und andere benötigte Dateien für den späteren Abruf gespeichert werden. Anhand einer Beispieltestspezifikation werden Dateien in diesem Verzeichnis in einer ZIP-Datei archiviert und nach dem Testlauf als Artefakt zur Verfügung gestellt.

$DEVICEFARM_SCREENSHOT_PATH

Der Pfad zu den Screenshots, die ggf. während des Testlaufs erfasst werden.

$DEVICEFARM_PROJECT_ARN

Der ARN des übergeordneten Projekts des Jobs.

$DEVICEFARM_RUN_ARN

Der ARN der übergeordneten Ausführung des Jobs.

$DEVICEFARM_DEVICE_ARN

Der ARN des zu testenden Geräts.

$DEVICEFARM_TOTAL_JOBS

Die Gesamtzahl der Jobs, die mit der Ausführung der übergeordneten Device Farm verknüpft sind.

$DEVICEFARM_JOB_NUMBER

Die Nummer dieses Jobs ist darin enthalten$DEVICEFARM_TOTAL_JOBS. Ein Lauf kann beispielsweise 5 Jobs enthalten, von denen jeder einen eindeutigen Wert $DEVICEFARM_JOB_NUMBER zwischen 0 und 4 hat.

$AWS_REGION

Die AWS-Region Der Dienst stellt dies so ein, dass es der Region entspricht, in der sich das zu testende Gerät befindet. Sie kann bei Bedarf durch eine benutzerdefinierte Umgebungsvariable überschrieben werden.

$ANDROID_HOME

(Nur Android)

Der Pfad zum Android SDK-Installationsverzeichnis.

Umgebungsvariablen für Appium-Tests

In diesem Abschnitt werden Umgebungsvariablen beschrieben, die von jedem Appium-Test in einer benutzerdefinierten Testumgebung in Device Farm verwendet werden.

$DEVICEFARM_CHROMEDRIVER_EXECUTABLE_DIR

(Nur Android)

Der Speicherort eines Verzeichnisses, das die erforderlichen ChromeDriver ausführbaren Dateien für die Verwendung in Appium-Web- und Hybridtests enthält.

$DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V<N>

(nur iOS)

Der abgeleitete Datenpfad einer Version von, die für die Ausführung auf Device Farm WebDriverAgent erstellt wurde. Die Nummerierung der Variablen entspricht der Hauptversion von. WebDriverAgent Als Beispiel DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V9 wird auf die WebDriverAgent A-Version von 9.x verwiesen. Weitere Informationen finden Sie unter Auswahl einer WebDriverAgent Version für iOS-Tests.

Anmerkung

Die $DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V<N> Umgebungsvariablen sind nur auf Nicht-Legacy-iOS-Hosts vorhanden. Weitere Informationen finden Sie unter Legacy-iOS-Testhost.

$DEVICEFARM_WDA_DERIVED_DATA_PATH_V9

(Nur iOS, veraltet)

Der abgeleitete Datenpfad einer Version von, die für die Ausführung auf Device Farm WebDriverAgent erstellt wurde. Das Ersatzbenennungsschema finden Sie unter. $DEVICEFARM_APPIUM_WDA_DERIVED_DATA_PATH_V<N>

Umgebungsvariablen für XCUITest Tests

In diesem Abschnitt werden Umgebungsvariablen beschrieben, die vom XCUITest Test in einer benutzerdefinierten Testumgebung in Device Farm verwendet werden.

$DEVICEFARM_XCUITESTRUN_FILE

Der Pfad zur Device Farm .xctestun Farm-Datei. Wird über Ihre App und aus Testpaketen erstellt.

$DEVICEFARM_DERIVED_DATA_PATH

Erwarteter Pfad der Xcodebuild-Ausgabe von Device Farm.

$DEVICEFARM_XCTEST_BUILD_DIRECTORY

Der Pfad zum entpackten Inhalt der Test-Paketdatei.