Esegui un XCTest

Questa guida descrive come preparare un XCTest per i test in Firebase Test Lab.

Passaggio 1: configura la posizione dei dati derivati del progetto

Xcode inserisce gli artefatti iOS compilati, inclusi i test che crei, in una directory di dati derivati. Se vuoi, puoi mantenere la posizione predefinita per questa directory, ma spesso è utile scegliere un luogo più facilmente accessibile per i file, soprattutto se eseguirai spesso test con Test Lab:

  1. Apri il progetto in Xcode.
  2. Nella barra dei menu di macOS, seleziona File > Impostazioni progetto…
  3. Cambia il menu a discesa Derived Data (Dati derivati) da Default Location (località predefinita) a Custom Location (Posizione personalizzata).
  4. Nel campo sotto il menu a discesa, seleziona una posizione in cui Xcode deve generare i test. (Questo è il tuo FOLDER_WITH_TEST_OUTPUT)

Passaggio 2: crea un file di test generico

Test Lab esegue test delle unità e test della UI utilizzando il framework XCTest. Per eseguire gli XCTest della tua app su dispositivi Test Lab, crea l'app per i test su un dispositivo iOS generico:

  1. Dal menu a discesa dei dispositivi nella parte superiore della finestra dell'area di lavoro di Xcode, seleziona Dispositivo iOS generico.
  2. Nella barra dei menu di macOS, seleziona Prodotto > Crea per > Test.

In alternativa, puoi creare il tuo XCTest dalla riga di comando. Utilizza il seguente comando in un terminale:

progetto

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

workspace

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

Passaggio 3: firma il test e verifica

  1. Assicurati che tutti gli artefatti nell'app e nel test siano firmati. Ad esempio, puoi farlo tramite Xcode specificando le impostazioni di firma, come il profilo di provisioning e l'identità. Per saperne di più, consulta Firma del codice Apple.

  2. Verifica la firma dell'app eseguendo codesign --verify --deep --verbose /path/to/MyApp.app, dove "MyApp" è il nome dell'app all'interno della cartella decompressa. Questo varia per ogni progetto. L'output previsto è MyApp.app: valid on disk.

  3. Se stai eseguendo un test XCUITest, devi verificare il test e il runner eseguendo codesign --verify --deep --verbose /path/to/MyTest-Runner.app, dove "MyTest" è il nome del runner all'interno della cartella decompressa. Questo valore varia per ogni progetto. L'output previsto è MyTest-Runner.app: valid on disk.

Passaggio 4: pacchettizza l'app e testa il caricamento

  1. Una volta completata la build del test, comprimilo in un file ZIP per caricarlo su Test Lab:

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

Puoi anche pacchettizzare il test comprimendo manualmente i file di test:

  1. Apri il Finder e vai a FOLDER_WITH_TEST_OUTPUT.

  2. Apri la cartella con il nome del progetto come prefisso, quindi vai alla cartella Build/Products all'interno.

  3. Seleziona le cartelle Debug-iphoneos e YOUR_SCHEME_iphoneosDEPLOYMENT_TARGET-arm64.xctestrun e poi comprimile.

Passaggio 5: (facoltativo) esegui il test in locale

Prima di eseguire il test con Test Lab, puoi eseguirlo localmente con un dispositivo connesso tramite USB per controllare la qualità del suo comportamento:

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

Passaggi successivi

Carica ed esegui il test nella consoleFirebase o in gcloud CLI.