

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.

# Integrieren der XCTest Benutzeroberfläche für iOS mit Device Farm
<a name="test-types-ios-xctest-ui"></a>

Device Farm bietet Unterstützung für das XCTest UI-Testframework. [Insbesondere unterstützt Device Farm XCTest UI-Tests, die sowohl in Objective-C als auch in Swift geschrieben wurden.](https://developer.apple.com/swift/) 

 Das XCTest UI-Framework ermöglicht UI-Tests in der iOS-Entwicklung, aufbauend auf XCTest. Weitere Informationen finden Sie unter [User Interface Testing](https://developer.apple.com/library/prerelease/ios/documentation/DeveloperTools/Conceptual/testing_with_xcode/chapters/09-ui_testing.html#//apple_ref/doc/uid/TP40014132-CH13-SW1) in der iOS Developer Library.

Allgemeine Informationen zum Testen in Device Farm finden Sie unter[Test-Frameworks und integrierte Tests in AWS Device Farm](test-types.md).

Verwenden Sie die folgenden Anweisungen, um Device Farm in das XCTest UI-Testframework für iOS zu integrieren.

**Topics**
+ [Bereiten Sie Ihre XCTest iOS-UI-Tests vor](#test-types-ios-xctest-ui-prepare)
+ [Option 1: Erstellen eines XCTest UI-Packages im Format .ipa](#how-to-use-create-XCTestUI-ipa-package)
+ [Option 2: Erstellen eines XCTest UI-Pakets im ZIP-Format](#how-to-use-create-XCTestUI-zip-package)
+ [Laden Sie Ihre XCTest iOS-UI-Tests hoch](#test-types-ios-xctest-ui-upload)

## Bereiten Sie Ihre XCTest iOS-UI-Tests vor
<a name="test-types-ios-xctest-ui-prepare"></a>

Sie können entweder eine `.ipa` Datei oder eine `.zip` Datei für Ihr XCTEST\_UI-Testpaket hochladen.

Eine `.ipa` Datei ist ein Anwendungsarchiv, das die iOS Runner-App im Bundle-Format enthält. *Zusätzliche Dateien können nicht in die `.ipa` Datei aufgenommen werden.*

Wenn Sie eine `.zip` Datei hochladen, kann sie entweder direkt die iOS Runner-App oder eine `.ipa` Datei enthalten. Sie können der `.zip` Datei auch andere Dateien hinzufügen, wenn Sie sie während der Tests verwenden möchten. Sie können beispielsweise Dateien wie `.xcworkspace` oder `.xcodeproj` in eine `.zip` Datei einfügen`.xctestrun`, um XCUI-Testpläne auf der Gerätefarm auszuführen. Detaillierte Anweisungen zur Ausführung von Testplänen finden Sie in der Standardtestspezifikationsdatei für den XCUI-Testtyp. 

## Option 1: Erstellen eines XCTest UI-Packages im Format .ipa
<a name="how-to-use-create-XCTestUI-ipa-package"></a>

Das Bundle *yourAppName*UITest-Runner.app wird von Xcode erstellt, wenn Sie Ihr Projekt zum Testen erstellen. Es ist im Verzeichnis "Products" für das Projekt zu finden.

Um eine IPA-Datei zu erstellen:

1. Erstellen Sie ein Verzeichnis mit dem Namen. {{Payload}}

1. Fügen Sie Ihr App-Verzeichnis dem Payload-Verzeichnis hinzu.

1. Archivieren Sie das Payload-Verzeichnis in einer `.zip` Datei und ändern Sie dann die Dateierweiterung in. `.ipa`

 Die folgende Ordnerstruktur zeigt, wie eine Beispiel-App mit dem Namen als `.ipa` Datei verpackt werden {{my-project-nameUITest-Runner.app}} würde: 

```
.
└── my-project-nameUITest.ipa
    └── Payload (directory)
        └── my-project-nameUITest-Runner.app
```

## Option 2: Erstellen eines XCTest UI-Pakets im ZIP-Format
<a name="how-to-use-create-XCTestUI-zip-package"></a>

Device Farm generiert automatisch eine `.xctestrun` Datei für Sie, mit der Sie Ihre vollständige XCTest UI-Testsuite ausführen können. Wenn Sie Ihre eigene `.xctestrun` Datei auf Device Farm verwenden möchten, können Sie Ihre `.xctestrun` Dateien und das App-Verzeichnis in eine `.zip` Datei komprimieren. Wenn Sie bereits eine `.ipa` Datei für Ihr Testpaket haben, können Sie diese stattdessen hier einfügen{{\*-Runner.app}}.

```
.
└── swift-sample-UI.zip (directory)
   ├── my-project-nameUITest-Runner.app [OR] my-project-nameUITest.ipa
   ├── SampleTestPlan_2.xctestrun
   ├── SampleTestPlan_1.xctestrun
   └── (any other files)
```

 Wenn Sie einen Xcode-Testplan für Ihre XCUI-Tests auf Device Farm ausführen möchten, können Sie eine ZIP-Datei erstellen, die Ihre *my-project-nameUITest-Runner.app **- oder my-project-name** UITest .ipa-Datei* *und die Xcode-Quellcodedateien enthält, die für die Ausführung von XCTEST\_UI mit Testplänen erforderlich sind, einschließlich einer* OR-Datei. `.xcworkspace` `.xcodeproj`

Hier `.xcodeproj` ist ein Beispiel für eine ZIP-Datei, die eine Datei verwendet: 

```
.
└── swift-sample-UI.zip (directory)
   ├── my-project-nameUITest-Runner.app [OR] my-project-nameUITest.ipa
   ├── (any directory)
   └── {{SampleXcodeProject.xcodeproj}}
        ├── Testplan_1.xctestplan
        ├── Testplan_2.xctestplan
        └── (any other source code files created by xcode with .xcodeproj)
```

Hier ist ein Beispiel für eine Zip-Datei, die eine `.xcworkspace` Datei verwendet: 

```
.
└──swift-sample-UI.zip (directory)
   ├── my-project-nameUITest-Runner.app [OR] my-project-nameUITest.ipa
   └── (any directory)
   │   ├── SampleXcodeProject.xcodeproj
   │   ├── Testplan_1.xctestplan
   │   ├── Testplan_2.xctestplan
   |   └── (any other source code files created by xcode with .xcodeproj)
   └── {{SampleWorkspace.xcworkspace}}
       └── contents.xcworkspacedata
```

**Anmerkung**  
Bitte stellen Sie sicher, dass Ihr XCTest UI−.zip-Paket kein Verzeichnis mit dem Namen „Payload“ enthält. 

## Laden Sie Ihre XCTest iOS-UI-Tests hoch
<a name="test-types-ios-xctest-ui-upload"></a>

Verwenden Sie die Device Farm Farm-Konsole, um Ihre Tests hochzuladen.

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 Projektliste das Projekt aus, in das Sie Ihre Tests hochladen möchten.
**Tipp**  
Sie können die Suchleiste verwenden, um die Projektliste nach Namen zu filtern.  
Um ein Projekt zu erstellen, folgen Sie den Anweisungen unter [Ein Projekt in AWS Device Farm erstellen](how-to-create-project.md)

1. Wählen Sie **Lauf erstellen**.

1. Wählen **Sie unter Ausführungseinstellungen** im Abschnitt **Ausführungstyp** die Option **iOS-App** aus.

1. **Wählen Sie unter App auswählen** im Abschnitt **App-Auswahloptionen** die Option **Eigene App hochladen** aus. **Wählen Sie dann unter **App hochladen** die Option Datei auswählen** aus.

1. Navigieren Sie zu der Datei mit Ihrer iOS-Anwendung und wählen Sie diese aus. Es muss sich dabei um eine IPA-Datei handeln.
**Anmerkung**  
Stellen Sie sicher, dass Ihre IPA-Datei für ein iOS-Gerät und nicht für einen Simulator erstellt wurde.

1. Wählen **Sie unter Test konfigurieren** im Abschnitt **Testframework auswählen** die Option **XCTest UI** aus. **Wählen Sie dann unter **App hochladen** die Option Datei auswählen** aus.

1. Suchen Sie die IPA- oder ZIP-Datei, die Ihren XCTest iOS-UI-Test-Runner enthält, und wählen Sie sie aus. 

1. Schließen Sie die verbleibenden Schritte bei der Erstellung des Laufs ab. Sie wählen die Geräte aus, auf denen Sie testen möchten, und geben optional eine zusätzliche Konfiguration an.

1. Wählen Sie **Create Run aus**. Device Farm führt Ihren Test aus und zeigt die Ergebnisse in der Konsole an.