Ir a la consola

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 los has hecho, agrega Firebase a tu proyecto de iOS.

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

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.

2. Distribuye las apps a los verificadores

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

  1. 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 a tu cuenta y probar que puedes acceder a tus proyectos.
  2. En la página App Distribution de Firebase console, selecciona la aplicación que deseas distribuir, 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 la app. Puedes encontrar el ID de la app en Firebase console, en la página Configuración general.

    
    --app 1:1234567890:ios:0a1b2c3d4e5f67890
    --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 separada por comas de direcciones de correo electrónico, 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 separada por comas de direcciones de correo electrónico.

    
    --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 revisar 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 separada por comas de nombres de grupo:

    
    --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.

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 mediante 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 que completes estos pasos, el verificador puede completar el flujo de integración y, luego, instalar tu app.