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 la app fuera de tu equipo de desarrollo, debes usar un perfil de distribución ad hoc o empresarial.
  • Si tu app usa Game Center, APN (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 la app a los verificadores

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

  1. Instala Firebase CLI o actualízala a la versión más reciente (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 app que quieres distribuir y, luego, haz clic en Comenzar.
  3. Ejecuta el comando appdistribution:distribute para subir la app y distribuirla a 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 general de 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
    

Una vez que distribuyas la compilación, estará disponible en el panel de App Distribution de Firebase console durante 150 días (cinco meses). Cuando falten 30 días para el vencimiento de la compilación, se mostrará un aviso de vencimiento en la consola y en la lista de compilaciones de tu verificador, en el dispositivo de prueba.

Los verificadores que no recibieron invitaciones para probar la app las recibirán por correo electrónico para comenzar, y los verificadores existentes recibirán notificaciones por correo electrónico en las que se indicará que hay una nueva compilación lista para probar (consulta la guía de preparación para verificadores si necesitas instrucciones para instalar la app de prueba). En Firebase console, puedes supervisar el estado de cada verificador (si aceptó la invitación y si descargó 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 app. 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 recibirán los correos electrónicos de notificación.