Catch up on everything announced at Firebase Summit, and learn how Firebase can help you accelerate app development and run your app with confidence. Learn More

Comience a probar con sistemas de integración continua (CI)

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.

Puede usar Firebase Test Lab al desarrollar su aplicación con cualquier sistema de integración continua (CI). Los sistemas de integración continua le permiten compilar y probar automáticamente su aplicación cada vez que verifica las actualizaciones del código fuente de su aplicación.

Uso de Firebase Test Lab con Jenkins CI

Esta sección describe cómo usar Test Lab con Jenkins CI .

Requisitos

Antes de poder usar Firebase Test Lab con Jenkins, debe completar los siguientes pasos:

  1. Configura gcloud. Siga las instrucciones de Uso de Firebase Test Lab desde la línea de comandos de gcloud para crear un proyecto de Firebase y configurar su entorno de SDK de Google Cloud local.

  2. Cree y autorice una cuenta de servicio. Las cuentas de servicio no están sujetas a verificaciones de correo no deseado o avisos de captcha, que de lo contrario podrían bloquear sus compilaciones de CI. Crea una cuenta de servicio con una función de Editor en Google Cloud Console y luego actívala (consulta la documentación de gcloud auth activate-service-account para saber cómo).

  3. Habilite las API requeridas. Después de iniciar sesión con la cuenta de servicio: en la página de la biblioteca de la API de Google Developers Console , habilite la API de Google Cloud Testing y la API de resultados de la herramienta de la nube . Para habilitar estas API, escriba estos nombres de API en el cuadro de búsqueda en la parte superior de la consola y luego haga clic en Habilitar API en la página de descripción general de esa API.

Instalar y configurar Jenkins

Puede instalar y configurar Jenkins CI en Linux o Windows. Ciertos detalles de esta guía son específicos para instalar y ejecutar Jenkins CI en Linux, incluido el uso de barras inclinadas ( / ) en las rutas de los archivos.

Para descargar e instalar Jenkins en una computadora con Linux o Windows, siga las instrucciones en Instalación de Jenkins . Después de instalar Jenkins, siga las instrucciones sobre Iniciar y acceder a Jenkins para completar la configuración y acceder al panel de control de Jenkins.

Configurar ajustes de seguridad globales

Jenkins no tiene la autenticación de usuario ni el control de acceso configurados cuando se instala por primera vez. Antes de usar Jenkins con Firebase Test Lab, configure los ajustes de seguridad global para aplicar el control de acceso y autenticar a los usuarios.

Para configurar los ajustes de seguridad global

  1. Navegue hasta el panel de control de Jenkins en su servidor. Para hacer esto, vaya a http://<nombre del servidor>:8080 , donde <nombre del servidor> es el nombre de la computadora donde instaló Jenkins.
  2. En el tablero de Jenkins, haga clic en Administrar Jenkins y luego haga clic en Configurar seguridad global .
  3. En la página Configurar seguridad global , haga clic en Habilitar seguridad y luego haga clic en Guardar .

Para obtener más información acerca de la configuración de seguridad para Jenkins, consulte Seguridad rápida y sencilla , Configuración de seguridad estándar y Protección de Jenkins .

Crear un proyecto de Jenkins

A continuación, cree un proyecto para ejecutar pruebas de integración continua de su aplicación con Firebase Test Lab.

Para crear un proyecto Jenkins

  1. Navegue hasta el panel de control de Jenkins en su servidor. Para hacer esto, vaya a http://<nombre del servidor>:8080 , donde <nombre del servidor> es el nombre de la computadora donde instaló Jenkins.
  2. En el tablero de Jenkins, haga clic en Nuevo elemento .
  3. Escriba un nombre para su proyecto en el campo Nombre del elemento :
    • Elija Proyecto de estilo libre para crear un proyecto que use una configuración de compilación única.
    • Elija Crear proyecto de configuración múltiple para crear un proyecto que se ejecute en varias configuraciones de compilación diferentes. Si planea compilar su aplicación con una variedad de configuraciones de compilación (múltiples configuraciones regionales, múltiples niveles de API de Android, etc.), entonces un proyecto de configuración múltiple es la mejor opción.
  4. Haga clic en Guardar .

Después de crear su proyecto, su navegador web muestra la página principal de su proyecto.

Agregar control de revisión y pasos de compilación de Gradle

Esta sección describe cómo integrar Jenkins con sistemas de control de revisiones como GitHub y cómo agregar pasos de compilación de Gradle para compilar paquetes APK a partir del código fuente.

Integración con GitHub y otros sistemas de control de revisiones

Si usa GitHub u otro sistema de control de revisiones para administrar el código fuente de su aplicación, puede configurar Jenkins para ejecutar compilaciones automatizadas y ejecutar pruebas cada vez que se registren actualizaciones en su aplicación. También puede configurar Jenkins para ejecutar compilaciones periódicamente.

Para obtener información sobre cómo configurar compilaciones en Jenkins, consulte Configuración de compilaciones automáticas .

Agregar pasos de compilación de Gradle para reconstruir paquetes APK

Si usa un sistema de control de revisiones para administrar el código fuente de su aplicación, debe incluir un paso de compilación de Gradle para crear nuevos archivos binarios de APK cada vez que Jenkins descargue el código fuente de su sistema de control de revisiones.

  1. Agregue un paso de compilación para ejecutar los siguientes comandos en el directorio principal de su aplicación:

    ./gradlew :app:assembleDebug
    ./gradlew :app:assembleDebugAndroidTest
    

  2. Agregue un paso de compilación para usar los paquetes APK creados por Gradle al realizar pruebas con Test Lab. Puede usar esta ruta como <local_server_path> en el ejemplo de script de shell que se proporciona a continuación, donde <AppFolder> es la carpeta del proyecto de Android Studio para su aplicación:

    <AppFolder>/app/build/outputs/apk
    

Agregar pasos de compilación de Test Lab a Jenkins

Ahora está listo para agregar un paso de compilación a Jenkins para ejecutar Test Lab mediante la línea de comandos de gcloud.

Para agregar un paso de compilación de gcloud

  1. En la página principal de su proyecto, haga clic en Configurar .
  2. En la página de configuración del proyecto , desplácese hacia abajo hasta la sección Generar y luego elija Ejecutar shell en el menú Agregar paso de compilación .

  3. En la ventana de comando de shell de ejecución de Jenkins , ingrese lo siguiente, sustituyendo <local_server_path> por la ruta a la aplicación de muestra en el servidor, <app_apk> por el APK de su aplicación y <app_test_apk> por el APK de prueba de su aplicación:

    gcloud firebase test android run --app <local_server_path>/<app_apk>.apk
    --test <local_server_path>/<app_test_apk>.apk
    

Analizar los resultados de las pruebas

Después de que Test Lab complete la prueba de su aplicación, puede revisar los resultados de la prueba en Firebase console o en un depósito de Google Cloud Storage en su proyecto. También puede agregar un comando gsutil al comando de shell que se muestra arriba para copiar los datos de los resultados de la prueba en su computadora local. Para obtener más información, consulte Análisis de los resultados del laboratorio de pruebas de Firebase .

Integración continua con otros sistemas CI

Para aprender a usar Firebase Test Lab con otros sistemas de CI, consulte sus documentos: