Preguntas frecuentes y solución de problemas de App Distribution

iOS Android

En esta página, se proporciona ayuda para la solución de problemas y respuestas a preguntas frecuentes sobre la distribución y prueba de apps con App Distribution.

Distribución de apps

Usa las siguientes sugerencias para solucionar problemas que podrían surgir durante la distribución de apps a tus verificadores.

No se puede distribuir una app porque falta el correo electrónico de contacto

Cuando subas una app, es posible que veas el siguiente error:

"We could not find a contact email for app <app-id>. Please visit App Distribution within the Firebase console to set one up”.

Si está disponible, configura un correo electrónico de contacto en Firebase console. Si el problema persiste, comunícate con el equipo de Asistencia de Firebase.

Se produjo un error cuando se aprovisionaba la app (errores 400, 409 o 500)

Si encuentras los errores 400, 409 o 500 durante el aprovisionamiento, comunícate con el equipo de Asistencia de Firebase. Indica el número del proyecto de Firebase y el identificador de la app.

No se pudo subir el archivo APK

1. Verifica el tamaño del APK. El límite máximo para todos los objetos binarios es de 2,048 MiB, que es un poco más de 2 GB.

2. Si el tamaño del APK cumple con el límite y puedes reproducir el error, comunícate con el equipo de Asistencia de Firebase.

No se pudo subir el APK con fastlane porque no tiene firma

Verifica que el APK esté firmado con el siguiente comando:

apksigner verify --verbose ~/app-distro/app-distro-apps/[path_name]/app/ build/outputs/apk/debug/app-debug.apk

Distribuye Android App Bundles (AAB)

Recepción de errores con proveedores de API de acceso social o de terceros

Cuando subes un AAB a App Distribution, Google Play vuelve a firmar automáticamente el APK generado mediante un certificado de clave de firma de la app de prueba. Cuando se te solicite, debes registrar tu app con proveedores de API si quieres seguir usando sus servicios de terceros. Una vez firmado, el certificado de prueba de tu app se puede ver en Firebase console.

¿Los AAB que subo también aparecen en Google Play?

Las compilaciones AAB que subes a App Distribution no aparecen en tu cuenta de desarrollador de Google Play (esto incluye el explorador de paquetes de aplicaciones y el uso compartido interno de apps).

¿Qué sucede si desvinculo Firebase de Google Play?

Si una app de Firebase para Android no está vinculada a Google Play, sucede lo siguiente:

• No podrás subir nuevos paquetes de aplicaciones a App Distribution ni exportarlos a Google Play mediante la integración de App Distribution con Google Play.

• Las compilaciones existentes seguirán disponibles en el panel de Firebase App Distribution y para los verificadores.

• Todos los datos exportados previamente entre Firebase y Google Play seguirán disponibles en ambos productos.

¿Puedo intentar vincular una app a Google Play?

Para distribuir un Android App Bundle (AAB) mediante App Distribution y vincular automáticamente los AAB subidos a tu proyecto de Firebase y a la cuenta de desarrollador de Google Play, asegúrate de cumplir con los siguientes requisitos:

• Tu cuenta de desarrollador de Google Play tiene uno de los siguientes niveles de acceso: propietario o administrador.

• Para tu proyecto de Firebase, tienes uno de los siguientes roles: propietario o administrador de Firebase.

• Tu app está registrada en Firebase y tu cuenta de desarrollador de Google Play. Esto significa que tienes una app de Firebase para Android y una app de Google Play.

• La app en Google Play y la app de Firebase para Android deben estar registradas con el mismo nombre de paquete.

• La app en Google Play debe estar configurada en el panel de apps y se distribuye en uno de los segmentos de Google Play (Pruebas internas, Pruebas cerradas, Pruebas abiertas o Producción).

• La revisión de la app en Google Play debe estar completa y la app debe estar publicada. La app está publicada si en la columna Estado de la app se muestra uno de los siguientes estados: Pruebas internas (no en borrador), Pruebas cerradas, Pruebas abiertas o Producción.

Si subiste una app que anteriormente no cumplía con los criterios mencionados para la vinculación, pero ahora sí lo hace, puedes intentar vincular tu app de Firebase para Android a Google Play.

Instala y prueba apps

Usa las siguientes sugerencias para solucionar problemas que los verificadores podrían encontrar cuando instalen y prueben tus apps.

El verificador no tiene una Cuenta de Google

Cuando un usuario crea una Cuenta de Google, recibe automáticamente una dirección de Gmail.

Si un verificador no tiene una dirección de Google Workspace o Gmail, o si prefiere usar otra dirección de correo electrónico, pídele que la vincule a la cuenta y la utilice para acceder.

Al momento de elegir un correo electrónico alternativo, el verificador debe seguir estos lineamientos:

• No usar una dirección de Gmail
• No usar una dirección de correo electrónico que ya esté vinculada a otra Cuenta de Google
• Usar la contraseña de la Cuenta de Google cuando acceda con esta dirección de correo electrónico

Para obtener más información, consulta Cómo acceder a tu Cuenta de Google con otra dirección de correo electrónico.

El verificador no puede ver las apps ni las compilaciones correctas

Si el verificador aceptó la invitación con una dirección de correo electrónico diferente a la de la invitación, es posible que no pueda ver las apps o compilaciones correctas.

El correo electrónico al que el desarrollador envía invitaciones y que se agrega a compilaciones nuevas (correo electrónico A) puede ser diferente del correo electrónico que el verificador usa para aceptar la invitación (correo electrónico B). Esta acción crea un vínculo detrás de escena. Cuando se agrega el correo electrónico A a compilaciones nuevas, en realidad es el correo electrónico B el que puede acceder.

Si el verificador aceptó la invitación con una dirección de correo electrónico diferente, sigue estos pasos para resolver el problema:

1. Borra al verificador de la sección Ver todos los verificadores de la pestaña Verificadores y grupos en la página de App Distribution de Firebase console. De esta forma, se quitan las invitaciones existentes.

2. Vuelve a invitar al verificador para que pruebe tu app. Este debería recibir un correo electrónico de invitación.

3. Asegúrate de que acepte la invitación con la misma dirección de correo electrónico.

El verificador no recibe notificaciones por correo electrónico

Es posible que los verificadores no reciban notificaciones por correo electrónico si ocurre alguna de las siguientes situaciones:

• Las notificaciones por correo electrónico llegan a la carpeta de spam.

• El correo electrónico tiene filtros.

• La invitación se envió a una cuenta de correo electrónico, pero el verificador aceptó con otra cuenta. El verificador recibe correos electrónicos con nuevos lanzamientos en la cuenta a la que se envió originalmente la invitación.

• El verificador se invitó anteriormente, pero no aceptó la invitación inicial. Si se agrega el verificador a las versiones posteriores, App Distribution no le enviará notificaciones de lanzamiento automáticamente debido a que no aceptó la invitación inicial.

Solución 1

1. Pídele al verificador que revise su carpeta de spam y los filtros que configuró en su servicio de correo electrónico.

2. Si el verificador anuló la suscripción a los correos electrónicos, pídele que haga lo siguiente:

   1. Busca uno de los correos electrónicos que el verificador recibió anteriormente de la app.
   2. Haz clic en Administrar la configuración de correo electrónico en la parte inferior y haz clic en Permitir correos electrónicos para volver a suscribirlo.

Solución 2

Si el verificador no quiere recibir notificaciones por correo electrónico, pero puede aceptar invitaciones de la app, puede ver las invitaciones pendientes de la app directamente en la app de App Tester (descargar instrucciones).

Nota: Para ver las invitaciones pendientes de la app, la dirección de correo electrónico de la Cuenta de Google que usa el verificador para acceder a la app de App Tester debe coincidir con el destinatario dirección de correo electrónico de la invitación del desarrollador.

Solución 3

1. Borra al verificador de la sección Ver todos los verificadores de la pestaña Verificadores y grupos en la página de App Distribution en Firebase console. Esta acción quita las invitaciones existentes.

2. Vuelve a invitar al verificador para que pruebe tu app. Este debería recibir un correo electrónico de invitación. Asegúrate de que acepte la invitación con la misma dirección de correo electrónico a la que se envió.

La app no indica que está instalada

Si un verificador descarga y, luego, instala una versión, pero en la interfaz de usuario de los detalles de la app no indica que está instalada, se trata de un problema conocido. En algunos casos, el ID del paquete en la app de Firebase no coincide con el ID del paquete del APK.

Verifica que el ID del paquete del APK coincida con el de la app de Firebase que usaste para subir la distribución.

Alerta de Android que indica que mi dispositivo no puede instalar apps desconocidas

Se muestra la alerta de Android si la app o el navegador que ejecutas aún no tienen permiso para instalar apps fuera de Google Play. Para otorgar permisos, haz lo siguiente:

• Android 8 o versiones posteriores: En la app de Configuración, presiona Confiar en esta fuente.

• Android 7 o versiones anteriores: En la app de Configuración, presiona Seguridad y selecciona Fuentes desconocidas. Cuando aparezca el mensaje, presiona Aceptar > Confiar.

No se pueden instalar los APK de prueba

Si no se puede instalar un APK de prueba en el dispositivo de un verificador, haz lo siguiente:

• Verifica que los certificados de la versión nueva coincidan con los de la versión instalada en el dispositivo del verificador. El sistema Android solo permite que la app se actualice si los certificados coinciden. Para obtener más información, consulta Consideraciones sobre las firmas.
• Asegúrate de que la app admita la versión del SO del dispositivo de verificación (consulta minSdkVersion).

No es posible acceder a la app de Android App Tester

Si la app de App Tester te impide acceder y te redirecciona a la pantalla de acceso, es posible que estés usando Google Workspace (antes conocido como G Suite) con restricciones de configuración.

Para quitar la configuración de restricciones, sigue estos pasos:

1. En la pestaña Apps de tu Google Workspace, asegúrate de que Firebase App Distribution no esté configurado en Acceso: Bloqueado.

2. En la pestaña Servicios, asegúrate de que Cloud Platform no esté restringido.

3. Una vez que quites la configuración, vuelve a intentar acceder.

Aparece el error “No se puede instalar la app” cuando se instala el AAB

Este error puede ocurrir cuando la app que se está instalando entra en conflicto con otra que ya está instalada en el dispositivo. Por ejemplo, podría ser una variante diferente de la misma app con el mismo permiso personalizado o nombre ContentProvider.

Puedes pedirle al verificador que recopile un informe de errores inmediatamente después de experimentar el problema y que lo inspeccione para obtener más información sobre la causa. El verificador debe borrar cualquier app en conflicto antes de que se pueda instalar la nueva.

Error 403: “Comunícate con tu administrador para obtener acceso”

Si encuentras un error del tipo 403, la cuenta que estás usando no tiene permiso para instalar ni probar apps. El administrador del dominio de tu cuenta de Google Workspace determina el acceso.

Si crees que deberías tener permiso para instalar y probar apps, pídele al administrador de tu cuenta de Google Workspace que cambie la configuración. Este debe seguir las instrucciones del artículo sobre cómo administrar el acceso a los servicios que no se pueden controlar por separado.

Si tienes varias cuentas, intenta acceder con una diferente que no te impida instalar y probar apps.

Cómo realizar pruebas en un dispositivo Android nuevo

Si es la primera vez que usas esta función, consulta Prepárate como verificador.

Si eres verificador de App Distribution y recibes un dispositivo Android nuevo para probar, en lugar de volver a pasar por todo el flujo de verificadores nuevo, sigue estos pasos:

1. Ve a appdistribution.firebase.google.com en tu dispositivo Android.

2. Accede con tu cuenta de verificador existente y haz clic en el botón Descargar App Tester en la parte inferior de la pantalla para instalar la app de Android App Tester.

Habilita funciones de verificador con el SDK de Android para App Distribution

Usa las siguientes sugerencias para solucionar problemas relacionados con la habilitación de alertas de compilación nuevas en la app o el envío de comentarios desde la app con el SDK de Android de App Distribution.

El verificador no puede iniciar comentarios en la app

Si ya configuraste el SDK de Android para App Distribution en tu app para que admita comentarios en la app, y los verificadores no puedan enviar comentarios, sigue estos pasos:

1. Habilita el registro detallado para el SDK de Android para App Distribution en tu app:

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

2. Para buscar mensajes de error en los registros de tu app, filtra por “FirebaseAppDistribution”.

3. Confirma que el verificador tenga acceso a la versión instalada:

   1. Si los registros indican que “el verificador no tiene acceso a este recurso”, es posible que no haya recibido una invitación a la app o que no tenga acceso a la versión.

   2. En el panel de App Distribution de Firebase console, busca la versión exacta que se ejecuta en el dispositivo del verificador y asegúrate de que se muestre en la pestaña Verificadores de la tarjeta de la versión y esté en el estado Aceptado.

   Si aún no recibes comentarios, sigue estos pasos:

   1. En el dispositivo de prueba, accede a Firebase App Distribution con App Tester o la app web para verificadores. Asegúrate de seleccionar la Cuenta de Google que usaste cuando aceptaste la invitación para probar la app.

   2. Vuelve a instalar la app con App Tester o la aplicación web de prueba para asegurarte de que tenga acceso a la versión.

   3. Intenta enviar comentarios y asegúrate de acceder con la misma Cuenta de Google.

4. Asegúrate de haber habilitado la API de Firebase App Tester. Para obtener más información, consulta Habilita la API de App Distribution Tester.

5. En Restricciones de claves, asegúrate de que la API de App Distribution Tester se incluya en la lista de API permitidas.

No se reciben comentarios enviados en la app

1. Si ves este mensaje cuando envías comentarios que indica que se enviarían comentarios, pero no se enviaron debido al modo de desarrollo, ejecuta el siguiente comando para inhabilitar el modo de desarrollador en el dispositivo:

   adb shell setprop debug.firebase.appdistro.devmode false
   

2. Verifica el archivo google-services.json para asegurarte de que estás enviando comentarios para el proyecto y la app correctos.

3. Habilita el registro detallado para el SDK de Android para App Distribution en tu app:

   adb shell setprop log.tag.FirebaseAppDistribution VERBOSE
   

4. Para buscar mensajes de error en los registros de tu app, filtra por “FirebaseAppDistribution”.

El verificador no recibe alertas en la app

Si ya configuraste el SDK de Android para App Distribution en tu app y tus verificadores no reciben alertas en la app, sigue estos pasos:

1. Para verificar los mensajes de error, adjunta una OnFailureListener a la tarea que muestra la API de Firebase App Distribution.

   Java

     firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener ( e -> {
                     if (e instanceof FirebaseAppDistributionException) {
                        // Log exception here
                     }});
   

   Kotlin

     firebaseAppDistribution.updateIfNewReleaseAvailable().addOnFailureListener { e ->
                     if (e is FirebaseAppDistributionException) {
                        // Log exception here
                     }
     }
   

2. Comprueba que el verificador tenga acceso a la versión nueva:

   1. Habilita el modo de depuración en la app. Para obtener más información, consulta la documentación de Google Analytics.

   2. Ejecuta tu app en un simulador y busca la string “FirebaseAppDistribution”.

      Si los registros indican que no se encontró ninguna versión o que el verificador no tiene acceso, es posible que aún no se le haya asociado a la versión nueva.

   3. En el panel de App Distribution de Firebase console, asegúrate de que el verificador esté incluido en la distribución de compilación y que el estado de la invitación sea Aceptada.

      Si el verificador aún no recibe alertas, pídele que siga estas sugerencias para confirmar que haya aceptado la invitación a fin de probar la app y haya configurado el dispositivo de prueba de manera correcta:

      1. En el dispositivo de prueba, accede a Firebase App Distribution mediante App Tester o la app web para verificadores. Recuerda seleccionar la Cuenta de Google que usaste cuando aceptaste la invitación para probar la app.

      2. Asegúrate de que la nueva versión de la app esté disponible en App Tester o en la aplicación web para verificadores.

Se solicitó que el verificador volviera a acceder después de cerrar la app

De forma predeterminada, los verificadores solo deben acceder a su Cuenta de Google una vez para habilitar las funciones de prueba. Si se solicita a los verificadores que vuelvan a acceder luego de cerrar y volver a abrir la app, sigue estas sugerencias para asegurarte de que App Distribution esté configurado correctamente:

• Asegúrate de haber habilitado la API de Firebase App Tester. Para obtener más información, consulta Habilita la API de App Distribution Tester.

• En Restricciones de claves, asegúrate de que la API de App Distribution Tester se incluya en la lista de API permitidas.

• Si, por lo general, borras SharedPreferences luego de salir, es posible que estés borrando el estado del verificador. App Distribution almacena una marca que indica si el verificador ya accedió a la app. Para obtener más información, consulta el repositorio de GitHub.

Preguntas frecuentes

¿Hay límites para agregar verificadores a mi app?

Firebase App Distribution tiene los siguientes límites de verificadores:

• Agrega un máximo de 500 verificadores a un proyecto de Firebase.

• Agrega un máximo de 200 verificadores a un grupo de App Distribution.

Para agregar más verificadores, solicita un aumento de límite sin costo.

¿Mis invitaciones de verificador vencen?

Los verificadores tendrán 30 días para aceptar una invitación a fin de probar la app antes de que venza. Cuando falten 5 días para que venza la invitación, aparecerá un aviso en Firebase console junto al verificador en una versión. Si quieres renovar una invitación, puedes usar el menú desplegable de la fila del verificador para reenviarla.

¿Durante cuánto tiempo están disponibles las versiones de las apps?

Las versiones de la app se quitan de App Distribution si se produce alguna de las siguientes condiciones:

• La versión de la app tiene más de 150 días de antigüedad.
• Superaste el límite de 1,000 versiones de apps y la versión es anterior a las 1,000 más recientes.

Para obtener más información, consulta App Distribution admite un máximo de 1,000 versiones.

Una vez que la app alcanza o supera el límite de vencimiento de 150 días o el de 1,000, la versión se quita del panel de App Distribution y de la app de Firebase App Tester. Si el verificador instaló la versión, se seguirá ejecutando la versión local de la app.

Para que la versión de la app permanezca disponible por más tiempo, usa una de las siguientes recomendaciones:

• Antes de que la versión de la app venza o exceda el límite de versiones, descarga el APK o el AAB, y borra la versión del panel de App Distribution. Luego, vuelve a subir el APK o el AAB como una compilación nueva a App Distribution.
• Descarga la versión y súbela a Cloud Storage para archivarla a largo plazo.

Las versiones de la app vencen después de 150 días

Cuando subes una versión de tu app en Firebase, esta aparece en el panel de App Distribution durante 150 días a partir de la fecha de carga. Después de subir la versión, puedes distribuirla a los verificadores que instalen la versión desde la app de Firebase App Tester en su dispositivo de prueba.

Cuando falten 30 días para la fecha de vencimiento, aparecerá una notificación de vencimiento de la app en la app de Firebase App Tester.

App Distribution admite un máximo de 1,000 versiones

App Distribution permite un máximo de 1,000 versiones por app. Cuando tu app alcanza el límite de 1,000 versiones, App Distribution borra automáticamente las versiones más antiguas que superan el límite.

Si deseas administrar las actualizaciones de tus apps de forma manual, usa la API de REST de App Distribution para enumerar y borrar versiones de la app de forma masiva.

Si tienes preguntas, comunícate con el equipo de Asistencia de Firebase.

¿Cómo puedo acceder a las apps de prueba que instalé en mi dispositivo?

Si eres verificador, te recomendamos descargar Firebase App Tester, una app que te permite acceder a todas tus compilaciones de prueba en un solo lugar.

¿Cómo borro mi cuenta de verificador?

Para borrar tu cuenta de verificador de App Distribution y sus datos asociados, sigue estos pasos en orden:

1. Visita https://appdistribution.firebase.google.com y accede con tu Cuenta de Google.

2. En la parte superior derecha, haz clic en (Manage account)

   Borrar cuenta.

3. Opcional: En los permisos de tu Cuenta de Google, revoca el acceso desde Firebase App Distribution. Ten en cuenta que si revocas el acceso sin borrar primero la cuenta de App Distribution no se borrarán ni tu cuenta ni tus datos de verificador.