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 tuo progetto

Xcode inserisce gli artefatti iOS compilati, inclusi tutti i test che crei, in una directory di dati derivati. È possibile mantenere la posizione predefinita per quella directory, se lo si desidera, ma spesso è utile scegliere una posizione più facilmente accessibile per i file, soprattutto se si eseguiranno spesso test con Test Lab:

  1. Apri il tuo progetto in Xcode.
  2. Nella barra dei menu di macOS, seleziona File > Impostazioni progetto...
  3. Modifica l'elenco a discesa Dati derivati ​​da Posizione predefinita a Posizione personalizzata .
  4. Nel campo sotto l'elenco a discesa, seleziona una posizione in cui Xcode deve inviare i tuoi test. (Questa è la tua FOLDER_WITH_TEST_OUTPUT )

Passaggio 2 : crea un file di test generico

Test Lab esegue unit test e test dell'interfaccia utente utilizzando il framework XCTest . Per eseguire gli XCTest della tua app sui dispositivi del laboratorio di test, creala per il test su un dispositivo iOS generico:

  1. Dal menu a discesa del dispositivo 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. Utilizzare il seguente comando in un terminale:

progetto

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

spazio di lavoro

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 eseguire questa operazione tramite Xcode specificando le impostazioni di firma come il profilo di provisioning e l'identità. Per ulteriori informazioni, 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 XCUITest, devi verificare il test e il corridore eseguendo codesign --verify --deep --verbose /path/to/MyTest-Runner.app dove "MyTest" è il nome del corridore all'interno del cartella decompressa. Questo varia per ogni progetto. L'output previsto è MyTest-Runner.app: valid on disk .

Passaggio 4 : impacchetta la tua app e verifica il caricamento

  1. Dopo che il test è stato compilato correttamente, comprimilo per caricarlo in Test Lab:

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

Puoi anche impacchettare il tuo test comprimendo manualmente i file di test:

  1. Apri Finder e vai a FOLDER_WITH_TEST_OUTPUT .

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

  3. Seleziona le cartelle Debug-iphoneos e YOUR_SCHEME _iphoneos DEPLOYMENT_TARGET -arm64.xctestrun e quindi 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 verificarne il comportamento:

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

Prossimi passi

Carica ed esegui il test nella console Firebase o nell'interfaccia a riga di comando di gcloud .