Ejecuta una XCTest

En esta guía, se describe cómo preparar una XCTest para realizar pruebas en Firebase Test Lab.

Paso 1: Configura la ubicación de los datos derivados de tu proyecto

Xcode ubica los artefactos compilados de iOS, incluidas las pruebas que crees, en un directorio de datos derivados. Es posible conservar la ubicación predeterminada de ese directorio, pero resulta útil seleccionar una ubicación que tenga un acceso más sencillo para los archivos, en especial si vas a ejecutar frecuentemente pruebas con Test Lab:

1. Abre tu proyecto en Xcode.
2. En la barra de menú macOS, selecciona Archivo > Configuración del proyecto…
3. Cambia el menú desplegable de los Datos derivados de una Ubicación predeterminada a una Ubicación personalizada.
4. En el campo que se encuentra bajo el menú desplegable, selecciona una ubicación donde Xcode pueda guardar los resultados de las pruebas.

Paso 2: Compila un archivo de prueba genérico

Test Lab ejecuta pruebas de unidades y de IU con el framework XCTest. Para ejecutar las XCTests de tus apps en dispositivos de Test Lab, créalas para pruebas en un dispositivo iOS genérico:

1. En el menú desplegable del dispositivo que aparece en la ventana superior del espacio de trabajo de Xcode, selecciona Dispositivo iOS genérico.
2. En la barra de menú de macOS, selecciona Producto > Creado para > Pruebas.

Paso 3: Empaqueta tu app para subirla

Finalmente, compila y empaqueta la prueba a fin de subirla a Test Lab. Para ello, comprime los archivos de prueba que creaste en un archivo .zip:

1. Para compilar tu XCTest, usa el siguiente comando en una terminal:

   proyecto

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

   lugar de trabajo

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

2. Después de crear la prueba con éxito, puedes comprimirla y subirla a Test Lab:

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

También puedes empaquetar tu prueba comprimiendo los archivos de prueba de forma manual como se indica a continuación:

1. Abre Finder y navega hasta el directorio designado para la salida de datos derivados.

2. Abre la carpeta que seleccionaste para tu proyecto y abre la carpeta Build/Products que está en su interior.

3. Selecciona las carpetas Debug-iphoneos y PROJECT_NAME_iphoneosDEVELOPMENT_TARGET-arm64.xctestrun y, luego, comprímelas.

Paso 4: Ejecuta la prueba de forma local (opcional)

Antes de ejecutar tu prueba con Test Lab, puedes ejecutarla de manera local con un dispositivo conectado por USB para verificar su comportamiento:

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

Próximos pasos

Sube tu prueba y ejecútala en Firebase console o en la CLI de gcloud.