Distribuye apps para iOS a los verificadores con fastlane

Puedes distribuir compilaciones a los verificadores con fastlane, una plataforma de código abierto que automatiza la compilación y el lanzamiento de apps para iOS y Android. Sigue las instrucciones simples que se definen en un Fastfile. Después de configurar fastlane y tu Fastfile, puedes integrar App Distribution con tu configuración de fastlane.

Antes de comenzar

  1. Instala y configura fastlane.
  2. 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 si puedes acceder a tus proyectos.

1. Configura fastlane y tu Fastfile

  1. Recupera la ruta de acceso instalada de Firebase CLI. La ruta de acceso se usa para configurar tu Fastfile en los próximos pasos.
  2. Agrega App Distribution a tu configuración de fastlane. Para ello, ejecuta el siguiente comando desde la raíz de tu proyecto de iOS:
    fastlane add_plugin firebase_app_distribution
  3. Si el comando te muestra una opción, selecciona Option 3: RubyGems.org.

2. Distribuye las apps a los verificadores

  1. En un carril de tu ./fastlane/Fastfile, agrega un bloque firebase_app_distribution. Usa los siguientes parámetros para configurar la distribución.

    Parámetros de firebase_app_distribution
    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"
    firebase_cli_path

    Ruta de acceso absoluta al objeto binario de Firebase CLI. Si no se especifica, fastlane determina la ubicación del binario a partir de la salida de which firebase.

    firebase_cli_token

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

    ipa_path

    Ruta absoluta al archivo IPA que deseas subir. Si no se especifica, fastlane determina la ubicación del archivo desde el carril en el que se generó el archivo.

    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 booleana. Puedes configurar esto en true para imprimir la salida de depuración detallada, o en false para imprimir la salida de depuración normal.

    Por ejemplo:

      platform :ios do
          desc "My awesome app"
          lane :distribute do
              build_ios_app(...) # build_ios_app is a built-in fastlane action.
    
              firebase_app_distribution(
                  app: "1:123456789:ios:abcd1234",
                  testers: "tester1@company.com, tester2@company.com",
                  release_notes: "Lots of amazing new features to test out!",
                  firebase_cli_path: "/absolute/path/to/firebase/cli/binary"
              )
    
          end
      end
      

  2. Por último, para hacer que la compilación esté disponible para los verificadores, ejecuta tu carril de la siguiente manera:

    fastlane <lane>

En Firebase console, después de distribuir una compilación nueva, puedes supervisar el estado de cada verificador, ya sea si aceptó la invitación o si descargó la app.