XCTest ausführen

In diesem Leitfaden wird beschrieben, wie Sie einen XCTest für Tests in Firebase Test Lab vorbereiten.

Schritt 1: Speicherort für abgeleitete Daten Ihres Projekts konfigurieren

Xcode speichert kompilierte iOS-Artefakte, einschließlich aller von Ihnen erstellten Tests, in einem Verzeichnis für abgeleitete Daten. Sie können den Standardspeicherort für dieses Verzeichnis beibehalten, wenn Sie möchten. Es ist jedoch oft hilfreich, einen leichter zugänglichen Ort für die Dateien auszuwählen, insbesondere wenn Sie häufig Tests mit Test Lab ausführen:

  1. Öffnen Sie Ihr Projekt in Xcode.
  2. Wählen Sie in der macOS-Menüleiste Datei > Projekteinstellungen… aus.
  3. Ändern Sie im Drop-down-Menü Abgeleitete Daten die Option Standardspeicherort in Benutzerdefinierter Speicherort.
  4. Wählen Sie im Feld unter dem Drop-down-Menü einen Speicherort für die Ausgabe Ihrer Tests durch Xcode aus. (Dies ist Ihre FOLDER_WITH_TEST_OUTPUT)

Schritt 2: Allgemeine Testdatei erstellen

Test Lab führt Unit-Tests und UI-Tests mit dem XCTest-Framework aus. Wenn Sie die XCTests Ihrer App auf Test Lab-Geräten ausführen möchten, erstellen Sie sie für Tests auf einem generischen iOS-Gerät:

  1. Wählen Sie im Drop-down-Menü für Geräte oben im Xcode-Arbeitsbereichsfenster die Option Generic iOS Device aus.
  2. Wählen Sie in der macOS-Menüleiste Product > Build For > Testing aus.

Alternativ können Sie den XCTest über die Befehlszeile erstellen. Verwenden Sie den folgenden Befehl in einem Terminal:

Projekt

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

Arbeitsbereich

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

Schritt 3: Test signieren und bestätigen

  1. Achten Sie darauf, dass alle Artefakte in der App und im Test signiert sind. Sie können dies beispielsweise über Xcode tun, indem Sie Signierungseinstellungen wie das Bereitstellungsprofil und die Identität angeben. Weitere Informationen finden Sie unter Apple Code Signing.

  2. Prüfen Sie die App-Signatur, indem Sie codesign --verify --deep --verbose /path/to/MyApp.app ausführen, wobei „MyApp“ der Name der App im entpackten Ordner ist. Das ist von Projekt zu Projekt unterschiedlich. Die erwartete Ausgabe ist MyApp.app: valid on disk.

  3. Wenn Sie einen XCUITest ausführen, müssen Sie den Test und den Runner mit codesign --verify --deep --verbose /path/to/MyTest-Runner.app verifizieren, wobei „MyTest“ der Name des Runners im entpackten Ordner ist. Dies ist von Projekt zu Projekt unterschiedlich. Die erwartete Ausgabe ist MyTest-Runner.app: valid on disk.

Schritt 4: App verpacken und Upload testen

  1. Nachdem der Test erfolgreich erstellt wurde, komprimieren Sie ihn für den Upload 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 den Test auch manuell komprimieren:

  1. Öffnen Sie den Finder und rufen Sie FOLDER_WITH_TEST_OUTPUT auf.

  2. Öffnen Sie den Ordner, der den Namen Ihres Projekts als Präfix hat, und rufen Sie dann den Ordner Build/Products darin auf.

  3. Wählen Sie die Ordner Debug-iphoneos und YOUR_SCHEME_iphoneosDEPLOYMENT_TARGET-arm64.xctestrun aus und komprimieren Sie sie.

Schritt 5: (Optional) Test lokal ausführen

Bevor Sie den Test mit Test Lab ausführen, können Sie ihn lokal mit einem über USB verbundenen Gerät ausführen, um das Verhalten zu prüfen:

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

Nächste Schritte

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