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. # Integration von XCTest UI für iOS mit Device Farm Device Farm bietet Unterstützung für das XCTest UI-Testframework. Insbesondere unterstützt Device Farm XCTest-UI-Tests, die sowohl in Swift als auch Objective-C in [Swift](https://developer.apple.com/swift/) geschrieben wurden. Das XCTest UI-Framework ermöglicht UI-Tests in der iOS-Entwicklung, die auf XCTest aufbauen. 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 iOS XCTest UI-Tests vor](#test-types-ios-xctest-ui-prepare) + [Option 1: Erstellen eines XCTest-UI-Packages (.ipa)](#how-to-use-create-XCTestUI-ipa-package) + [Option 2: Erstellen eines XCTest UI .zip-Pakets](#how-to-use-create-XCTestUI-zip-package) + [Laden Sie Ihre iOS XCTest UI-Tests hoch](#test-types-ios-xctest-ui-upload) ## Bereiten Sie Ihre iOS XCTest UI-Tests vor 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 (.ipa) *Ihr AppName* UITest-Runner.app Bundle 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 .zip-Pakets 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 Datei *my-project-name UITest-Runner.app **oder** *my-project-name** sowie die Xcode-Quellcodedateien enthält, die für die Ausführung von XCTEST\_UI mit Testplänen erforderlich sind, einschließlich einer UITest.ipa 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 iOS XCTest UI-Tests hoch Verwenden Sie die Device Farm Farm-Konsole, um Ihre Tests hochzuladen. 1. Melden Sie sich bei der Device Farm Farm-Konsole unter an [https://console.aws.amazon.com/devicefarm](https://console.aws.amazon.com/devicefarm). 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 aus**. 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 iOS XCTest 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.