Distribuye apps para iOS a los verificadores con Firebase CLI

Puedes distribuir compilaciones a verificadores con Firebase CLI. Esta herramienta te permite especificar verificadores y notas de la versión de una compilación, y distribuir la compilación según corresponda.

Antes de comenzar

Si aún no lo has hecho, agrega Firebase a tu proyecto de iOS.

Si no usas ningún otro producto de Firebase, solo debes crear un proyecto y registrar tu app. Sin embargo, si decides utilizar productos adicionales en el futuro, asegúrate de completar todos los pasos en la página vinculada anteriormente.

Paso 1. Compila la app

Cuando estés listo para distribuir la versión previa al lanzamiento de tu app a los verificadores, compila un archivo de distribución firmado. Puedes usar el proceso normal de compilación, siempre y cuando cumplas con los siguientes requisitos:

  • Para distribuir tu app fuera de tu equipo de desarrollo, debes usar un perfil de distribución ad hoc o empresarial.
  • Si tu app usa Game Center, APNS (y por extensión Cloud Messaging) o iCloud, asegúrate de que tu perfil de aprovisionamiento use un ID de app explícito y no un ID comodín.
  • Si usas un perfil de distribución ad hoc, incluye los ID únicos de dispositivo (UDID) de los dispositivos de los verificadores. A medida que los verificadores de iOS nuevos se inscriban en el programa de pruebas, será necesario que actualices el perfil de aprovisionamiento con los UDID de sus dispositivos. Consulta Registra dispositivos adicionales de verificadores.
  • Si hiciste cambios de código desde la última compilación (es decir, que no estás volviendo a compilar solo a fin de actualizar los dispositivos registrados), actualiza el número de versión visible para el usuario (Versión) y el número único de compilación (Compilación) del destino de compilación.

Cuando la compilación finalice, esta guardará un archivo IPA y algunos archivos de registro en la carpeta que especifiques. Distribuye el archivo IPA a tus verificadores en los siguientes pasos.

Paso 2. Distribuye las apps a los verificadores

Para distribuir tu app a los verificadores, sube el archivo IPA con Firebase CLI como sigue:

  1. Instala o actualiza a la versión más reciente de Firebase CLI (recomendamos descargar el objeto binario independiente para la CLI específica de tu SO). Asegúrate de acceder y probar que puedes ingresar a tus proyectos.
  2. En la página App Distribution de Firebase console, selecciona la aplicación que quieres distribuir y luego haz clic en Comenzar.
  3. Ejecuta el comando appdistribution:distribute a fin de que la compilación esté disponible para los verificadores. Usa los siguientes parámetros para configurar la distribución:

    Opciones de appdistribution:distribute
    --app

    Obligatorio: El ID de app de Firebase de tu aplicación. Puedes encontrar el ID de la app en la página Configuración generalde Firebase console.

    
    --app 1:1234567890:ios:0a1b2c3d4e5f67890
    --token

    Un token de actualización que se imprime cuando autenticas el entorno de CI con Firebase CLI (consulta Usa la CLI con sistemas de CI para obtener más información).

    
    --token "$FIREBASE_TOKEN"
    --release-notes
    --release-notes-file

    Las notas de la versión de esta compilación.

    Puedes especificar las notas de la versión directamente, como sigue:

    
    --release-notes "Text of release notes"

    O bien, especificar la ruta de acceso a un archivo de texto sin formato:

    
    --release-notes-file "/path/to/release-notes.txt"
    --testers
    --testers-file

    Las direcciones de correo electrónico de los verificadores que quieres invitar.

    Puedes especificar los verificadores como una lista de direcciones de correo electrónico separada por comas, como sigue:

    
    --testers "ali@example.com, bri@example.com, cal@example.com"

    O bien, puedes especificar la ruta de acceso a un archivo de texto sin formato que contenga una lista de direcciones de correo electrónico separada por comas, de la siguiente manera:

    
    --testers-file "/path/to/testers.txt"
    --groups
    --groups-file

    Los grupos de verificadores que deseas invitar (consulta Administra verificadores). Los grupos se especifican con alias de grupos, que puedes consultar en Firebase console

    Puedes especificar los grupos como una lista separada por comas, como sigue:

    
    --groups "qa-team, trusted-testers"

    O bien, puedes especificar la ruta de acceso a un archivo de texto sin formato que contenga una lista de nombres de grupo separada por comas, de la siguiente manera:

    
    --groups-file "/path/to/groups.txt"
    --debug

    Una marca que puedes incluir para imprimir un resultado de registro detallado.

    Por ejemplo:

    firebase appdistribution:distribute test.ipa  \
        --app 1:1234567890:ios:0a1b2c3d4e5f67890  \
        --release-notes "Bug fixes and improvements" --testers-file testers.txt
    

    Los verificadores que no recibieron invitaciones para probar la app las recibirán por correo electrónico para comenzar. Los verificadores existentes reciben notificaciones por correo electrónico en las que se indica que hay una compilación nueva lista para probarse.

Después de enviar las invitaciones de App Distribution, en Firebase console, puedes supervisar el estado de cada verificador invitado, ya sea que haya aceptado la invitación o que haya instalado la app.

Paso 3. Registra dispositivos adicionales de verificadores

Cuando los verificadores aceptan una invitación para probar una compilación no firmada con un perfil empresarial, se les solicita permiso a fin de compartir el UDID de sus dispositivos contigo. Si aceptan, App Distribution recopila el UDID del dispositivo y te notifica por correo electrónico sobre el UDID recién compartido.

Cuando recibas uno de estos correos, actualiza tu perfil de aprovisionamiento con el UDID y distribuye una compilación nueva a los verificadores siguiendo estos pasos:

  1. En la página Agregar dispositivos del portal de desarrolladores de Apple, registra el nuevo UDID especificado en el correo electrónico que recibiste.
  2. Agrega el dispositivo registrado a tu perfil de aprovisionamiento en la página Perfiles de aprovisionamiento de iOS.
  3. Descarga el perfil de aprovisionamiento y úsalo para volver a compilar tu aplicación. Si estás volviendo a compilar solo para actualizar los dispositivos registrados, no actualices el número ni la versión de compilación.
  4. Redistribuye tu app desde Firebase console o la CLI. Si ya distribuiste una compilación con el mismo número y versión de compilación, solo los usuarios de dispositivos registrados recientemente reciben los correos electrónicos de notificación.

Después de distribuir la compilación, tu verificador recibirá una invitación por correo electrónico de Firebase para instalar y probar tu app (consulta la guía de configuración del verificador a fin de obtener instrucciones para instalar la app de prueba). Puedes supervisar el estado de cada verificador (si aceptó la invitación y si descargó la app) en Firebase console.