Realiza pruebas con Google Cloud CLI

En esta guía, se describe cómo ejecutar una XCTest o una prueba de bucle de juego con la CLI de gcloud.

Paso 1: Configura el entorno local del SDK de Google Cloud

1. Descarga el SDK de Google Cloud.

Esto incluye la herramienta de CLI de gcloud.

2. Asegúrate de que la instalación esté actualizada y que incluya el comando gcloud firebase:

         gcloud components update

3. Accede a la CLI de gcloud con tu Cuenta de Google:

         gcloud auth login

4. Configura tu proyecto de Firebase en gcloud. Para ello, usa el siguiente comando y reemplaza PROJECT_ID por el ID del proyecto:

        gcloud config set project PROJECT_ID

Paso 2: Ejecuta la prueba

Ejecuta una XCTest

1. Ejecuta el siguiente comando para subir el archivo ZIP de tu prueba (si aún no empaquetas la app, consulta Empaqueta tu XCTest):

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

2. Selecciona las dimensiones de tu prueba.

   Test Lab te permite ejecutar pruebas en una gran variedad de versiones de iOS, dispositivos, orientaciones de pantalla y opciones de configuración regional. Estas configuraciones se conocen como dimensiones de prueba. Para ver las opciones de cada dimensión (p. ej., las versiones de Xcode compatibles con la versión de iOS del dispositivo), reemplaza models, versions o locales por dimension en el siguiente comando:

   gcloud firebase test ios dimension list

   La orientación de la pantalla es un poco más sencilla, ya que sus únicas opciones son portrait y landscape.

   Revisa la lista de dimensiones de prueba y selecciona algunas combinaciones sobre las que te gustaría ejecutar la prueba. Consulta los planes de precios para ver la cantidad máxima de combinaciones que puedes ejecutar por día.

3. Cuando elijas un conjunto de dimensiones de prueba, puedes hacer que Test Lab ejecute las pruebas con el comando firebase test ios run. Para cada combinación de dimensiones de prueba que quieras probar, incluye una marca --device individual:

   gcloud firebase test ios run --test PATH/TO/MyTests.zip \
    --device model=MODEL_ID_1,version=VERSION_ID_1,locale=LOCALE_1,orientation=ORIENTATION_1 \
    --device model=MODEL_ID_2,version=VERSION_ID_2,locale=LOCALE_2,orientation=ORIENTATION_2 \
    etc...

   Es posible que la prueba falle debido a una incompatibilidad entre la versión de Xcode con la que se compiló la prueba y la versión de Xcode predeterminada que usa Test Lab. Para especificar una versión de Xcode compatible con tu prueba, usa la marca --xcode-version:

   gcloud firebase test ios run --test PATH/TO/MyTests.zip \
    --device model=MODEL_ID_1,version=VERSION_ID_1,locale=LOCALE_1,orientation=ORIENTATION_1 \
    --xcode-version=15

   Para ayudarte a identificar y ubicar las matrices de pruebas en Firebase console, puedes etiquetar la matriz de pruebas de manera opcional con la marca --client-details matrixLabel="<label>" del siguiente ejemplo:

   gcloud beta firebase test ios run --test PATH/TO/MyTests.zip \
     --device model=MODEL_ID_1,version=VERSION_ID_1,locale=LOCALE_1,orientation=ORIENTATION_1 \
     --client-details matrixLabel="my label"

Ejecuta una prueba de bucle de juego

Ejecuta el comando gcloud beta firebase test ios run y usa las siguientes marcas para configurar la ejecución:

Por ejemplo, en el siguiente comando se ejecuta una prueba de bucle de juego que ejecuta los bucles 1, 4, 6, 7 y 8 en un iPhone 8 Plus:

gcloud beta firebase test ios run
 --type game-loop --app path/to/my/App.ipa --scenario-numbers 1,4,6-8
 --device-model=iphone8plus

Para obtener más información sobre la CLI de gcloud, consulta la documentación de referencia.

Paso 3 (opcional): Automatiza las pruebas futuras que compiles

Crea secuencias de comandos de gcloud con Test Lab

Puedes usar secuencias de comandos de shell o archivos de lote para automatizar los comandos de prueba de apps para dispositivos móviles que, de otro modo, tendrías que ejecutar mediante la línea de comandos de gcloud. Este ejemplo de secuencia de comandos de Bash se ejecuta como XCTest con un tiempo de espera máximo de dos minutos y sirve para informar si la ejecución de la prueba se completó correctamente:

if gcloud firebase test ios run --test MyTest.zip --timeout 2m
then
    echo "Test matrix successfully finished"
else
    echo "Test matrix exited abnormally with non-zero exit code: " $?
fi

Códigos de salida de secuencias de comandos

Test Lab ofrece varios códigos de salida que puedes usar para comprender mejor los resultados de las pruebas que ejecutas con secuencias de comandos o archivos por lotes.

Paso 4: Investiga los resultados de las pruebas

Cuando comience la prueba, recibirás un vínculo a la página Resultados de la prueba. Las pruebas pueden tardar varios minutos en ejecutarse según la cantidad de configuraciones diferentes que hayas seleccionado y la duración del tiempo de espera que se haya configurado para tus pruebas. Una vez ejecutadas, podrás revisar los resultados. Consulta Analiza los resultados de Firebase Test Lab para obtener más información sobre cómo interpretar los resultados de las pruebas.

Próximo paso

Consulta la documentación del SDK de Google Cloud para explorar las opciones de prueba que están disponibles de manera general o en versión beta.