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.
# Testläufe in AWS Device Farm
Eine Ausführung in Device Farm stellt einen bestimmten Build Ihrer App mit einer bestimmten Reihe von Tests dar, die auf einer bestimmten Gruppe von Geräten ausgeführt werden sollen. Bei einem Lauf wird ein Bericht erstellt, der Informationen zu den Ergebnissen des Laufs enthält. Eine Ausführung umfasst einen oder mehrere Aufträge. Weitere Informationen finden Sie unter [Ausführungen](test-runs.md).
Sie können die AWS Device Farm Farm-Konsole AWS Command Line Interface (AWS CLI) oder die AWS Device Farm Farm-API verwenden, um mit Testläufen zu arbeiten.
**Topics**
+ [Einen Testlauf in Device Farm erstellen](how-to-create-test-run.md)
+ [Einstellung des Ausführungszeitlimits für Testläufe in AWS Device Farm](how-to-set-default-timeout-for-test-runs.md)
+ [Simulation von Netzwerkverbindungen und -bedingungen für Ihre AWS Device Farm Farm-Läufe](how-to-simulate-network-connections-and-conditions.md)
+ [Stoppen eines Laufs in AWS Device Farm](how-to-stop-test-runs.md)
+ [Eine Liste von Läufen in AWS Device Farm anzeigen](how-to-view-runs-list.md)
+ [Einen Gerätepool in AWS Device Farm erstellen](how-to-create-device-pool.md)
+ [Analysieren von Testergebnissen in AWS Device Farm](analyzing-results.md)
# Einen Testlauf in Device Farm erstellen
Sie können die Device Farm Farm-Konsole oder die Device Farm Farm-API verwenden AWS CLI, um einen Testlauf zu erstellen. Sie können auch ein unterstütztes Plugin verwenden, z. B. die Jenkins- oder Gradle-Plugins für Device Farm. Weitere Informationen zu den Plugins finden Sie unter [Tools und Plugins](aws-device-farm-tools-plugins.md). Weitere Informationen zu Testläufen finden Sie unter [Ausführungen](test-runs.md).
**Topics**
+ [Voraussetzungen](#how-to-create-test-run-prerequisites)
+ [Erstellen Sie einen Testlauf (Konsole)](#how-to-create-test-run-console)
+ [Erstellen Sie einen Testlauf (AWS CLI)](#how-to-create-test-run-cli)
+ [Erstellen Sie einen Testlauf (API)](#how-to-create-test-run-api)
+ [Nächste Schritte](#how-to-create-test-run-console-next-steps)
## Voraussetzungen
Sie müssen ein Projekt in Device Farm haben. Befolgen Sie die Anweisungen unter [Ein Projekt in AWS Device Farm erstellen](how-to-create-project.md), und kehren Sie dann zu dieser Seite zurück.
## Erstellen Sie einen Testlauf (Konsole)
1. Melden Sie sich bei der Device Farm Farm-Konsole unter [https://console.aws.amazon.com/devicefarm](https://console.aws.amazon.com/devicefarm) an.
1. **Wählen Sie im Navigationsbereich **Mobile Device Testing** und dann Projects aus.**
1. Wenn Sie bereits über ein Projekt verfügen, können Sie Ihre Tests in das Projekt hochladen. Wählen Sie andernfalls **Neues Projekt** aus, geben Sie einen **Projektnamen** ein und wählen Sie dann **Erstellen** aus.
1. Öffnen Sie Ihr Projekt und wählen Sie dann **Create run aus**.
1. (Optional) Geben **Sie unter Run-Einstellungen** im Abschnitt **Runname** einen Namen für Ihren Run ein. Wenn kein Name angegeben wird, benennt die Device Farm-Konsole Ihren Lauf standardmäßig „My Device Farm run“.
1. (Optional) Unter **Ausführungseinstellungen** können Sie im Abschnitt **Job-Timeout** das Ausführungstimeout für Ihren Testlauf angeben. **Wenn Sie eine unbegrenzte Anzahl von Testslots verwenden, vergewissern Sie sich, dass unter Abrechnungsmethode die Option **Unmetered** ausgewählt ist.**
1. Wählen **Sie unter Laufeinstellungen** im Abschnitt **Ausführungstyp** Ihren Ausführungstyp aus. Wählen Sie **Android-App** aus, wenn Sie noch keine App zum Testen bereit haben oder wenn Sie eine Android-App (.apk) testen. Wählen Sie **iOS-App**, wenn Sie eine iOS-App (.ipa) testen. Wählen Sie **Web-App** aus, wenn Sie Webanwendungen testen möchten.
1. **Wählen Sie unter App auswählen** im Abschnitt **App-Auswahloptionen** die Option **Von Device Farm bereitgestellte Beispiel-App auswählen aus**, wenn Sie keine App zum Testen zur Verfügung haben. Wenn Sie Ihre eigene App mitbringen, wählen Sie **Eigene App hochladen** und wählen Sie Ihre Anwendungsdatei aus. Wenn Sie eine iOS-App hochladen, müssen Sie darauf achten, **iOS device (iOS-Gerät)** auszuwählen, und keinen Simulator.
1. Wählen **Sie unter Test konfigurieren** eines der verfügbaren Test-Frameworks aus.
**Anmerkung**
Wenn Sie keine Tests verfügbar haben, wählen Sie **Built-in: Fuzz (Integriert: Fuzz)** zum Starten einer integrierten Standard-Testreihe. Wenn Sie **Built-in: Fuzz (Integriert: Fuzz)** wählen und die Felder **Event count (Ereignisanzahl)**, **Event throttle (Ereignisdrosselung)** und **Randomizer seed (Randomisierungs-Seed)** angezeigt werden, können Sie die Werte ändern oder beibehalten.
Weitere Informationen zu den verfügbaren Testreihen finden Sie unter [Test-Frameworks und integrierte Tests in AWS Device Farm](test-types.md).
1. Wenn Sie **Built-In: Fuzz** nicht ausgewählt haben, wählen Sie unter **Testpaket **auswählen die Option Datei** auswählen aus**. Suchen Sie die Datei, die Ihre Tests enthält, und wählen Sie sie aus.
1. Wählen Sie für Ihre Testumgebung die Option **Test in unserer Standardumgebung** **ausführen oder Test in einer benutzerdefinierten Umgebung** ausführen aus. Weitere Informationen finden Sie unter [Testumgebungen in AWS Device Farm](test-environments.md).
1. Wenn Sie eine benutzerdefinierte Testumgebung verwenden, können Sie optional Folgendes tun:
+ Wenn Sie die Standard-Testspezifikation in einer benutzerdefinierten Testumgebung bearbeiten möchten, wählen Sie **Edit (Bearbeiten)**, um die Standard-YAML-Spezifikation zu aktualisieren.
+ Wenn Sie die Testspezifikation geändert haben, wählen Sie **Als neu speichern**, um sie zu aktualisieren.
+ Sie können Umgebungsvariablen konfigurieren. Die hier angegebenen Variablen haben Vorrang vor allen Variablen, die im übergeordneten Projekt konfiguriert werden können.
1. Führen **Sie unter Geräte auswählen** einen der folgenden Schritte aus:
+ Um einen integrierten Gerätepool zu wählen, für den die Tests ausgeführt werden sollen, wählen Sie für **Device pool (Gerätepool)** die Option **Top Devices (Top-Geräte)**.
+ Um einen eigenen Gerätepool zu erstellen, für den die Tests ausgeführt werden sollen, befolgen Sie die Anweisungen in [Einen Gerätepool erstellen](how-to-create-device-pool.md) und kehren dann zu dieser Seite zurück.
+ Wenn Sie zuvor bereits einen eigenen Gerätepool erstellt haben, wählen Sie für **Device pool (Gerätepool)** diesen Gerätepool aus.
+ Wählen Sie **Geräte manuell auswählen** und wählen Sie die gewünschten Geräte aus, für die Sie den Betrieb ausführen möchten. Diese Konfiguration wird nicht gespeichert.
Weitere Informationen finden Sie unter [Geräteunterstützung in AWS Device FarmGeräte](devices.md).
1. (Optional) Um eine zusätzliche Konfiguration hinzuzufügen, öffnen Sie das **Drop-down-Menü Zusätzliche Konfiguration**. In diesem Abschnitt können Sie einen der folgenden Schritte ausführen:
+ Verwenden Sie das ARN-Feld Ausführungsrolle, um einen ARN für die Ausführungsrolle bereitzustellen oder einen im übergeordneten Projekt konfigurierten zu überschreiben.
+ Um weitere Daten bereitzustellen, die Device Farm während der Ausführung verwenden kann, wählen **Sie neben Zusätzliche Daten hinzufügen** die Option **Datei auswählen aus**, und suchen Sie dann die ZIP-Datei, die die Daten enthält, und wählen Sie sie aus.
+ Um eine zusätzliche App für Device Farm zu installieren, die während der Ausführung verwendet werden soll, wählen **Sie neben Andere Apps installieren** die Option **Datei auswählen aus**. Suchen Sie dann nach der APK- oder IPA-Datei, die die App enthält, und wählen Sie sie aus. Wiederholen Sie diesen Vorgang für alle anderen Apps, die Sie installieren möchten. Sie können die Installationsreihenfolge der Apps per Drag & Drop ändern, nachdem Sie diese hochgeladen haben.
+ Um anzugeben, ob bei der Ausführung Wi-Fi, Bluetooth, GPS oder NFC aktiviert sein wird, markieren Sie neben **Set radio states (Funkstati einstellen)** die jeweiligen Felder.
+ Geben Sie zur Voreinstellung von Gerätebreite und -länge für den Testlauf neben **Device location (Gerätestandort)** die Koordinaten ein.
+ Um das Geräte-Gebietsschema für die Ausführung voreinzustellen, wählen Sie unter **Gerätegebietsschema das Gebietsschema** aus.
+ Wählen Sie **Videoaufnahme aktivieren** aus, um während des Tests Videos aufzunehmen.
+ Wählen Sie **Erfassung von App-Leistungsdaten aktivieren** aus, um Leistungsdaten vom Gerät zu erfassen.
**Anmerkung**
Das Einstellen des Funkstatus und des Gebietsschemas des Geräts sind derzeit nur für native Android-Tests verfügbar.
**Anmerkung**
Wenn Sie private Geräte haben, wird auch die für private Geräte spezifische Konfiguration angezeigt.
1. Wählen Sie unten auf der Seite „**Lauf erstellen**“ aus, um den Lauf zu planen.
Device Farm startet den Lauf, sobald Geräte verfügbar sind, normalerweise innerhalb weniger Minuten. Während Ihres Testlaufs zeigt die Device Farm Farm-Konsole ![\[Device Farm scheduled a job.\]](http://docs.aws.amazon.com/de_de/devicefarm/latest/developerguide/images/df-run-calendar.png) in der Ausführungstabelle ein ausstehendes Symbol an. Jedes Gerät, das gerade ausgeführt wird, beginnt ebenfalls mit dem Symbol „Ausstehend“ und wechselt dann zu Beginn des Tests zum Symbol „![\[Device Farm progress indicator.\]](http://docs.aws.amazon.com/de_de/devicefarm/latest/developerguide/images/df-run-progress.png)Wird ausgeführt“. Nach Abschluss jedes Tests wird neben dem Gerätenamen ein Testergebnissymbol angezeigt. Wenn alle Tests abgeschlossen sind, ändert sich das Symbol für ausstehende Tests neben dem Testlauf in ein Testergebnissymbol.
Informationen zum Beenden des Testlaufs finden Sie unter[Stoppen eines Laufs in AWS Device Farm](how-to-stop-test-runs.md).
## Erstellen Sie einen Testlauf (AWS CLI)
Sie können den verwenden AWS CLI , um einen Testlauf zu erstellen.
**Topics**
+ [Schritt 1: Wählen Sie ein Projekt](#how-to-create-test-run-cli-step1)
+ [Schritt 2: Wählen Sie einen Gerätepool](#how-to-create-test-run-cli-step2)
+ [Schritt 3: Laden Sie Ihre Anwendungsdatei hoch](#how-to-create-test-run-cli-step3)
+ [Schritt 4: Laden Sie Ihr Testskript-Paket hoch](#how-to-create-test-run-cli-step4)
+ [Schritt 5: (Optional) Laden Sie Ihre benutzerdefinierte Testspezifikation hoch](#how-to-create-test-run-cli-step5)
+ [Schritt 6: Einen Testlauf planen](#how-to-create-test-run-cli-step6)
### Schritt 1: Wählen Sie ein Projekt
Sie müssen Ihren Testlauf einem Device Farm Farm-Projekt zuordnen.
1. Führen Sie den Befehl aus, um Ihre Device Farm Farm-Projekte aufzulisten**list-projects**. Wenn Sie über kein Projekt verfügen, finden Sie weitere Informationen unter [Ein Projekt in AWS Device Farm erstellen](how-to-create-project.md).
Beispiel:
```
aws devicefarm list-projects
```
Die Antwort enthält eine Liste Ihrer Device Farm Farm-Projekte.
```
{
"projects": [
{
"name": "MyProject",
"arn": "arn:aws:devicefarm:us-west-2:123456789101:project:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE",
"created": 1503612890.057
}
]
}
```
1. Wählen Sie ein Projekt aus, das mit dem Testlauf verknüpft werden soll, und notieren Sie sich den zugehörigen Amazon-Ressourcennamen (ARN).
### Schritt 2: Wählen Sie einen Gerätepool
Sie müssen einen Gerätepool auswählen, der mit Ihrem Testlauf verknüpft werden soll.
1. Um Ihre Gerätepools anzuzeigen, führen Sie **list-device-pools** unter Angabe Ihres Projekt-ARN aus.
Beispiel:
```
aws devicefarm list-device-pools --arn arn:MyProjectARN
```
Die Antwort umfasst die integrierten Gerätefarm-Gerätepools wie**Top Devices**, und alle Gerätepools, die zuvor für dieses Projekt erstellt wurden:
```
{
"devicePools": [
{
"rules": [
{
"attribute": "ARN",
"operator": "IN",
"value": "[\"arn:aws:devicefarm:us-west-2::device:example1\",\"arn:aws:devicefarm:us-west-2::device:example2\",\"arn:aws:devicefarm:us-west-2::device:example3\"]"
}
],
"type": "CURATED",
"name": "Top Devices",
"arn": "arn:aws:devicefarm:us-west-2::devicepool:example",
"description": "Top devices"
},
{
"rules": [
{
"attribute": "PLATFORM",
"operator": "EQUALS",
"value": "\"ANDROID\""
}
],
"type": "PRIVATE",
"name": "MyAndroidDevices",
"arn": "arn:aws:devicefarm:us-west-2:605403973111:devicepool:example2"
}
]
}
```
1. Wählen Sie einen Gerätepool aus und notieren Sie sich den zugehörigen ARN.
Sie können auch einen Gerätepool erstellen und dann zu diesem Schritt zurückkehren. Weitere Informationen finden Sie unter [Erstellen Sie einen Gerätepool (AWS CLI)](how-to-create-device-pool.md#how-to-create-device-pool-cli).
### Schritt 3: Laden Sie Ihre Anwendungsdatei hoch
Um Ihre Upload-Anfrage zu erstellen und eine vorsignierte Upload-URL für Amazon Simple Storage Service (Amazon S3) zu erhalten, benötigen Sie:
+ Ihren Projekt-ARN.
+ Name Ihrer App-Datei.
+ Typ des Uploads.
Weitere Informationen finden Sie unter [https://docs.aws.amazon.com/cli/latest/reference/devicefarm/create-upload.html](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/create-upload.html).
1. Führen Sie zum Hochladen einer Datei **create-upload** mit den Parametern `–-project-arn`, `--name` und `--type` aus.
Das folgende Beispiel erstellt einen Upload für eine Android-App:
```
aws devicefarm create-upload -–project-arn arn:MyProjectArn -–name MyAndroid.apk -–type ANDROID_APP
```
Die Antwort enthält Ihren App-Upload-ARN und eine vorsignierte URL.
```
{
"upload": {
"status": "INITIALIZED",
"name": "MyAndroid.apk",
"created": 1535732625.964,
"url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL",
"type": "ANDROID_APP",
"arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE"
}
}
```
1. Notieren Sie sich den App-Upload-ARN und die vorsignierte URL.
1. Laden Sie Ihre App-Datei mit der vorsignierten Amazon S3 S3-URL hoch. Dieses Beispiel verwendet **curl** zum Hochladen einer Android-.apk-Datei:
```
curl -T MyAndroid.apk "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL"
```
Weitere Informationen finden Sie unter [Hochladen von Objekten mithilfe von Presigned URLs](https://docs.aws.amazon.com/AmazonS3/latest/userguide/PresignedUrlUploadObject.html) im *Amazon Simple Storage Service-Benutzerhandbuch*.
1. Um den Status Ihres App-Uploads zu überprüfen, führen Sie **get-upload** unter Angabe des ARN des App-Uploads aus.
```
aws devicefarm get-upload –-arn arn:MyAppUploadARN
```
Warten Sie, bis der Status in der Antwort **SUCCEEDED** lautet, bevor Sie Ihr Testskript-Paket hochladen.
```
{
"upload": {
"status": "SUCCEEDED",
"name": "MyAndroid.apk",
"created": 1535732625.964,
"url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL",
"type": "ANDROID_APP",
"arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE",
"metadata": "{"valid": true}"
}
}
```
### Schritt 4: Laden Sie Ihr Testskript-Paket hoch
Als Nächstes laden Sie Ihr Testskript-Paket hoch.
1. Um Ihre Upload-Anfrage zu erstellen und eine vorsignierte Amazon S3 S3-Upload-URL zu erhalten, führen Sie den **create-upload** Befehl mit den `--type` Parametern `–-project-arn``--name`, und aus.
Dieses Beispiel erstellt einen Appium Java TestNG-Testpaket-Upload:
```
aws devicefarm create-upload –-project-arn arn:MyProjectARN -–name MyTests.zip –-type APPIUM_JAVA_TESTNG_TEST_PACKAGE
```
Die Antwort enthält Ihren Testpaket-Upload-ARN und eine vorsignierte URL.
```
{
"upload": {
"status": "INITIALIZED",
"name": "MyTests.zip",
"created": 1535738627.195,
"url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL",
"type": "APPIUM_JAVA_TESTNG_TEST_PACKAGE",
"arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE"
}
}
```
1. Notieren Sie sich den ARN des Testpaket-Uploads und die vorsignierte URL.
1. Laden Sie Ihre Testskript-Paketdatei mit der vorsignierten Amazon S3 S3-URL hoch. Dieses Beispiel verwendet **curl** zum Hochladen einer Appium TestNG-Skript-ZIP-Datei:
```
curl -T MyTests.zip "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL"
```
1. Um den Status Ihres Testskript-Paket-Uploads zu überprüfen, führen Sie **get-upload** unter Angabe des ARN des Testpaket-Uploads aus Schritt 1 aus.
```
aws devicefarm get-upload –-arn arn:MyTestsUploadARN
```
Warten Sie, bis der Status in der Antwort **SUCCEEDED** lautet, bevor Sie mit dem nächsten, optionalen Schritt fortfahren.
```
{
"upload": {
"status": "SUCCEEDED",
"name": "MyTests.zip",
"created": 1535738627.195,
"url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL",
"type": "APPIUM_JAVA_TESTNG_TEST_PACKAGE",
"arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE",
"metadata": "{"valid": true}"
}
}
```
### Schritt 5: (Optional) Laden Sie Ihre benutzerdefinierte Testspezifikation hoch
Wenn Sie Ihre Tests in einer Standard-Testumgebung ausführen, können Sie diesen Schritt überspringen.
Device Farm verwaltet eine Standardtestspezifikationsdatei für jeden unterstützten Testtyp. Als Nächstes laden Sie Ihre Standard-Testspezifikation herunter und verwenden sie zum Erstellen eines benutzerdefinierten Testspezifikation-Upload für die Ausführung Ihrer Tests in einer benutzerdefinierten Testumgebung. Weitere Informationen finden Sie unter [Testumgebungen in AWS Device Farm](test-environments.md).
1. Um den Upload-ARN für Ihre Standard-Testspezifikation zu finden, führen Sie **list-uploads** unter Angabe Ihres Projekt-ARN aus.
```
aws devicefarm list-uploads --arn arn:MyProjectARN
```
Die Antwort enthält einen Eintrag für jede Standard-Testspezifikation:
```
{
"uploads": [
{
{
"status": "SUCCEEDED",
"name": "Default TestSpec for Android Appium Java TestNG",
"created": 1529498177.474,
"url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL",
"type": "APPIUM_JAVA_TESTNG_TEST_SPEC",
"arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE"
}
}
]
}
```
1. Wählen Sie Ihre Standard-Testspezifikation aus der Liste aus. Notieren Sie deren Upload-ARN.
1. Um Ihre Standard-Spezifikation herunterzuladen, führen Sie **get-upload** unter Angabe des Upload-ARN aus.
Beispiel:
```
aws devicefarm get-upload –-arn arn:MyDefaultTestSpecARN
```
Die Antwort enthält eine vorsignierte URL zu dem Speicherort, von dem Sie Ihre Standard-Testspezifikation herunterladen können.
1. Dieses Beispiel verwendet **curl**, um die Standard-Testspezifikation herunterzuladen und als Datei unter dem Namen `MyTestSpec.yml` zu speichern:
```
curl "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL" > MyTestSpec.yml
```
1. Sie können die Standard-Testspezifikation entsprechend Ihrer Testanforderungen bearbeiten und die abgewandelte Testspezifikation dann in zukünftigen Testläufen verwenden. Überspringen Sie diesen Schritt, um die Standard-Testspezifikation unverändert in einer benutzerdefinierten Testumgebung zu verwenden.
1. Um einen Upload Ihrer benutzerdefinierten Testspezifikation zu erstellen, führen Sie **create-upload** unter Angabe des Namens und Typs Ihrer Testspezifikation und des Projekt-ARN aus.
Dieses Beispiel erstellt einen Upload für eine benutzerdefinierte Appium Java TestNG-Testspezifikation:
```
aws devicefarm create-upload --name MyTestSpec.yml --type APPIUM_JAVA_TESTNG_TEST_SPEC --project-arn arn:MyProjectARN
```
Die Antwort enthält den Testspezifikations-Upload-ARN und und die vorsignierte URL:
```
{
"upload": {
"status": "INITIALIZED",
"category": "PRIVATE",
"name": "MyTestSpec.yml",
"created": 1535751101.221,
"url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL",
"type": "APPIUM_JAVA_TESTNG_TEST_SPEC",
"arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE"
}
}
```
1. Notieren Sie sich den ARN des Testspezifikations-Uploads und die vorsignierte URL.
1. Laden Sie Ihre Testspezifikationsdatei mit der vorsignierten Amazon S3 S3-URL hoch. In diesem Beispiel wird **curl** eine Appium JavaTest NG-Testspezifikation hochgeladen:
```
curl -T MyTestSpec.yml "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL"
```
1. Um den Status Ihres Testspezifikations-Uploads zu überprüfen, führen Sie **get-upload** unter Angabe des ARN des Uploads aus.
```
aws devicefarm get-upload –-arn arn:MyTestSpecUploadARN
```
Warten Sie, bis der Status in der Antwort **SUCCEEDED** lautet, bevor Sie Ihren Testlauf planen.
```
{
"upload": {
"status": "SUCCEEDED",
"name": "MyTestSpec.yml",
"created": 1535732625.964,
"url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL",
"type": "APPIUM_JAVA_TESTNG_TEST_SPEC",
"arn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE",
"metadata": "{"valid": true}"
}
}
```
Um Ihre benutzerdefinierte Testspezifikation zu aktualisieren, führen Sie **update-upload** unter Angabe des Upload-ARN für die Testspezifikation aus. Weitere Informationen finden Sie unter [https://docs.aws.amazon.com/cli/latest/reference/devicefarm/update-upload.html](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/update-upload.html).
### Schritt 6: Einen Testlauf planen
Um einen Testlauf mit dem AWS CLI, run, zu planen**schedule-run**, geben Sie Folgendes an:
+ Projekt-ARN von [Schritt 1](#how-to-create-test-run-cli-step1).
+ Gerätepool-ARN von [Schritt 2](#how-to-create-test-run-cli-step2).
+ App-Upload-ARN von [Schritt 3](#how-to-create-test-run-cli-step3).
+ Testpaket-Upload-ARN von [Schritt 4](#how-to-create-test-run-cli-step4).
Wenn Sie Tests in einer benutzerdefinierten Umgebung ausführen, benötigen Sie außerdem Ihren Testspezifikation-ARN von [Schritt 5](#how-to-create-test-run-cli-step5).
**So planen Sie einen Testlauf in einer Standard-Testumgebung**
+ Führen Sie **schedule-run** unter Angabe von Projekt-ARN, Gerätepool-ARN, Anwendungs-Upload-ARN und Testpaketinformationen aus.
Beispiel:
```
aws devicefarm schedule-run --project-arn arn:MyProjectARN --app-arn arn:MyAppUploadARN --device-pool-arn arn:MyDevicePoolARN --name MyTestRun --test type=APPIUM_JAVA_TESTNG,testPackageArn=arn:MyTestPackageARN
```
Die Antwort enthält einen Testlauf-ARN, mittels dem Sie den Status Ihres Testlaufs überprüfen können.
```
{
"run": {
"status": "SCHEDULING",
"appUpload": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345appEXAMPLE",
"name": "MyTestRun",
"radios": {
"gps": true,
"wifi": true,
"nfc": true,
"bluetooth": true
},
"created": 1535756712.946,
"totalJobs": 179,
"completedJobs": 0,
"platform": "ANDROID_APP",
"result": "PENDING",
"devicePoolArn": "arn:aws:devicefarm:us-west-2:123456789101:devicepool:5e01a8c7-c861-4c0a-b1d5-12345devicepoolEXAMPLE",
"jobTimeoutMinutes": 150,
"billingMethod": "METERED",
"type": "APPIUM_JAVA_TESTNG",
"testSpecArn": "arn:aws:devicefarm:us-west-2:123456789101:upload:5e01a8c7-c861-4c0a-b1d5-12345specEXAMPLE",
"arn": "arn:aws:devicefarm:us-west-2:123456789101:run:5e01a8c7-c861-4c0a-b1d5-12345runEXAMPLE",
"counters": {
"skipped": 0,
"warned": 0,
"failed": 0,
"stopped": 0,
"passed": 0,
"errored": 0,
"total": 0
}
}
}
```
Weitere Informationen finden Sie unter [https://docs.aws.amazon.com/cli/latest/reference/devicefarm/schedule-run.html](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/schedule-run.html).
**So planen Sie einen Testlauf in einer benutzerdefinierten Testumgebung**
+ Die Schritte sind fast identisch mit denen für die Standard-Testumgebung mit einem zusätzlichen `testSpecArn`-Attribut im Parameter `--test`.
Beispiel:
```
aws devicefarm schedule-run --project-arn arn:MyProjectARN --app-arn arn:MyAppUploadARN --device-pool-arn arn:MyDevicePoolARN --name MyTestRun --test testSpecArn=arn:MyTestSpecUploadARN,type=APPIUM_JAVA_TESTNG,testPackageArn=arn:MyTestPackageARN
```
**So überprüfen Sie den Status Ihres Testlaufs**
+ Verwenden Sie den Befehl **get-run** und geben Sie den Testlauf-ARN an:
```
aws devicefarm get-run --arn arn:aws:devicefarm:us-west-2:111122223333:run:5e01a8c7-c861-4c0a-b1d5-12345runEXAMPLE
```
Weitere Informationen finden Sie unter [https://docs.aws.amazon.com/cli/latest/reference/devicefarm/get-run.html](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/get-run.html). Informationen zur Verwendung von Device Farm mit dem AWS CLI finden Sie unter[AWS CLI Referenz](cli-ref.md).
## Erstellen Sie einen Testlauf (API)
Die Schritte sind dieselben wie im AWS CLI Abschnitt beschrieben. Siehe [Erstellen Sie einen Testlauf (AWS CLI)](#how-to-create-test-run-cli).
Sie benötigen folgende Informationen zum Aufrufen der [https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_ScheduleRun.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_ScheduleRun.html) API:
+ Projekt-ARN. Siehe [Erstellen Sie ein Projekt (API)](how-to-create-project.md#how-to-create-project-api) und [https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateProject.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateProject.html).
+ App-Upload-ARN. Siehe [https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateUpload.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateUpload.html).
+ Testpaket Upload-ARN. Siehe [https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateUpload.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateUpload.html).
+ Gerätepool-ARN. Siehe [Einen Gerätepool erstellen](how-to-create-device-pool.md) und [https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateDevicePool.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateDevicePool.html).
**Anmerkung**
Wenn Sie Tests in einer benutzerdefinierten Testumgebung ausführen, benötigen Sie außerdem Ihren Testspezifikation-Upload-ARN. Weitere Informationen erhalten Sie unter [Schritt 5: (Optional) Laden Sie Ihre benutzerdefinierte Testspezifikation hoch](#how-to-create-test-run-cli-step5) und [https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateUpload.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateUpload.html).
Hinweise zur Verwendung der Device Farm API finden Sie unter[Device Farm automatisieren](api-ref.md).
## Nächste Schritte
In der Device Farm Farm-Konsole ![\[Device Farm scheduled a job.\]](http://docs.aws.amazon.com/de_de/devicefarm/latest/developerguide/images/df-run-calendar.png) ändert sich das Uhrsymbol in ein Ergebnissymbol, wie z. B. Erfolg![\[The test succeeded.\]](http://docs.aws.amazon.com/de_de/devicefarm/latest/developerguide/images/df-run-success.png), wenn die Ausführung abgeschlossen ist. Sobald die Tests abgeschlossen sind, wird ein Bericht für den Testlauf angezeigt. Weitere Informationen finden Sie unter [Berichte in AWS Device FarmBerichte](reports.md).
Befolgen Sie zur Nutzung des Berichts die Anweisungen unter [Testberichte in Device Farm anzeigen](how-to-use-reports.md).
# Einstellung des Ausführungszeitlimits für Testläufe in AWS Device Farm
Sie können über einen Wert festlegen, wie lange ein Testlauf ausgeführt werden soll, bevor Sie den Testlauf auf den Geräten stoppen. Der Standardwert des Ausführungstimeouts ist 150 Minuten pro Gerät, aber Sie können den Wert auf bis zu 5 Minuten heruntersetzen. Sie können die AWS Device Farm Farm-Konsole oder die AWS Device Farm Farm-API verwenden AWS CLI, um das Ausführungstimeout festzulegen.
**Wichtig**
Die Option des Ausführungstimeouts sollte auf die *maximale Dauer* für einen Testlauf festgelegt werden, zuzüglich etwas Pufferzeitraum. Beispiel: Wenn Ihr Test für ein Gerät 20 Minuten benötigt, wählen Sie als Timeout einen Wert von 30 Minuten pro Gerät.
Wenn die Ausführung auf einem Gerät den Timeoutwert überschreitet, wird die Ausführung für dieses Gerät zwangsweise beendet. Möglicherweise liefert der Test Teilergebnisse. Wenn Sie die zeitgenaue Abrechnungsoption verwenden, wird die Ausführung bis zu diesem Zeitpunkt in Rechnung gestellt. Weitere Informationen zur Preisgestaltung finden Sie unter [Device Farm Pricing](https://aws.amazon.com/device-farm/pricing/).
Sie können diese Funktion verwenden, wenn Sie wissen, wie lange die Ausführung eines Tests auf jedem Gerät dauern sollte. Wenn Sie eine Zeitbeschränkung für die Ausführung eines Test festlegen, können Sie vermeiden, dass bei Testläufen, die aus irgendeinem Grund "hängen", Geräteminuten in Rechnung gestellt werden, in denen keine Tests ausgeführt werden. Mit anderen Worten, Sie können mithilfe der Timeoutfunktion die Ausführung von Tests stoppen, wenn diese länger dauern als erwartet.
Sie können die Zeitbeschränkung für die Ausführung an zwei Stellen einstellen: auf Projektebene und auf Ebene des Testlaufs.
## Voraussetzungen
1. Führen Sie die Schritte unter [Einrichtung](setting-up.md) aus.
1. Erstellen Sie ein Projekt in Device Farm. Befolgen Sie die Anweisungen unter [Ein Projekt in AWS Device Farm erstellen](how-to-create-project.md), und kehren Sie dann zu dieser Seite zurück.
## Legen Sie das Ausführungs-Timeout für ein Projekt fest
1. Melden Sie sich bei der Device Farm Farm-Konsole unter [https://console.aws.amazon.com/devicefarm](https://console.aws.amazon.com/devicefarm) an.
1. Wählen Sie im Navigationsbereich Device Farm die Option **Mobile Device Testing** und dann **Projects** aus.
1. Wenn Sie bereits ein Projekt haben, wählen Sie es aus der Liste aus. Andernfalls wählen Sie **Neues Projekt**, geben Sie einen Namen für Ihr Projekt ein und wählen Sie dann **Absenden**.
1. Wählen Sie **Project settings (Projekteinstellungen)** aus.
1. Geben Sie auf der Registerkarte **General (Allgemein)** für **Execution Timeout (Ausführungstimeout)** einen Wert ein oder verwenden Sie den Schieberegler.
1. Wählen Sie **Speichern**.
Alle Testläufe in Ihrem Projekt verwenden nun den Wert für die Zeitbeschränkung der Ausführung, den Sie angegeben haben, es sei denn, Sie überschreiben den Zeitüberschreitungswert, wenn Sie einen Testlauf planen.
## Legen Sie das Ausführungs-Timeout für einen Testlauf fest
1. Melden Sie sich bei der Device Farm Farm-Konsole unter [https://console.aws.amazon.com/devicefarm](https://console.aws.amazon.com/devicefarm) an.
1. Wählen Sie im Navigationsbereich Device Farm die Option **Mobile Device Testing** und dann **Projects** aus.
1. Wenn Sie bereits ein Projekt haben, wählen Sie es aus der Liste aus. Andernfalls wählen Sie **Neues Projekt**, geben Sie einen Namen für Ihr Projekt ein und wählen Sie dann **Absenden**.
1. Wählen Sie **Create a new run (Neuen Lauf erstellen)**.
1. Befolgen Sie die Schritte zum Auswählen einer Anwendung, konfigurieren Ihren Test, wählen Sie die Geräte aus und geben Sie einen Gerätestatus an.
1. Geben Sie unter **Überprüfen und Ausführung starten** für **Ausführungstimeout festlegen** einen Wert ein, oder verwenden Sie den Schieberegler.
1. Wählen Sie **Confirm and start run (Bestätigen und Testlauf starten)**.
# Simulation von Netzwerkverbindungen und -bedingungen für Ihre AWS Device Farm Farm-Läufe
Sie können Network Shaping verwenden, um Netzwerkverbindungen und -bedingungen zu simulieren, während Sie Ihre Android-, iOS- und Web-Apps in Device Farm testen. Sie können beispielsweise eine verlustbehaftete oder unterbrochene Internetverbindung simulieren.
Wenn Sie eine Ausführung unter Verwendung der Standard-Netzwerkeinstellungen erstellen, verfügt jedes Gerät über eine vollständige, ungehinderte Wi-Fi-Verbindung mit Internet-Konnektivität. Wenn Sie Network Shaping verwenden, können Sie die Wi-Fi-Verbindung ändern, um ein Netzwerkprofil wie **3G** oder **Lossy** anzugeben, das den Durchsatz, WiFi die Verzögerung, den Jitter und den Verlust sowohl für eingehenden als auch für ausgehenden Verkehr steuert.
**Topics**
+ [Richten Sie Network Shaping ein, wenn Sie einen Testlauf planen](#network-shaping-how-to-choose-a-curated-profile-when-scheduling-a-test-run)
+ [Erstellen Sie ein Netzwerkprofil](#network-shaping-how-to-create-a-network-profile)
+ [Ändern Sie die Netzwerkbedingungen während des Tests](#change-network-conditions-during-test)
## Richten Sie Network Shaping ein, wenn Sie einen Testlauf planen
Wenn Sie einen Lauf planen, können Sie aus einem der von Device Farm kuratierten Profile wählen oder Ihr eigenes Profil erstellen und verwalten.
1. Wählen Sie in einem beliebigen Device Farm Farm-Projekt **Create a new run aus**.
Falls Sie noch keine Projekte besitzen, finden Sie unter [Ein Projekt in AWS Device Farm erstellen](how-to-create-project.md) weitere Informationen.
1. Wählen Sie Ihre Anwendung und dann **Weiter** aus.
1. Konfigurieren Sie Ihren Test und wählen Sie dann **Weiter**.
1. Wählen Sie Ihre Geräte aus und wählen Sie dann **Weiter**.
1. Wählen Sie im Abschnitt **Standort- und Netzwerkeinstellungen** ein Netzwerkprofil aus, oder wählen Sie **Netzwerkprofil erstellen**, um Ihr eigenes zu erstellen.
![\[Netzwerkprofil für einen Testlauf\]](http://docs.aws.amazon.com/de_de/devicefarm/latest/developerguide/images/aws-device-farm-set-up-network-profile.png)
1. Wählen Sie **Weiter** aus.
1. Überprüfen und starten Sie Ihren Testlauf.
## Erstellen Sie ein Netzwerkprofil
Wenn Sie einen Testlauf erstellen, können Sie ein neues Netzwerkprofil erstellen.
1. Wählen Sie **Netzwerkprofil erstellen**.
![\[Erstellen eines neuen Netzwerkprofils\]](http://docs.aws.amazon.com/de_de/devicefarm/latest/developerguide/images/aws-device-farm-create-a-new-network-profile.png)
1. Geben Sie einen Namen und die Einstellungen für Ihr Netzwerkprofil ein.
1. Wählen Sie **Erstellen** aus.
1. Beenden Sie das Erstellen Ihres Testlaufs und starten Sie den Durchlauf.
Nachdem Sie ein Netzwerkprofil erstellt haben, können Sie es auf der Seite **Project settings (Projekteinstellungen)** anzeigen und verwalten.
![\[Netzwerkprofile in Projekteinstellungen\]](http://docs.aws.amazon.com/de_de/devicefarm/latest/developerguide/images/aws-device-farm-network-profiles-in-project-settings.png)
## Ändern Sie die Netzwerkbedingungen während des Tests
Sie können eine API von Ihrem Gerätehost aus aufrufen, indem Sie ein Framework wie Appium verwenden, um dynamische Netzwerkbedingungen wie reduzierte Bandbreite während Ihres Testlaufs zu simulieren. Weitere Informationen finden Sie unter [CreateNetworkProfile](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateNetworkProfile.html).
# Stoppen eines Laufs in AWS Device Farm
Sie möchten möglicherweise einen Testlauf stoppen, nachdem Sie ihn gestartet haben. Wenn Sie beispielsweise ein Problem während der Ausführung Ihrer Tests feststellen, möchten Sie den Testlauf möglicherweise mit einem aktualisierten Testskript erneut starten.
Sie können die Device Farm Farm-Konsole oder die API verwenden AWS CLI, um einen Lauf zu beenden.
**Topics**
+ [Stoppen Sie einen Lauf (Konsole)](#how-to-stop-run-console)
+ [Stoppen Sie einen Lauf ()AWS CLI](#how-to-stop-test-run-cli)
+ [Stoppen Sie einen Lauf (API)](#how-to-stop-test-run-api)
## Stoppen Sie einen Lauf (Konsole)
1. Melden Sie sich bei der Device Farm Farm-Konsole unter [https://console.aws.amazon.com/devicefarm](https://console.aws.amazon.com/devicefarm) an.
1. Wählen Sie im Navigationsbereich Device Farm die Option **Mobile Device Testing** und dann **Projects** aus.
1. Wählen Sie das Projekt aus, für das Sie einen aktiven Testlauf durchgeführt haben.
1. Wählen Sie auf der Seite **Automatisierte Tests** den Testlauf aus.
Das Symbol „Ausstehend“ oder „Wird ausgeführt“ sollte links neben dem Gerätenamen angezeigt werden.
![\[Device Farm – Stoppen eines Testlaufs\]](http://docs.aws.amazon.com/de_de/devicefarm/latest/developerguide/images/aws-device-farm-stop-run.png)
1. Wählen Sie **Stop run (Testlauf stoppen)**.
Nach kurzer Zeit erscheint neben dem Gerätenamen ein Symbol mit einem roten Kreis und einem Minus darin. Wenn der Lauf gestoppt wurde, wechselt die Farbe des Symbols von rot nach schwarz.
**Wichtig**
Wenn ein Test bereits ausgeführt wurde, kann Device Farm ihn nicht beenden. Wenn ein Test läuft, stoppt Device Farm den Test. Die Gesamtzahl der Minuten, für die Sie Gebühren zahlen müssen, wird im Bereich **Devices (Geräte)** angezeigt. Darüber hinaus werden Ihnen auch die Gesamtminuten in Rechnung gestellt, die Device Farm benötigt, um die Setup Suite und die Teardown Suite auszuführen. Weitere Informationen finden Sie unter [Device Farm – Preise](https://aws.amazon.com/device-farm/faq/#pricing).
In der folgenden Abbildung wird ein Beispiel des Bereichs **Devices (Geräte)** angezeigt, nachdem der Testlauf erfolgreich gestoppt wurde.
![\[Device Farm – Detailseite eines gestoppten Testlaufs\]](http://docs.aws.amazon.com/de_de/devicefarm/latest/developerguide/images/aws-device-farm-stop-run-view-details.png)
## Stoppen Sie einen Lauf ()AWS CLI
Sie können den folgenden Befehl ausführen, um den angegebenen Testlauf zu beenden. Dabei *myARN* handelt es sich um den Amazon-Ressourcennamen (ARN) des Testlaufs.
```
$ aws devicefarm stop-run --arn myARN
```
Die Ausgabe sollte folgendermaßen oder ähnlich aussehen:
```
{
"run": {
"status": "STOPPING",
"name": "Name of your run",
"created": 1458329687.951,
"totalJobs": 7,
"completedJobs": 5,
"deviceMinutes": {
"unmetered": 0.0,
"total": 0.0,
"metered": 0.0
},
"platform": "ANDROID_APP",
"result": "PENDING",
"billingMethod": "METERED",
"type": "BUILTIN_EXPLORER",
"arn": "myARN",
"counters": {
"skipped": 0,
"warned": 0,
"failed": 0,
"stopped": 0,
"passed": 0,
"errored": 0,
"total": 0
}
}
}
```
Um den ARN Ihres Testlaufs zu erhalten, verwenden Sie den Befehl `list-runs`. Die Ausgabe sollte folgendermaßen oder ähnlich aussehen:
```
{
"runs": [
{
"status": "RUNNING",
"name": "Name of your run",
"created": 1458329687.951,
"totalJobs": 7,
"completedJobs": 5,
"deviceMinutes": {
"unmetered": 0.0,
"total": 0.0,
"metered": 0.0
},
"platform": "ANDROID_APP",
"result": "PENDING",
"billingMethod": "METERED",
"type": "BUILTIN_EXPLORER",
"arn": "Your ARN will be here",
"counters": {
"skipped": 0,
"warned": 0,
"failed": 0,
"stopped": 0,
"passed": 0,
"errored": 0,
"total": 0
}
}
]
}
```
Informationen zur Verwendung von Device Farm mit dem AWS CLI finden Sie unter[AWS CLI Referenz](cli-ref.md).
## Stoppen Sie einen Lauf (API)
+ Rufen Sie den [StopRun](../../latest/APIReference/API_StopRun.html)Vorgang zum Testlauf auf.
Hinweise zur Verwendung der Device Farm API finden Sie unter[Device Farm automatisieren](api-ref.md).
# Eine Liste von Läufen in AWS Device Farm anzeigen
Sie können die Device Farm Farm-Konsole oder die API verwenden AWS CLI, um eine Liste der Ausführungen für ein Projekt anzuzeigen.
**Topics**
+ [Eine Liste der Läufe anzeigen (Konsole)](#how-to-view-runs-list-console)
+ [Eine Liste von Läufen anzeigen (AWS CLI)](#how-to-view-runs-list-cli)
+ [Eine Liste der Läufe anzeigen (API)](#how-to-view-runs-list-api)
## Eine Liste der Läufe anzeigen (Konsole)
1. Melden Sie sich bei der Device Farm Farm-Konsole unter [https://console.aws.amazon.com/devicefarm](https://console.aws.amazon.com/devicefarm) an.
1. Wählen Sie im Navigationsbereich Device Farm die Option **Mobile Device Testing** und dann **Projects** aus.
1. Wählen Sie in der Liste der Projekte das Projekt aus, das der Liste der Testläufe entspricht, die Sie anzeigen möchten.
**Tipp**
Sie können die Suchleiste verwenden, um die Projektliste nach Namen zu filtern.
## Eine Liste von Läufen anzeigen (AWS CLI)
+ Führen Sie den Befehl [https://docs.aws.amazon.com/cli/latest/reference/devicefarm/list-runs.html](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/list-runs.html) aus.
Um Informationen zu einer einzigen Ausführung anzuzeigen, führen Sie den Befehl [https://docs.aws.amazon.com/cli/latest/reference/devicefarm/get-run.html](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/get-run.html) aus.
Informationen zur Verwendung von Device Farm mit dem AWS CLI finden Sie unter[AWS CLI Referenz](cli-ref.md).
## Eine Liste der Läufe anzeigen (API)
+ Rufen Sie die [https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_ListRuns.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_ListRuns.html)-API auf.
Um Informationen zu einer einzigen Ausführung anzuzeigen, rufen Sie die [https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_GetRun.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_GetRun.html)-API auf.
Informationen zur Device Farm API finden Sie unter[Device Farm automatisieren](api-ref.md).
# Einen Gerätepool in AWS Device Farm erstellen
Sie können die Device Farm Farm-Konsole oder die API verwenden AWS CLI, um einen Gerätepool zu erstellen.
**Topics**
+ [Voraussetzungen](#how-to-create-device-pool-prerequisites)
+ [Erstellen Sie einen Gerätepool (Konsole)](#how-to-create-device-pool-console)
+ [Erstellen Sie einen Gerätepool (AWS CLI)](#how-to-create-device-pool-cli)
+ [Erstellen Sie einen Gerätepool (API)](#how-to-create-device-pool-api)
## Voraussetzungen
+ Erstellen Sie einen Lauf in der Device Farm Farm-Konsole. Folgen Sie den Anweisungen in [Einen Testlauf in Device Farm erstellen](how-to-create-test-run.md). Wenn Sie die Seite **Select devices (Geräte auswählen)** erreichen, fahren Sie mit den Anweisungen in diesem Abschnitt fort.
## Erstellen Sie einen Gerätepool (Konsole)
1. Wählen Sie auf der Seite **Projekte** Ihr Projekt aus. Wählen Sie auf der Seite mit den **Projektdetails** die Option **Projekteinstellungen** aus. Wählen Sie auf der Registerkarte **Gerätepools** die Option **Gerätepool erstellen** aus.
1. Geben Sie unter **Name** einen Namen ein, an dem Sie den Gerätepool leicht erkennen können.
1. Geben Sie unter **Description (Beschreibung)** eine Beschreibung ein, an der Sie den Gerätepool leicht erkennen können.
1. Wenn Sie eine oder mehrere Auswahlkriterien für die Geräte in diesem Gerätepool verwenden möchten, führen Sie die folgenden Schritte aus:
1. Wählen Sie **Dynamischen Gerätepool erstellen**.
1. Wählen **Sie Regel hinzufügen** aus.
1. Wählen Sie für **Feld** (erste Dropdownliste) eine der folgenden Optionen aus:
+ Um Geräte nach ihrem Herstellernamen anzuzeigen, wählen Sie **Gerätehersteller** aus.
+ Um Geräte nach ihrem Formfaktor (Tablet oder Telefon) einzubeziehen, wählen Sie „**Formfaktor**“.
+ Um Geräte nach ihrem Verfügbarkeitsstatus basierend auf der Auslastung einzubeziehen, wählen Sie **Verfügbarkeit**.
+ Um nur öffentliche oder private Geräte einzubeziehen, wählen Sie **Flottenart**.
+ Um Geräte nach ihrem Betriebssystem einzubeziehen, wählen Sie **Plattform**.
+ Einige Geräte verfügen über ein zusätzliches Etikett oder eine Beschreibung des Geräts. Du kannst Geräte anhand ihres Labelinhalts suchen, indem du **Instanzbezeichnungen auswählst**.
+ Um Geräte nach ihrer Betriebssystemversion einzubeziehen, wählen Sie **Betriebssystemversion**.
+ Um Geräte nach ihrem Modell einzubeziehen, wählen Sie **Modell**.
1. Wählen Sie unter **Operator** (zweite Dropdownliste) eine logische Operation (EQUALS, CONTAINS usw.) aus, um Geräte basierend auf der Abfrage einzubeziehen. Sie könnten beispielsweise Geräte *Availability EQUALS AVAILABLE* einbeziehen, die derzeit den `Available` Status haben.
1. Geben Sie **unter Wert** (dritte Dropdownliste) den Wert ein, den Sie für die Werte **Feld** und **Operator** angeben möchten, oder wählen Sie ihn aus. Die Werte sind je nach Ihrer **Feldauswahl** begrenzt. Wenn Sie beispielsweise „**Plattform**“ für „**Feld“** wählen, sind nur die Optionen **ANDROID** und **IOS** verfügbar. **Wenn Sie „**Formfaktor**“ für „**Feld“** auswählen, sind ebenfalls nur die Optionen **PHONE** und TABLET verfügbar.**
1. Um eine weitere Regel hinzuzufügen, wählen Sie **Regel hinzufügen** aus.
Nachdem Sie die erste Regel erstellt haben, wird in der Geräteliste das Kontrollkästchen neben jedem Gerät, das mit der Regel übereinstimmt, aktiviert. Wenn Sie weitere Regeln erstellt oder vorhandene Regeln geändert haben, wird in der Geräteliste das Kontrollkästchen neben den Geräten, die mit diesen kombinierten Regeln übereinstimmen, aktiviert. Geräte mit aktivierten Kontrollkästchen sind im Gerätepool eingeschlossen. Geräte mit deaktivieren Kontrollkästchen sind ausgeschlossen.
1. Geben Sie unter **Max. Geräte** die Anzahl der Geräte ein, die Sie in Ihrem Gerätepool verwenden möchten. Wenn Sie die maximale Anzahl von Geräten nicht eingeben, wählt Device Farm alle Geräte in der Flotte aus, die den von Ihnen erstellten Regeln entsprechen. Um zusätzliche Gebühren zu vermeiden, setzen Sie diese Zahl auf einen Betrag, der Ihren tatsächlichen Anforderungen an die parallel Ausführung und die Gerätevielfalt entspricht.
1. Um eine Regel zu löschen, wählen Sie **Regel entfernen**.
1. Wenn Sie einzelne Geräte manuell ein- oder ausschließen möchten, gehen Sie wie folgt vor:
1. Wählen Sie **Statischen Gerätepool erstellen** aus.
1. Aktivieren oder deaktivieren Sie das Kästchen neben jedem Gerät. Sie können die Kontrollkästchen nur aktivieren oder deaktivieren, wenn keine Regeln angegeben wurden.
1. Wenn Sie alle angezeigten Geräte ein- oder ausschließen möchten, aktivieren oder deaktivieren Sie das Kontrollkästchen in der Spaltenüberschriftenzeile der Liste. Wenn Sie nur private Geräteinstanzen anzeigen möchten, wählen **Sie Nur private Geräteinstanzen** anzeigen.
**Wichtig**
Auch wenn Sie die Kontrollkästchen in der Spaltenüberschriftenzeile verwenden können, um die Liste der angezeigten Geräte zu ändern, bedeutet das nicht, dass die verbleibenden angezeigten Geräte die einzigen sind, die aus- oder ausgeschlossen sind. Um zu bestätigen, welche Geräte ein- oder ausgeschlossen sind, löschen Sie den Inhalt aller Felder in der Spaltenüberschriftenzeile. Durchsuchen Sie anschließend die Felder.
1. Wählen Sie **Erstellen** aus.
## Erstellen Sie einen Gerätepool (AWS CLI)
**Tipp**
Wenn Sie die maximale Anzahl von Geräten nicht eingeben, wählt Device Farm alle Geräte in der Flotte aus, die den von Ihnen erstellten Regeln entsprechen. Um zusätzliche Gebühren zu vermeiden, setzen Sie diese Zahl auf einen Betrag, der Ihren tatsächlichen Anforderungen an die parallel Ausführung und die Gerätevielfalt entspricht.
+ Führen Sie den Befehl [https://docs.aws.amazon.com/cli/latest/reference/devicefarm/create-device-pool.html](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/create-device-pool.html) aus.
Informationen zur Verwendung von Device Farm mit dem AWS CLI finden Sie unter[AWS CLI Referenz](cli-ref.md).
## Erstellen Sie einen Gerätepool (API)
**Tipp**
Wenn Sie die maximale Anzahl von Geräten nicht eingeben, wählt Device Farm alle Geräte in der Flotte aus, die den von Ihnen erstellten Regeln entsprechen. Um zusätzliche Gebühren zu vermeiden, setzen Sie diese Zahl auf einen Betrag, der Ihren tatsächlichen Anforderungen an die parallel Ausführung und die Gerätevielfalt entspricht.
+ Rufen Sie die [https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateDevicePool.html](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_CreateDevicePool.html)-API auf.
Hinweise zur Verwendung der Device Farm API finden Sie unter[Device Farm automatisieren](api-ref.md).
# Analysieren von Testergebnissen in AWS Device Farm
In der Standardtestumgebung können Sie die Device Farm Farm-Konsole verwenden, um Berichte für jeden Test in Ihrem Testlauf anzuzeigen. Anhand der Berichte können Sie nachvollziehen, welche Tests bestanden oder nicht bestanden haben. Außerdem erhalten Sie Informationen zur Leistung und zum Verhalten Ihrer App in verschiedenen Gerätekonfigurationen.
Device Farm sammelt auch andere Artefakte wie Dateien, Protokolle und Bilder, die Sie herunterladen können, wenn Ihr Testlauf abgeschlossen ist. Mithilfe dieser Informationen können Sie analysieren, wie sich Ihre App auf echten Geräten verhält, Probleme oder Bugs identifizieren und Probleme diagnostizieren.
**Topics**
+ [Testberichte in Device Farm anzeigen](how-to-use-reports.md)
+ [Artefakte in Device Farm herunterladen](artifacts.md)
# Testberichte in Device Farm anzeigen
Verwenden Sie die Device Farm Farm-Konsole, um Ihre Testberichte anzuzeigen. Weitere Informationen finden Sie unter [Berichte in AWS Device FarmBerichte](reports.md).
**Topics**
+ [Voraussetzungen](#how-to-use-reports-prerequisites)
+ [Berichte anzeigen](#how-to-use-reports-viewing-reports)
+ [Status der Device Farm Farm-Testergebnisse](how-to-use-reports-displaying-results.md)
## Voraussetzungen
Richten Sie einen Testlauf ein und stellen Sie sicher, dass er abgeschlossen ist.
1. Um einen Testlauf zu erstellen, befolgen Sie die Anweisungen unter [Einen Testlauf in Device Farm erstellen](how-to-create-test-run.md) und kehren Sie dann zu dieser Seite zurück.
1. Stellen Sie sicher, dass der Testlauf abgeschlossen ist. Während Ihres Testlaufs zeigt die Device Farm Farm-Konsole ein Symbol ![\[Device Farm scheduled a job.\]](http://docs.aws.amazon.com/de_de/devicefarm/latest/developerguide/images/df-run-calendar.png) für laufende Läufe an. Jedes Gerät, das gerade ausgeführt wird, beginnt ebenfalls mit dem Symbol „Ausstehend“ und wechselt dann zu Beginn des Tests zum ![\[Device Farm progress indicator.\]](http://docs.aws.amazon.com/de_de/devicefarm/latest/developerguide/images/df-run-progress.png) Symbol „Wird ausgeführt“. Nach Abschluss jedes Tests wird neben dem Gerätenamen ein Testergebnissymbol angezeigt. Wenn alle Tests abgeschlossen sind, ändert sich das Symbol für ausstehende Tests neben dem Testlauf in ein Testergebnissymbol. Weitere Informationen finden Sie unter [Status der Device Farm Farm-Testergebnisse](how-to-use-reports-displaying-results.md).
## Berichte anzeigen
Sie können die Ergebnisse Ihres Tests in der Device Farm Farm-Konsole anzeigen.
**Topics**
+ [Sehen Sie sich die Seite mit der Zusammenfassung des Testlaufs an](#how-to-use-reports-console-summary)
+ [Einzigartige Problemberichte anzeigen](#how-to-use-reports-console-unique-problems)
+ [Geräteberichte anzeigen](#how-to-use-reports-console-by-device)
+ [Berichte der Testsuite anzeigen](#how-to-use-reports-console-by-suite)
+ [Anzeigen von Testberichten](#how-to-use-reports-console-by-test)
+ [Protokollinformationen für ein Problem, ein Gerät, eine Suite oder einen Test in einem Bericht anzeigen](#how-to-use-reports-console-log)
### Sehen Sie sich die Seite mit der Zusammenfassung des Testlaufs an
1. Melden Sie sich bei der Device Farm Farm-Konsole unter [https://console.aws.amazon.com/devicefarm](https://console.aws.amazon.com/devicefarm) an.
1. **Wählen Sie im Navigationsbereich **Mobile Device Testing** und dann Projects aus.**
1. Wählen Sie in der Liste der Projekte das Projekt für den Testlauf aus.
**Tipp**
Verwenden Sie die Suchleiste, um die Projektliste nach Namen zu filtern.
1. Wählen Sie einen abgeschlossenen Testlauf zum Anzeigen seiner Berichtsübersichtseite aus.
1. Die Testlauf-Übersichtsseite zeigt eine Übersicht Ihrer Testergebnisse an.
+ Im Bereich **Unique problems (Eindeutige Probleme)** werden eindeutige Warnungen und Fehler aufgeführt. Um eindeutige Probleme anzuzeigen, befolgen Sie die Anweisungen unter [Einzigartige Problemberichte anzeigen](#how-to-use-reports-console-unique-problems).
+ Im Bereich **Devices (Geräte)** wird für jedes Gerät die Gesamtanzahl der Tests nach Ergebnissen angezeigt.
![\[Device Farm device summary results.\]](http://docs.aws.amazon.com/de_de/devicefarm/latest/developerguide/images/df-run-device-summary-results-bar.png)
In diesem Beispiel gibt es mehrere Geräte. Im ersten Tabelleneintrag meldet das Google Pixel 4 XL-Gerät mit Android Version 10 drei erfolgreiche Tests, deren Ausführung 02:36 Minuten gedauert hat.
Um die Ergebnisse nach Gerät anzuzeigen, befolgen Sie die Anweisungen unter [Geräteberichte anzeigen](#how-to-use-reports-console-by-device).
+ Im Abschnitt **Screenshots** wird eine Liste aller Screenshots angezeigt, die Device Farm während des Laufs aufgenommen hat, gruppiert nach Geräten.
+ Im Bereich **Parsing-Ergebnisse können Sie das Parsing-Ergebnis** herunterladen.
### Einzigartige Problemberichte anzeigen
1. Wählen Sie unter **Unique problems (Eindeutige Probleme)** das Problem aus, das Sie anzeigen möchten.
1. Wählen Sie das Gerät aus. Der Bericht zeigt die Informationen zu dem Problem an.
Im Bereich **Video** wird eine Videoaufnahme des Tests angezeigt, die Sie herunterladen können.
Im Abschnitt **Ergebnis** wird das Ergebnis des Tests angezeigt. Der Status wird als Ergebnissymbol dargestellt. Weitere Informationen finden Sie unter [Status eines einzelnen Tests](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-individual).
Im Abschnitt **Protokolle** werden alle Informationen angezeigt, die Device Farm während des Tests protokolliert hat. Sie können diese Informationen anzeigen, indem Sie die Anweisungen unter [Protokollinformationen für ein Problem, ein Gerät, eine Suite oder einen Test in einem Bericht anzeigen](#how-to-use-reports-console-log) befolgen.
Auf der Registerkarte **Dateien** wird eine Liste aller mit dem Test verknüpften Dateien (z. B. Protokolldateien) angezeigt, die Sie herunterladen können. Sie können eine Datei herunterladen, indem Sie auf den Link in der Liste klicken.
Auf der Registerkarte **Screenshots** wird eine Liste aller Screenshots angezeigt, die Device Farm während des Tests aufgenommen hat.
### Geräteberichte anzeigen
+ Wählen Sie im Abschnitt **Devices (Geräte)** das Gerät aus.
Im Bereich **Video** wird eine Videoaufnahme des Tests angezeigt, die Sie herunterladen können.
Im Bereich **Suiten** wird eine Tabelle mit Informationen zu den Suiten für das Gerät angezeigt.
In dieser Tabelle wird in der Spalte **Testergebnisse** die Anzahl der Tests nach Ergebnissen für jede der Testsuiten zusammengefasst, die auf dem Gerät ausgeführt wurden. Diese Daten haben auch eine grafische Komponente. Weitere Informationen finden Sie unter [Status für mehrere Tests](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-summary).
Um die vollständigen Ergebnisse nach Suiten aufgeschlüsselt anzuzeigen, folgen Sie den Anweisungen unter[Berichte der Testsuite anzeigen](#how-to-use-reports-console-by-suite).
Im Abschnitt **Protokolle** werden alle Informationen angezeigt, die Device Farm während der Ausführung für das Gerät protokolliert hat. Sie können diese Informationen anzeigen, indem Sie die Anweisungen unter [Protokollinformationen für ein Problem, ein Gerät, eine Suite oder einen Test in einem Bericht anzeigen](#how-to-use-reports-console-log) befolgen.
Im Abschnitt **Dateien** werden eine Liste der Suites für das Gerät und alle zugehörigen Dateien (z. B. Protokolldateien) angezeigt, die Sie herunterladen können. Sie können eine Datei herunterladen, indem Sie auf den Link in der Liste klicken.
Im Abschnitt **Screenshots** wird eine nach Suite gruppierte Liste aller Screenshots angezeigt, die Device Farm während der Ausführung für das Gerät aufgenommen hat.
### Berichte der Testsuite anzeigen
1. Wählen Sie im Abschnitt **Devices (Geräte)** das Gerät aus.
1. Wählen Sie im Bereich **Suiten** die Suite aus der Tabelle aus.
Im Bereich **Video** wird eine Videoaufnahme des Tests angezeigt, die Sie herunterladen können.
Im Abschnitt **Tests** wird eine Tabelle mit Informationen zu den Tests in der Suite angezeigt.
In der Tabelle wird in der Spalte **Testergebnisse** das Ergebnis angezeigt. Diese Daten haben auch eine grafische Komponente. Weitere Informationen finden Sie unter [Status für mehrere Tests](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-summary).
Folgen Sie den Anweisungen unter, um die vollständigen Testergebnisse nach Tests einzusehen[Anzeigen von Testberichten](#how-to-use-reports-console-by-test).
Im Abschnitt **Protokolle** werden alle Informationen angezeigt, die Device Farm während der Ausführung der Suite protokolliert hat. Sie können diese Informationen anzeigen, indem Sie die Anweisungen unter [Protokollinformationen für ein Problem, ein Gerät, eine Suite oder einen Test in einem Bericht anzeigen](#how-to-use-reports-console-log) befolgen.
Im Abschnitt **Dateien** werden eine Liste der Tests für die Suite und alle zugehörigen Dateien (z. B. Protokolldateien) angezeigt, die Sie herunterladen können. Sie können eine Datei herunterladen, indem Sie auf den Link in der Liste klicken.
Im Abschnitt **Screenshots** wird eine Liste aller Screenshots angezeigt, die Device Farm während der Ausführung für die Suite aufgenommen hat, gruppiert nach Tests.
### Anzeigen von Testberichten
1. Wählen Sie im Abschnitt **Devices (Geräte)** das Gerät aus.
1. Wählen Sie die Testreihe im Bereich **Suites (Testreihen)** aus.
1. Wählen Sie im Abschnitt **Tests** den Test aus.
1. Im Bereich **Video** wird eine Videoaufnahme des Tests angezeigt, die Sie herunterladen können.
Im Abschnitt **Ergebnis** wird das Ergebnis des Tests angezeigt. Der Status wird als Ergebnissymbol dargestellt. Weitere Informationen finden Sie unter [Status eines einzelnen Tests](how-to-use-reports-displaying-results.md#how-to-use-reports-displaying-results-individual).
Im Abschnitt **Protokolle** werden alle Informationen angezeigt, die Device Farm während des Tests protokolliert hat. Sie können diese Informationen anzeigen, indem Sie die Anweisungen unter [Protokollinformationen für ein Problem, ein Gerät, eine Suite oder einen Test in einem Bericht anzeigen](#how-to-use-reports-console-log) befolgen.
Auf der Registerkarte **Dateien** wird eine Liste aller mit dem Test verknüpften Dateien (z. B. Protokolldateien) angezeigt, die Sie herunterladen können. Sie können eine Datei herunterladen, indem Sie auf den Link in der Liste klicken.
Auf der Registerkarte **Screenshots** wird eine Liste aller Screenshots angezeigt, die Device Farm während des Tests aufgenommen hat.
### Protokollinformationen für ein Problem, ein Gerät, eine Suite oder einen Test in einem Bericht anzeigen
Im Abschnitt **Protokolle** werden die folgenden Informationen angezeigt:
+ Unter **Source (Quelle)** wird die Quelle des jeweiligen Protokolleintrags angezeigt. Mögliche Werte sind:
+ **Harness** steht für einen Protokolleintrag, den Device Farm erstellt hat. Diese Protokolleinträge werden in der Regel während der Start- und Stopp-Ereignisse erstellt.
+ **Device** steht für einen Protokolleintrag, den das Gerät erstellt hat. Diese Protokolleinträge sind für Android mit logcat kompatibel. Für iOS sind diese Protokolleinträge mit syslog kompatibel.
+ **Test** stellt einen Protokolleintrag dar, der entweder von einem Test oder einem Test-Framework erstellt wurde.
+ **Time (Zeit)** stellt die Zeit dar, die zwischen dem ersten Protokolleintrag und dem vorliegenden Protokolleintrag verstrichen ist. Die Zeit wird im *MM:SS.SSS* Format ausgedrückt, das *M* für Minuten und Sekunden *S* steht.
+ **PID** stellt die Prozess-ID (PID) dar, mit der der Protokolleintrag erstellt wurde. Alle Protokolleinträge, die von einer bestimmten Anwendung und auf einem bestimmten Gerät erstellt wurden, weisen jeweils dieselbe PID auf.
+ **Level (Stufe)** stellt die Protokollierungsstufe für den Protokolleintrag dar. `Logger.debug("This is a message!")` würde z. B. Einträge auf **Level (Stufe)** `Debug` erstellen. Mögliche Werte sind:
+ **Warnung**
+ **Critical**
+ **Debuggen**
+ **Emergency (Notfall)**
+ **Fehler**
+ **Errored (Mit Fehlern)**
+ **Fehlgeschlagen**
+ **Info**
+ **Internal (Intern)**
+ **Notice (Hinweis)**
+ **Passed**
+ **Skipped**
+ **Angehalten**
+ **Verbose**
+ **Warned (Mit Warnungen)**
+ **Warnung**
+ **Tag** steht für beliebige Metadaten für den Protokolleintrag. Der Android-Systemlog (logcat) kann damit z. B. beschreiben, welcher Teil des Systems den Protokolleintrag erstellt hat (z. B. `ActivityManager`).
+ **Message (Meldung)** stellt eine Meldung oder andere Information für den Protokolleintrag dar. `Logger.debug("Hello, World!")` würde z. B. Einträge mit einer **Message (Meldung)** von `"Hello, World!"` erstellen.
So zeigen Sie nur einen Teil der Informationen an:
+ Um alle Protokolleinträge anzuzeigen, die einem Wert für eine bestimmte Spalte entsprechen, geben Sie den Wert in die Suchleiste ein. Um beispielsweise alle Protokolleinträge mit einem **Quellwert** von anzuzeigen`Harness`, geben Sie **Harness** in die Suchleiste ein.
+ Sie können alle Zeichen in Feld einer Spaltenüberschrift entfernen, indem Sie im jeweiligen Feld auf das **X** klicken. Das Entfernen aller Zeichen aus einem Spaltenüberschriftenfeld entspricht der Eingabe **\$1** in dieses Spaltenüberschriftenfeld.
Um alle Protokollinformationen für das Gerät herunterzuladen, einschließlich aller von Ihnen ausgeführten Suiten und Tests, wählen Sie **Protokolle herunterladen**.
# Status der Device Farm Farm-Testergebnisse
In der Device Farm Farm-Konsole werden Symbole angezeigt, mit denen Sie den Status Ihres abgeschlossenen Testlaufs schnell beurteilen können. Weitere Informationen zu Tests in Device Farm finden Sie unter[Berichte in AWS Device FarmBerichte](reports.md).
**Topics**
+ [Status eines einzelnen Tests](#how-to-use-reports-displaying-results-individual)
+ [Status für mehrere Tests](#how-to-use-reports-displaying-results-summary)
## Status eines einzelnen Tests
Bei Berichten, die einen einzelnen Test beschreiben, zeigt Device Farm ein Symbol an, das den Status des Testergebnisses darstellt:
| Description | Symbol |
| --- | --- |
| Der Test war erfolgreich. | ![\[The test succeeded.\]](http://docs.aws.amazon.com/de_de/devicefarm/latest/developerguide/images/df-run-success.png) |
| Der Test ist fehlgeschlagen. | ![\[The test failed.\]](http://docs.aws.amazon.com/de_de/devicefarm/latest/developerguide/images/df-run-failure.png) |
| Device Farm hat den Test übersprungen. | ![\[The test was skipped.\]](http://docs.aws.amazon.com/de_de/devicefarm/latest/developerguide/images/df-run-skipped.png) |
| Der Test wurde beendet. | ![\[The test was stopped.\]](http://docs.aws.amazon.com/de_de/devicefarm/latest/developerguide/images/df-run-stopped.png) |
| Device Farm hat eine Warnung zurückgegeben. | ![\[Device Farm returned a warning.\]](http://docs.aws.amazon.com/de_de/devicefarm/latest/developerguide/images/df-run-warning.png) |
| Device Farm hat einen Fehler zurückgegeben. | ![\[Device Farm returned an error.\]](http://docs.aws.amazon.com/de_de/devicefarm/latest/developerguide/images/df-run-error.png) |
## Status für mehrere Tests
Wenn Sie einen abgeschlossenen Lauf wählen, zeigt Device Farm ein Übersichtsdiagramm an, das den Prozentsatz der Tests in verschiedenen Status zeigt.
![\[Device Farm test results summary graph.\]](http://docs.aws.amazon.com/de_de/devicefarm/latest/developerguide/images/df-summary-results-graph.png)
Dieses Diagramm mit den Ergebnissen eines Testlaufs zeigt beispielsweise, dass der Testlauf 4 gestoppte Tests, 1 fehlgeschlagener Test und 10 erfolgreiche Tests umfasste.
Diagramme sind immer farblich gekennzeichnet und beschriftet.
# Artefakte in Device Farm herunterladen
Device Farm sammelt Artefakte wie Berichte, Protokolldateien und Bilder für jeden Test in der Ausführung.
Sie können die während des Testlaufs erstellten Artefakte herunterladen:
**Dateien**
Während des Testlaufs generierte Dateien, einschließlich Device Farm Farm-Berichten. Weitere Informationen finden Sie unter [Testberichte in Device Farm anzeigen](how-to-use-reports.md).
**Protokolle**
Ausgabe aus jedem Test im Testlauf.
**Screenshots**
Bildschirmbilder, die für jeden Test im Testlauf aufgezeichnet wurden.
![\[Workflow diagram showing Project, Run, Job (device), Test suite, and Test stages in AWS Cloud.\]](http://docs.aws.amazon.com/de_de/devicefarm/latest/developerguide/images/hierarchy.png)
## Artefakte herunterladen (Konsole)
1. Wählen Sie auf der Seite des Testlaufberichts unter **Devices (Geräte)** ein mobiles Gerät aus.
1. Um eine Datei herunterzuladen, wählen Sie sie unter **Files (Dateien)** aus.
1. Um die Protokolle aus dem Testlauf herunterzuladen, wählen Sie unter **Logs (Protokolle)** die Option **Download logs (Protokolle herunterladen)**.
1. Um einen Screenshot herunterzuladen, wählen Sie unter **Screenshots** einen Screenshot aus.
Weitere Informationen zum Herunterladen von Artefakten in einer benutzerdefinierten Testumgebung finden Sie unter [Artefakte werden in einer benutzerdefinierten Testumgebung heruntergeladen](using-artifacts-custom.md).
## Artefakte herunterladen (AWS CLI)
Sie können das verwenden AWS CLI , um Ihre Testlauf-Artefakte aufzulisten.
**Topics**
+ [Schritt 1: Holen Sie sich Ihre Amazon Resource Names (ARN)](#artifacts-cli-step1)
+ [Schritt 2: Listet eure Artefakte auf](#artifacts-cli-step2)
+ [Schritt 3: Laden Sie Ihre Artefakte herunter](#artifacts-cli-step3)
### Schritt 1: Holen Sie sich Ihre Amazon Resource Names (ARN)
Sie können Ihre Artefakte nach Testlauf, Auftrag, Testreihe oder Test auflisten. Sie benötigen den zugehörigen ARN. Diese Tabelle zeigt den Eingabe-ARN für jeden der AWS CLI Listenbefehle:
| AWS CLI Befehl auflisten | Erforderlicher ARN |
| --- | --- |
| list-projects | Dieser Befehl gibt alle Projekte zurück und erfordert keinen ARN. |
| list-runs | project |
| list-jobs | run |
| list-suites | job |
| list-tests | suite |
Wenn Sie z. B. einen Test-ARN suchen, führen Sie **list-tests** unter Verwendung des Testreihen-ARN als Eingabeparameter aus.
Beispiel:
```
aws devicefarm list-tests –-arn arn:MyTestSuiteARN
```
Die Antwort enthält den Test-ARN eines jeden Tests in der Testreihe.
```
{
"tests": [
{
"status": "COMPLETED",
"name": "Tests.FixturesTest.testExample",
"created": 1537563725.116,
"deviceMinutes": {
"unmetered": 0.0,
"total": 1.89,
"metered": 1.89
},
"result": "PASSED",
"message": "testExample passed",
"arn": "arn:aws:devicefarm:us-west-2:123456789101:test:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE",
"counters": {
"skipped": 0,
"warned": 0,
"failed": 0,
"stopped": 0,
"passed": 1,
"errored": 0,
"total": 1
}
}
]
}
```
### Schritt 2: Listet eure Artefakte auf
Der Befehl AWS CLI [list-artifacts](https://docs.aws.amazon.com/cli/latest/reference/devicefarm/list-artifacts.html) gibt eine Liste von Artefakten wie Dateien, Screenshots und Logs zurück. Jedes Artefakt verfügt über eine URL, sodass Sie die Datei herunterladen können.
+ Rufen Sie **list-artifacts** auf und geben Sie dabei eine Ausführung, einen Auftrag, eine Testreihe oder einen Test-ARN an. Geben Sie eine Art von FILE (Datei), LOG (Protokoll) oder SCREENSHOT an.
Dieses Beispiel gibt eine Download-URL für jedes Artefakt zurück, das für einen bestimmten Test verfügbar ist:
```
aws devicefarm list-artifacts --arn arn:MyTestARN --type "FILE"
```
Die Antwort enthält eine Download-URL für jedes Artefakt.
```
{
"artifacts": [
{
"url": "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL",
"extension": "txt",
"type": "APPIUM_JAVA_OUTPUT",
"name": "Appium Java Output",
"arn": "arn:aws:devicefarm:us-west-2:123456789101:artifact:5e01a8c7-c861-4c0a-b1d5-12345EXAMPLE",
}
]
}
```
### Schritt 3: Laden Sie Ihre Artefakte herunter
+ Laden Sie Ihr Artefakt mithilfe der URL aus dem vorherigen Schritt herunter. Dieses Beispiel verwendet **curl** zum Herunterladen einer Android Appium Java-Ausgabedatei:
```
curl "https://prod-us-west-2-uploads.s3-us-west-2.amazonaws.com/ExampleURL" > MyArtifactName.txt
```
## Laden Sie Artefakte herunter (API)
Die Device Farm [ListArtifacts](https://docs.aws.amazon.com/devicefarm/latest/APIReference/API_ListArtifacts.html)API-Methode gibt eine Liste von Artefakten wie Dateien, Screenshots und Protokollen zurück. Jedes Artefakt verfügt über eine URL, sodass Sie die Datei herunterladen können.
# Artefakte werden in einer benutzerdefinierten Testumgebung heruntergeladen
In einer benutzerdefinierten Testumgebung sammelt Device Farm Artefakte wie benutzerdefinierte Berichte, Protokolldateien und Bilder. Diese Artefakte sind für jedes Gerät im Testlauf verfügbar.
Sie können diese während des Testlaufs erstellten Artefakte herunterladen:
**Ausgabe der Testspezifikation**
Die Ausgabe von der Ausführung der Befehle in der YAML-Datei der Testspezifikation.
**Kundenartefakte**
Eine ZIP-Datei enthält die Artefakte des Testlaufs. Sie wird im Abschnitt **artifacts: (Artefakte:)** der YAML-Datei Ihrer Testspezifikation konfiguriert.
**Shell-Skript der Test-Spezifikation**
Eine intermediäre Shell-Skriptdatei, die aus der YAML-Datei erstellt wurde. Da die Shell-Skriptdatei im Testlauf verwendet wurde, kann sie für das Debugging der YAML-Datei genutzt werden.
**Test-Spezifikationsdatei**
Die im Testlauf verwendete YAML-Datei.
Weitere Informationen finden Sie unter [Artefakte in Device Farm herunterladen](artifacts.md).
![\[Device Farm-Hierarchie von Operationen in einer benutzerdefinierten Testumgebung\]](http://docs.aws.amazon.com/de_de/devicefarm/latest/developerguide/images/hierarchy.png)