Distribuye tus compilaciones de iOS previas al lanzamiento más rápido con App Distribution y fastlane

1. Antes de comenzar

4cddd34bd261cea0.png

En este codelab, aprenderás a usar Firebase App Distribution y su complemento fastlane para distribuir una app para iOS a los verificadores, recopilar UDID de dispositivos de prueba y registrarlos en el perfil de aprovisionamiento de tu app a fin de entregar compilaciones ad hoc a los verificadores con mayor rapidez.

Qué aprenderás

  • Cómo subir y distribuir una app para iOS previa al lanzamiento (ad hoc) a los verificadores con Firebase App Distribution y fastlane
  • Cómo registrarte como verificador y descargar la app distribuida en un dispositivo de prueba
  • Cómo registrar rápidamente dispositivos de prueba mediante la exportación de UDID de dispositivos de prueba con el complemento fastlane de App Distribution
  • Cómo actualizar el perfil de aprovisionamiento de tu app y volver a subirlo para su distribución

Requisitos

  • Una Cuenta de Google
  • Una máquina de Apple con XCode 11.7 o una versión posterior instalado
  • Una app para iOS ad hoc antes del lanzamiento compilada en Xcode
  • Una cuenta de desarrollador de Apple pagada
  • Un dispositivo iOS físico para realizar pruebas

La app del simulador de iOS funcionará para la mayor parte del codelab, pero los simuladores no pueden descargar versiones.

Para verificar que la configuración funcionó, verifica que el botón "Descargar" aparece en la app web del verificador de App Distribution.

2. Comenzar

Configura fastlane

App Distribution se integra en fastlane para permitirte automatizar la distribución de compilaciones previas al lanzamiento de tu app. App Distribution se integra en tu configuración de fastlane.

  1. Instala y configura fastlane.
  2. Ejecuta fastlane init en el directorio raíz de tu proyecto durante la configuración y elige "Configuración manual". Verás un subdirectorio llamado fastlane que contiene Fastfile, Appfile y Pluginfile, que usarás para configurar fastlane.

Instala Firebase CLI

También deberás instalar Firebase CLI. Si usas macOS o Linux, puedes ejecutar el siguiente comando cURL:

curl -sL https://firebase.tools | bash

Si usas Windows, lee las instrucciones de instalación para obtener un objeto binario independiente o para instalarlo a través de npm.

Una vez que hayas instalado la CLI, ejecutar firebase --version debería informar una versión de 12.0.0 o posterior:

$ firebase --version
12.0.0

3. Compila tu app con fastlane

Crea tu app

  1. Establece algunas variables globales para fastlane en tu ./fastlane/Appfile.. Incluye el ID de tu app y tu Apple ID:
app_identifier("<your app's bundle identifier>")
apple_id("<your Apple id>")
  1. Crea tu primer carril y usa la acción build_app de fastlane (también conocida como gym) para compilar tu app. Para ello, agrega lo siguiente a tu ./fastlane/Fastfile:
default_platform(:ios)

lane :build do
    build_app(export_method: "ad-hoc")
end
  1. Firma la app para su distribución.

En este codelab, administrarás tu propia certificación y perfil con get_certificates (también conocido como cert), que genera certificados de firma de forma local y almacena todo en el llavero de macOS. Sin embargo, por lo general, se recomienda usar fastlane sync_code_signing action (también conocido como match) para administrar de forma segura los perfiles y certificados de firma de código de tu equipo.

lane :build do
    get_certificates()
    build_app(export_method: "ad-hoc")
end
  1. Configura un perfil de aprovisionamiento para tu app con la acción get_provisioning_profile (también conocida como sigh). Esto te permite compartir tu app con verificadores.
lane :build do
    get_certificates()
    get_provisioning_profile(adhoc: true)
    build_app(export_method: "ad-hoc")
end
  1. [Opcional] Si nunca antes ejecutaste tu app, ejecuta el siguiente comando para crearla en la Consola para desarrolladores de Apple:

$ fastlane produce --skip_itc

  1. Por último, ejecuta el carril para compilar tu app.

Se te solicitará tu ID de Apple, la contraseña (que está almacenada en el llavero) y el ID del paquete de la app.

$ fastlane build

Si tienes algún problema, consulta la guía de solución de problemas de fastlane.

4. Sube tu app a Firebase

Ahora que compilaste tu app, puedes subirla a App Distribution.

Crea y configura un proyecto de Firebase

  1. Accede a Firebase.
  2. En Firebase console, crea o agrega un proyecto nuevo y, luego, asígnale el nombre "Codelab de exportación de UDID".

No es necesario que habilites Google Analytics en este proyecto.

  1. Haz clic en Crear proyecto.

Agrega tu app para iOS al proyecto

  1. Haz clic en el ícono de iOS para crear una nueva app para iOS de Firebase y, luego, ingresa el ID del paquete de tu app.

9c26c130a6c42212.png

  1. Omite los siguientes pasos y, luego, haz clic en Ir a la consola. Agregarás SDKs a tu app más adelante.

El proyecto y la app ahora están disponibles en la página Descripción general del proyecto.

66f79cc8a97fa8e9.png

Habilitar App Distribution

  1. En la sección Publicar y supervisar, haz clic en Distribución de apps.
  2. Después de aceptar las condiciones, haz clic en "Comenzar". para habilitar App Distribution en tu app.

460213326c2784ae.png

Configura una distribución en fastlane

  1. Ejecuta el siguiente comando desde la raíz de tu proyecto de iOS para agregar App Distribution a la configuración de fastlane.

Si el comando te muestra una opción, selecciona Option 3: RubyGems.org:

$ fastlane add_plugin firebase_app_distribution

  1. Confirma que el complemento esté instalado:

$ fastlane

El resultado debería mostrar fastlane-plugin-firebase_app_distribution en la lista de complementos instalados.

  1. Después de confirmar que el complemento esté instalado, elige la opción 0 para cancelar.

Autentica tu proyecto de Firebase

Para usar el complemento fastlane, primero debes autenticar tu proyecto de Firebase.

  1. Ejecuta el siguiente comando para conectar la CLI a tu Cuenta de Google:

$ firebase login

  1. Cuando el comando imprima un vínculo de autenticación, ábrelo en un navegador.
  2. Cuando se te solicite, accede a tu Cuenta de Google y otorga permiso para acceder a tu proyecto de Firebase.

Cómo distribuir tu app

Ya está todo listo para que distribuyas tu app.

  1. En la parte superior de tu ./fastlane/Fastfile, define una variable llamada firebase_app_id. Reemplaza <your_app_id> por el ID de app de Firebase de la app que creaste (lo puedes encontrar en la página Configuración del proyecto).

Fastfile está escrito en Ruby, por lo que debes usar la sintaxis de Ruby para definir las variables.

firebase_app_id = "<your_app_id>"
  1. Agrega un carril nuevo llamado distribute que llame al carril de compilación y, luego, distribuya tu app con la acción firebase_app_distribution.
lane :distribute do
    build
    firebase_app_distribution(
        app: firebase_app_id,
        release_notes: "Try out this app!",
    )
end
  1. Ejecuta el carril nuevo para compilar tu app y crear una distribución.

$ fastlane distribute

En este punto, el Fastfile debería verse de la siguiente manera:

firebase_app_id = "<your Firebase app ID>"

default_platform(:ios)

lane :build do
    get_certificates()
    get_provisioning_profile(adhoc: true)
    build_app(export_method: "ad-hoc")
end

lane :distribute do
    build
    firebase_app_distribution(
        app: firebase_app_id,
        release_notes: "Try out this app!",
    )
end

Después de actualizar Firebase console, verás la nueva versión de tu app.

c59dc1a94de3bf3c.png

5. Invita a verificadores a descargar tu app

Cuando un verificador acepta una invitación para probar una compilación ad hoc, se le solicita permiso para compartir su UDID. Si acepta, App Distribution recopila la información de su dispositivo y te notifica por correo electrónico. En esta sección, te agregarás como verificador para descargar y probar la app que distribuiste.

Agregarte como verificador de la versión

  1. En firebase_app_id, en la parte superior de tu Fastfile, crea una variable para contener a los verificadores y, luego, incluye tu propia dirección de correo electrónico, así como otras direcciones de correo electrónico opcionales que quieras probar.
firebase_app_id = "<your Firebase app ID>"
app_testers = [
  "your@email.com",
  "another@email.com",
]
  1. Aplica el método Array#join de Ruby para convertir el array app_testers en una cadena separada por comas, que espera el parámetro testers. Luego, pasa el resultado al parámetro testers de firebase_app_distribution.
lane :distribute do
    build
    firebase_app_distribution(
        app: firebase_app_id,
        release_notes: "Try out this app!"
        testers: app_testers.join(","),
    )
end

En este punto, tu archivo Fastfile debería verse así:

firebase_app_id = "<your Firebase app ID>"
app_testers = [
  "your@email.com",
  "another@email.com",
]

default_platform(:ios)

lane :build do
    get_certificates()
    get_provisioning_profile(adhoc: true)
    build_app(export_method: "ad-hoc")
end

lane :distribute do
    build
    firebase_app_distribution(
        app: firebase_app_id,
        release_notes: "Try out this app!",
        testers: app_testers.join(","),
    )
end
  1. Vuelve a correr por el carril.

$ fastlane distribute

Cuando ejecutes el carril, los verificadores que agregaste recibirán un correo electrónico de invitación de App Distribution en el que se les notificará la nueva versión disponible. En Firebase console, ahora puedes ver los verificadores que agregaste en la versión de tu app.

2e0fc9603b868af8.png

Como incluiste tu dirección de correo electrónico, recibirás un correo electrónico de Firebase App Distribution en el que se te invitará a probar la app. Ahora eres el primer verificador. Continúa con la siguiente sección para prepararte como verificador en tu dispositivo de prueba.

Registra tu dispositivo de prueba

Como verificador, deberás acceder a Google en tu dispositivo de prueba para acceder a las versiones de la app que recibiste una invitación para probar. Como tu compilación de prueba es una versión ad hoc, también deberás instalar el perfil de Firebase para registrar tu dispositivo de prueba. Luego, podrás acceder a las versiones que estén disponibles para ti desde la app web de verificadores de App Distribution mediante el clip web que se agregó a la pantalla principal de tu dispositivo.

  1. En tu dispositivo de prueba para iOS, abre el correo electrónico que se envió desde Firebase App Distribution y presiona el vínculo Get Started. Asegúrate de abrir el vínculo en Safari.
  2. Ahora estás en la app web para verificadores de App Distribution. En la página que aparece, accede con tu Cuenta de Google y presiona Aceptar invitación.

d833407de251b89f.png

  1. Ahora puedes ver las versiones a las que te invitaron. Presiona Registrar dispositivo en una de las versiones.

fd141215e54a938d.png

  1. Cuando se te solicite, descarga el perfil de Firebase y, luego, instálalo en la app de Configuración.

Cuando se instala el perfil, se otorgan a Firebase los siguientes permisos:

  • Registrar el dispositivo de prueba mediante la recopilación del ID de dispositivo único (UDID).

Firebase envía un correo electrónico a todos los propietarios y editores del proyecto de Firebase que incluye el UDID del dispositivo de prueba.

  • Instala un clip web en la pantalla principal del dispositivo de prueba. El clip web abre la app web de verificador de App Distribution, que te permite instalar y acceder a todas tus apps de prueba.

En la app web para verificadores de App Distribution, tu dispositivo de prueba ahora está registrado para la versión de tu app.

fe93d649dfa25877.png

Ahora que compartiste el UDID de tu dispositivo de prueba en Firebase, puedes reanudar como desarrollador. En la pestaña Verificadores del panel de App Distribution, la información del verificador ahora aparece en la versión de tu app con el estado "Aceptado":

7b9f665a63a384cf.png

En la siguiente sección, agregarás el UDID del dispositivo al perfil de aprovisionamiento de tu app y, luego, compilarás una versión de tu app que funcione con tu dispositivo de prueba.

Cómo exportar los UDID de tus dispositivos de prueba

Como desarrollador, recibirás un correo electrónico de Firebase que contiene el UDID del dispositivo de prueba. Como opción, App Distribution facilita la recopilación de varios UDID de dispositivos nuevos a la vez, ya que te permite exportarlos directamente desde Firebase console como un archivo de texto sin procesar.

  1. Para exportar todos los UDID, abre la pestaña Verificadores y grupos.

241a9936898a2fc0.png

  1. Haz clic en Exportar UDIDs de Apple.

bcf0c26c522d9b4e.png

El archivo debe contener el UDID de tu dispositivo de prueba.

Device ID            Device Name                            Device Platform
1234567890     udid.codelab.tester@gmail.com - iPhone SE 2nd Gen        ios

Los UDID también se pueden exportar desde la línea de comandos con fastlane, lo que harás en la siguiente sección.

6. Actualiza el perfil de aprovisionamiento de tu app y vuelve a compilarlo

Ahora, agregarás el UDID de tu dispositivo de prueba al perfil de aprovisionamiento de tu app, volverás a compilar una versión de la app que funcione para tu dispositivo y distribuirás la versión nueva.

Agrega un carril de exportación de UDID

  1. Agrega otra variable en la parte superior de tu Fastfile y establécela en una ruta de acceso al archivo en la que los verificadores Se descargarán los UDID del dispositivo.
firebase_app_id = "<your Firebase app ID>"
app_testers = [
  "your@email.com",
  "another@email.com",
]
tester_udids_file = "tester_udids.txt"
  1. Configura un carril nuevo que use la acción de exportación de UDID del complemento de App Distribution para descargar los UDID del verificador, como lo hiciste desde la consola.
lane :download_udids do
    firebase_app_distribution_get_udids(
        app: firebase_app_id,
        output_file: tester_udids_file,
    )
end
  1. Ejecuta el siguiente carril para descargar los UDID.

$ fastlane download_udids

  1. Imprime el archivo descargado, que debe contener los UDID del dispositivo de prueba.

$ cat tester_udids.txt

Agrega dispositivos a la Consola para desarrolladores de Apple

  1. Crea el siguiente carril para agregar los UDID a tu lista de dispositivos en Play Console de Apple, de modo que puedas agregarlos a tu perfil de aprovisionamiento con la acción register_devices de fastlane :
lane :add_new_devices do
    register_devices(devices_file: tester_udids_file)
end
  1. Luego, ejecuta el carril:

$ fastlane add_new_devices

Luego, deberías ver los dispositivos nuevos en la lista de dispositivos de la consola para desarrolladores.

Cómo agregar dispositivos a tu perfil de aprovisionamiento

  1. Agrega el argumento force al paso de perfil de aprovisionamiento en tu carril build para forzarlo a recoger dispositivos nuevos cada vez que compiles.
lane :build do
    get_certificates()
    get_provisioning_profile(adhoc: true, force: true)
    build_app(export_method: "ad-hoc")
end

Vuelve a ejecutar el carril para compilar y subir contenido

Ahora, actualizarás tu carril distribute con los nuevos carriles para agregar los dispositivos al perfil de aprovisionamiento, volver a compilar la app y, luego, distribuirla.

  1. Llama a los carriles nuevos desde distribute:
lane :distribute do
    download_udids
    add_new_devices
    build
    firebase_app_distribution(
        app: "1:123456789:ios:abcd1234",
        release_notes: "Try out this app!"
        testers: app_testers.join(","),
    )
end
  1. Ejecuta el carril distribute:

$ fastlane distribute

En este punto, tu archivo Fastfile debería verse así:

firebase_app_id = "<your Firebase app ID>"
app_testers = [
  "your@email.com",
  "another@email.com",
]
tester_udids_file = "tester_udids.txt"

default_platform(:ios)

lane :build do
    get_certificates()
    get_provisioning_profile(adhoc: true, force: true)
    build_app(export_method: "ad-hoc")
end

lane :distribute do
    download_udids
    add_new_devices
    build
    firebase_app_distribution(
        app: firebase_app_id,
        release_notes: "Try out this app!",
        testers: app_testers.join(","),
    )
end

lane :download_udids do
    firebase_app_distribution_get_udids(
        app: firebase_app_id,
        output_file: tester_udids_file,
    )
end

lane :add_new_devices do
    register_devices(devices_file: tester_udids_file)
end

Descarga la versión del dispositivo de prueba

Ahora que tu app incluye los UDID del dispositivo de prueba, puedes instalarlos en los dispositivos de prueba.

e275f73d57cc8fb1.png

  1. En tu dispositivo de prueba, regresa a la app web del verificador de App Distribution mediante el vínculo del correo electrónico o el ícono de la pantalla principal del dispositivo.

Cuando navegues a la app del codelab de UDID, verás que la versión está lista para descargarse.

dad6d03b6ad78746.png

  1. Si usas un dispositivo físico, presiona Descargar y, luego, instala y ejecuta la app.

7. Felicitaciones

Ya configuraste App Distribution y fastlane para automatizar el proceso de prueba previo al lanzamiento. Ahora, cuando quieras invitar a verificadores adicionales o agregar sus UDID a tu app, solo deberás ejecutar un comando: fastlane distribute.

Así que ya no es necesario recopilar UDID de los verificadores de forma individual ni tener que ir a la Consola para desarrolladores de Apple para actualizar las listas de dispositivos o aprovisionar perfiles. Ni siquiera es necesario que abras Xcode.

Este flujo de trabajo es fácil de configurar para que se ejecute por hora o a diario en tu entorno de integración continua.

Lecturas adicionales