Führen Sie einen XCTest durch

In diesem Leitfaden wird beschrieben, wie Sie einen XCTest zum Testen in Firebase Test Lab vorbereiten.

Schritt 1 : Konfigurieren Sie den Speicherort für abgeleitete Daten Ihres Projekts

Xcode platziert kompilierte iOS-Artefakte, einschließlich aller von Ihnen erstellten Tests, in einem Derived Data-Verzeichnis. Es ist möglich, den Standardspeicherort für dieses Verzeichnis beizubehalten, wenn Sie möchten, aber es ist oft hilfreich, einen leichter zugänglichen Ort für die Dateien zu wählen, insbesondere wenn Sie häufig Tests mit Test Lab durchführen:

1. Öffnen Sie Ihr Projekt in Xcode.
2. Wählen Sie in der macOS-Menüleiste Datei > Projekteinstellungen...
3. Ändern Sie das Dropdown-Menü Abgeleitete Daten von Standardspeicherort in Benutzerdefinierter Speicherort .
4. Wählen Sie im Feld unter dem Dropdown-Menü einen Speicherort aus, an dem Xcode Ihre Tests ausgeben soll.

Schritt 2 : Erstellen Sie eine generische Testdatei

Test Lab führt Unit-Tests und UI-Tests mit dem XCTest- Framework aus. Um die XCTests Ihrer App auf Testlaborgeräten auszuführen, erstellen Sie sie zum Testen auf einem generischen iOS-Gerät:

1. Wählen Sie in der Geräte-Dropdown-Liste oben in Ihrem Xcode-Arbeitsbereichsfenster Generisches iOS-Gerät aus.
2. Wählen Sie in der macOS-Menüleiste Produkt > Erstellen für > Testen aus.

Schritt 3 : Verpacken Sie Ihre App zum Hochladen

Erstellen und verpacken Sie schließlich Ihren Test für den Upload in Test Lab, indem Sie die von Ihnen erstellten Testdateien in eine .zip Datei komprimieren.

1. Um Ihren XCTest zu erstellen, verwenden Sie den folgenden Befehl in einem Terminal:

   Projekt

   xcodebuild -project PATH/TO/YOUR_WORKSPACE.xcodeproj \
   -scheme YOUR_SCHEME \
   -derivedDataPath FOLDER_WITH_TEST_OUTPUT \
   -sdk iphoneos build-for-testing

   Arbeitsplatz

   xcodebuild -workspace PATH/TO/YOUR_WORKSPACE.xcworkspace \
   -scheme YOUR_SCHEME \
   -derivedDataPath FOLDER_WITH_TEST_OUTPUT \
   -sdk iphoneos build-for-testing

2. Nachdem Ihr Test erfolgreich erstellt wurde, komprimieren Sie ihn zum Hochladen in Test Lab:

   cd FOLDER_WITH_TEST_OUTPUT/Build/Products : \
   zip -r MyTests.zip Debug-iphoneos   YOUR_SCHEME_iphoneosDEPLOYMENT_TARGET-arm64.xctestrun
   

Sie können Ihren Test auch paketieren, indem Sie die Testdateien manuell komprimieren:

1. Öffnen Sie den Finder und navigieren Sie zu dem Verzeichnis, das Sie für die Ausgabe abgeleiteter Daten angegeben haben.

2. Öffnen Sie den Ordner, den Sie für Ihr Projekt ausgewählt haben, und öffnen Sie dann den Ordner Build/Products darin.

3. Wählen Sie die Ordner Debug-iphoneos und PROJECT_NAME _iphoneos DEVELOPMENT_TARGET -arm64.xctestrun aus und komprimieren Sie diese anschließend.

Schritt 4. (Optional) Führen Sie Ihren Test lokal aus

Bevor Sie Ihren Test mit Test Lab ausführen, können Sie ihn lokal mit einem über USB angeschlossenen Gerät ausführen, um sein Verhalten auf Qualität zu überprüfen:

xcodebuild test-without-building \
    -xctestrun "Derived Data/Build/Products/YourApp.xctestrun" \
    -destination id=your-phone-id

Nächste Schritte

Laden Sie Ihren Test hoch und führen Sie ihn in der Firebase-Konsole oder der gcloud-Befehlszeilenschnittstelle aus.