Firebase App Distribution: conceptos clave, distribución de APK e IPA y configuración

Autor: IT Sectr Publicado: 2026-04-29 Tiempo de lectura: 8 min

Firebase App Distribution es un servicio de Google para distribuir compilaciones previas al lanzamiento de aplicaciones móviles entre testers y equipos internos sin necesidad de publicarlas en tiendas de aplicaciones. App Distribution proporciona una interfaz unificada para subir archivos APK e IPA, gestionar grupos de testers y recopilar comentarios. Según Firebase Documentation, 2026, el servicio notifica automáticamente a los testers sobre nuevas versiones por correo electrónico y notificaciones push, y la integración con Fastlane permite publicar compilaciones directamente desde el pipeline de CI/CD sin acciones manuales. App Distribution admite tanto Android (AAB/APK) como iOS (IPA), incluyendo distribución ad-hoc y empresarial.

Puntos clave

  • App Distribution — un servicio de Firebase para distribuir versiones beta de aplicaciones entre testers sin publicar en Google Play ni App Store.
  • Grupos de testers — un sistema flexible de gestión de acceso: cree grupos por roles, proyectos o etapas de prueba con diferentes permisos de compilación.
  • Notificaciones automáticas — los testers reciben notificaciones por correo electrónico y push en cada nueva compilación con un enlace de instalación.
  • Fastlane + Gradle — integración completa con sistemas CI/CD para publicación automática de compilaciones en cada commit o pull request.
  • Comentarios — los testers pueden enviar capturas de pantalla, registros y comentarios a través de la interfaz integrada o Firebase Crashlytics.

Qué es Firebase App Distribution

Firebase App Distribution es un servicio de Google para distribuir versiones previas al lanzamiento de aplicaciones móviles entre testers y partes interesadas. A diferencia de la publicación en tiendas de aplicaciones, App Distribution permite entregar compilaciones a participantes seleccionados al instante, sin un largo proceso de revisión. El servicio está integrado con Firebase Crashlytics, lo que permite a los desarrolladores recibir informes de fallos directamente de los testers y corregir problemas antes del lanzamiento público.

Por qué usar App Distribution

El proceso tradicional de distribución de versiones beta implica el envío manual de archivos APK/IPA por correo electrónico, la subida a servicios de intercambio de archivos de terceros o la configuración de un servidor propio. Firebase App Distribution resuelve estos problemas: un repositorio unificado de compilaciones en Google Cloud, notificaciones automáticas a los testers, gestión centralizada de accesos y comentarios integrados a través de Firebase Crashlytics. El servicio es indispensable para equipos que practican CI/CD y lanzamientos regulares: una nueva compilación está disponible para los testers en menos de un minuto después de la subida.

Formatos de compilación compatibles

App Distribution admite todos los formatos de compilación estándar para plataformas móviles. Para Android — APK y Android App Bundle (AAB) con generación automática de APK a partir de AAB durante la instalación. Para iOS — archivos IPA para distribución ad-hoc, de desarrollo y empresarial. Cada compilación incluye notas de lanzamiento, número de versión y código de compilación para seguimiento. El tamaño máximo de archivo de subida es de 500 MB y las compilaciones se almacenan durante 150 días.

Subida de compilaciones y gestión de versiones

La subida de compilaciones a Firebase App Distribution se realiza a través de Firebase Console, CLI (firebase appdistribution:distribute) o herramientas automatizadas como Fastlane y Gradle. Al subir, se especifica la versión de la compilación, las notas de lanzamiento y la lista de testers o grupos que deben recibir una notificación. Firebase asigna automáticamente un identificador único a la compilación y la pone a disposición para su instalación mediante un enlace.

Gestión de versiones a través de Firebase Console

Firebase Console proporciona una interfaz web para subir compilaciones y gestionar versiones. La consola muestra el historial de todas las compilaciones subidas con fecha, versión, estado y número de instalaciones. Un desarrollador puede deshabilitar una versión específica si se encuentra un error crítico — esto bloqueará la instalación de esa versión para todos los testers. La consola también muestra un gráfico de instalaciones por día, lo que ayuda a realizar un seguimiento de la actividad de prueba.

Subida automática a través de Firebase CLI

Firebase CLI permite subir compilaciones con un solo comando, lo que es conveniente para la integración en pipelines CI/CD. El comando distribute acepta una ruta de archivo, un token de acceso al proyecto, una lista de grupos de testers y notas de lanzamiento opcionales. La autenticación utiliza una cuenta de servicio de Firebase con el rol de Administrador de Firebase App Distribution. La CLI admite compilaciones tanto de Android como de iOS, detectando automáticamente la plataforma por la extensión del archivo.

bash
# Subida de una compilación a través de Firebase CLI
firebase appdistribution:distribute \
    app-release.apk \
    --app 1:123456789:android:abc123def456 \
    --groups "qa-team,product-owners" \
    --release-notes "Error de autorización corregido" \
    --token "FIREBASE_TOKEN"

Gestión de testers y grupos

Firebase App Distribution proporciona un sistema flexible de gestión de testers: se pueden añadir participantes por correo electrónico, crear grupos por roles o proyectos y asignar diferentes compilaciones a diferentes grupos. Cuando se añade un nuevo tester, el sistema le envía un correo electrónico de invitación con instrucciones para instalar la aplicación. Los testers reciben notificaciones automáticas sobre cada nueva compilación asignada a su grupo.

Creación de grupos de testers

Los grupos permiten organizar a los testers de forma funcional. Ejemplos de grupos: Equipo de QA (acceso completo a todas las compilaciones), Product Owners (acceso a compilaciones estables), Testers Externos (acceso limitado para beta testers externos). Un mismo tester puede pertenecer a varios grupos. Al subir una compilación, el desarrollador selecciona los grupos objetivo — solo los miembros de los grupos seleccionados reciben notificaciones, lo que elimina el ruido informativo.

Añadir testers a través de la API

Para añadir testers mediante programación se utiliza la API de Firebase App Distribution. La API permite crear testers, añadirlos a grupos y eliminarlos cuando sea necesario. Esto es útil para la integración con sistemas internos de gestión de pruebas y rastreadores de errores. Cuando se añade un tester a través de la API, también recibe un correo electrónico de invitación con un enlace para instalar la primera aplicación.

js
const admin = require("firebase-admin")

const serviceAccount = require("./serviceAccountKey.json")
admin.initializeApp({ credential: admin.credential.cert(serviceAccount) })

async function addTestersToGroup(email, groupAlias) {
    try {
        await admin.appDistribution().addTesters(email, [groupAlias])
        console.log("Tester añadido al grupo")
    } catch (error) {
        console.error("Error:", error)
    }
}

addTestersToGroup("tester@example.com", "qa-team")

Distribución de compilaciones Android

La distribución de compilaciones Android a través de Firebase App Distribution admite dos formatos: APK y Android App Bundle (AAB). Al subir un AAB, Firebase genera automáticamente un APK compatible con el dispositivo del tester utilizando Google Play App Signing. Los testers instalan la aplicación mediante un enlace directo — no necesitan acceso a Google Play Console ni ser añadidos como testers en Play Console. Esto simplifica significativamente el proceso de pruebas beta para Android.

Requisitos de las compilaciones Android

Para instalar a través de App Distribution, los testers deben habilitar la instalación desde fuentes desconocidas en su dispositivo. Firebase genera automáticamente un enlace a una página web con un botón de instalación del APK. Para el formato AAB, el dispositivo debe ser compatible con Play Core Library y tener instalado Google Play Store. Firebase recomienda usar AAB para versiones finales y APK para iteraciones rápidas.

Configuración de Gradle para App Distribution

El plugin de Firebase App Distribution para Gradle permite enviar compilaciones directamente desde una tarea de Gradle. La configuración incluye añadir el plugin com.google.firebase.appdistribution, configurar una cuenta de servicio y definir los grupos de destino. Tras la configuración, la tarea assembleDistRelease compilará la aplicación y la subirá a Firebase App Distribution con un solo comando.

groovy
// build.gradle (module: app)
plugins {
    id 'com.android.application'
    id 'com.google.firebase.appdistribution'
}

android { // standard config }

firebaseAppDistribution {
    appId "1:123456789:android:abc123def456"
    serviceCredentialsFile "firebase-sa.json"
    groups "qa-team"
    releaseNotes "Compilación automática"
}

Distribución de compilaciones iOS

La distribución de compilaciones iOS a través de Firebase App Distribution requiere configuración adicional porque Apple restringe la instalación de aplicaciones fuera de la App Store. Para distribuir aplicaciones iOS, es necesario utilizar certificados ad-hoc o empresariales del programa Apple Developer. Los testers deben ser añadidos al Portal de Desarrolladores de Apple como dispositivos para distribución ad-hoc, o utilizar distribución empresarial sin límite de dispositivos.

Configuración de distribución ad-hoc

Para la distribución ad-hoc, es necesario recopilar los UDID de todos los dispositivos de los testers y añadirlos al Portal de Desarrolladores de Apple. Firebase App Distribution muestra a los testers instrucciones para encontrar su UDID y guarda automáticamente los dispositivos registrados. Después de añadir el UDID al perfil de aprovisionamiento y compilar el IPA, los testers reciben un enlace de instalación. Firebase recomienda usar un certificado empresarial para proyectos con un gran número de testers, ya que ad-hoc está limitado a 100 dispositivos por cuenta.

Compilación de IPA a través de Fastlane

Fastlane es la herramienta recomendada para automatizar la compilación de aplicaciones iOS. El lane match gestiona los certificados y perfiles de aprovisionamiento, mientras que el lane sigh crea un IPA para su distribución. Firebase App Distribution se integra con Fastlane a través del plugin firebase_app_distribution, que sube el IPA y notifica a los testers. Fastlane también admite la gestión de versiones y notas de lanzamiento a través de plugins adicionales.

ruby
# Fastfile
lane :beta do
    match(type: :adhoc)
    gym(scheme: "MyApp", export_method: "ad-hoc")
    firebase_app_distribution(
        app: "1:123456789:ios:abc123def456",
        groups: "qa-team",
        release_notes: "Compilación del #\{Time.now.strftime
            ('%Y-%m-%d %H:%M')}"
    )
end

Integración con CI/CD y Fastlane

La integración completa de Firebase App Distribution con CI/CD permite publicar automáticamente nuevas compilaciones con cada commit en el repositorio. Al configurar un pipeline de CI, el equipo recibe comentarios instantáneos de los testers minutos después de un push de código. App Distribution admite todos los sistemas CI populares: GitHub Actions, GitLab CI, Jenkins, Bitrise y CircleCI. Cada plataforma requiere su propia configuración, pero el principio general es el mismo: compilar → subir → notificar.

Configuración a través de GitHub Actions

GitHub Actions permite configurar la distribución automática de compilaciones al hacer push a la rama develop o al crear un pull request. El workflow incluye instalar Java/Flutter/Node.js, compilar la aplicación, autenticarse a través de una cuenta de servicio de Firebase y ejecutar la CLI de Firebase con el comando distribute. Los secretos (tokens, cuentas de servicio) se almacenan en GitHub Secrets y no se exponen en los registros de compilación. Para iOS, se requiere adicionalmente la configuración de Xcode y la instalación de Fastlane en el workflow.

yaml
# .github/workflows/distribute.yml
name: Distribute to Firebase
on:
  push: { branches: [ develop ] }
jobs:
  build-and-distribute:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Setup Java
        uses: actions/setup-java@v3
        with: { distribution: "temurin", java-version: "17" }
      - name: Build APK
        run: ./gradlew assembleDebug
      - name: Upload to Firebase
        uses: wzieba/Firebase-Distribution-GitHub-Action@v1
        with:
          appId: "${{ secrets.FIREBASE_APP_ID }}"
          serviceCredentialsFileContent: "${{ secrets.FIREBASE_SA_KEY }}"
          groups: qa-team
          file: app/build/outputs/apk/debug/app-debug.apk

Recopilación de comentarios

Firebase App Distribution se integra con Firebase Crashlytics para la recopilación automática de informes de fallos de los testers. Crashlytics vincula automáticamente un fallo con una versión de compilación y un dispositivo específicos, lo que ayuda a localizar y corregir rápidamente el problema. Los testers también pueden enviar capturas de pantalla y comentarios a través de la interfaz web de App Distribution, recibiendo un enlace al formulario de comentarios después de instalar la compilación.

Preguntas frecuentes

¿En qué se diferencia App Distribution de TestFlight?

Firebase App Distribution es un servicio multiplataforma (Android + iOS), a diferencia de TestFlight que solo funciona para iOS. App Distribution también se integra con Crashlytics y Firebase Analytics, proporcionando un ecosistema unificado para pruebas beta en ambas plataformas.

¿Cuánto tiempo se almacenan las compilaciones en App Distribution?

Las compilaciones se almacenan durante 150 días desde la fecha de subida. Después de este período, se eliminan automáticamente. Se recomienda subir nuevas compilaciones con regularidad y eliminar manualmente las obsoletas a través de Firebase Console para evitar que los testers instalen versiones antiguas.

¿Cuántos testers se pueden añadir?

No hay límite en el número de testers en Firebase App Distribution. Para la distribución ad-hoc de iOS, se aplica el límite de Apple de 100 dispositivos por cuenta. Para la distribución empresarial de Android e iOS, no hay restricciones en el número de testers.

¿Se puede subir AAB en lugar de APK para Android?

, App Distribution admite AAB (Android App Bundle). Firebase genera automáticamente un APK a partir del AAB para cada dispositivo del tester mediante Google Play App Signing. Esto es especialmente útil para realizar pruebas antes de publicar en Play Store.

¿Firebase App Distribution es gratuito?

, App Distribution está incluido en el plan gratuito Spark de Firebase. Límites del plan Spark: hasta 500 testers y 25 000 instalaciones al mes por proyecto. El plan Blaze elimina estos límites y añade soporte prioritario.

Resumen

  • Firebase App Distribution es un servicio para distribuir compilaciones beta de aplicaciones móviles con soporte para Android (APK/AAB) e iOS (IPA) sin publicar en tiendas.
  • Gestión de testers — un sistema flexible de grupos con notificaciones automáticas por correo electrónico y push en cada nueva compilación.
  • Subida de compilaciones se realiza a través de Firebase Console, CLI, plugin de Gradle o Fastlane con notificación automática a los testers.
  • Compilaciones Android admiten APK y AAB con generación automática de APK a partir de AAB, instalación mediante enlace directo sin Google Play Console.
  • Compilaciones iOS requieren un certificado ad-hoc o empresarial de Apple, con registro de UDID y compatibilidad con Fastlane para la automatización de compilación de IPA.
  • Integración CI/CD — GitHub Actions, GitLab CI, Jenkins, Bitrise con Firebase CLI o Fastlane para publicación automática en cada push.
  • Gratuito hasta 500 testers y 25 000 instalaciones al mes, compilaciones almacenadas durante 150 días, integrado con Firebase Crashlytics para la recopilación de informes de fallos.

Desarrollaremos una aplicación móvil llave en mano

IT Sectr crea aplicaciones para iOS y Android para startups y empresas desde 2017. Le asesoraremos y le propondremos la mejor solución.

Discutir el proyecto

Lea también