Recopile comentarios de los probadores

El SDK de Android de Firebase App Distribution es una versión beta . Esto significa que la funcionalidad podría cambiar de forma incompatible con versiones anteriores. Una versión beta no está sujeta a ningún SLA ni a una política de obsolescencia y puede recibir soporte limitado o nulo.

Esta guía describe cómo habilitar los comentarios dentro de la aplicación utilizando el SDK de Android Firebase App Distribution opcional, para que sus evaluadores puedan enviar comentarios (incluidas capturas de pantalla) directamente en la aplicación.

Antes de que empieces

Si aún no lo has hecho, agrega Firebase a tu proyecto de Android .

Nota: Si tiene varias aplicaciones en su proyecto de Firebase, asegúrese de que la aplicación que desea distribuir con App Distribution tenga su propio archivo de configuración google-services.json . Para obtener más información, consulte Soporte para múltiples entornos .

Paso 1: habilite la API del probador de distribución de aplicaciones

1. Abra la consola de Google Cloud y seleccione su proyecto de Firebase.

2. En la API de Firebase App Testers, haz clic en Habilitar .

Paso 2: agregue distribución de aplicaciones a su aplicación

El SDK de Android de distribución de aplicaciones consta de dos bibliotecas:

• firebase-appdistribution-api : la biblioteca exclusiva de API, que puedes incluir en todas las variantes de compilación .
• firebase-appdistribution : la implementación completa del SDK (opcional).

Precaución: Para admitir funciones como notificar a los evaluadores sobre nuevas compilaciones , la implementación completa del SDK de Android de distribución de aplicaciones contiene una funcionalidad de actualización automática que puede considerarse una violación de la política de Google Play , incluso si ese código no se ejecuta en tiempo de ejecución. Enviar su aplicación a Google Play sin eliminar la implementación completa del SDK puede provocar que su aplicación se elimine de Google Play.

La biblioteca exclusiva de API permite que su código realice llamadas al SDK. Las llamadas no tienen ningún efecto si la implementación completa del SDK no está presente.

1. Declare la dependencia del SDK de Android de distribución de aplicaciones en el archivo Gradle de su módulo (nivel de aplicación) (generalmente <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle ).

2. Para evitar incluir la funcionalidad de actualización automática de la implementación completa del SDK en sus compilaciones de Google Play, identifique las variantes de compilación, incluidos los tipos de compilación o los tipos de productos que distribuirá a través de App Distribution.

3. Declare la dependencia del SDK de Android de distribución de aplicaciones en el archivo Gradle de su módulo (nivel de aplicación) (normalmente app/build.gradle ). Agregue la implementación completa del SDK solo a las variantes destinadas exclusivamente a pruebas previas al lanzamiento:

   Kotlin+KTX

   dependencies {
       // ADD the API-only library to all variants
       implementation("com.google.firebase:firebase-appdistribution-api-ktx:16.0.0-beta12")
   
       // ADD the full SDK implementation to the "beta" variant only (example)
       betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta12")
   }
   

   Java

   dependencies {
       // ADD the API-only library to all variants
       implementation("com.google.firebase:firebase-appdistribution-api:16.0.0-beta12")
   
       // ADD the full SDK implementation to the "beta" variant only (example)
       betaImplementation("com.google.firebase:firebase-appdistribution:16.0.0-beta12")
   }
   

Paso 3: configurar comentarios en la aplicación

Para recopilar comentarios de sus evaluadores, utilice uno de los siguientes activadores para permitir que los evaluadores inicien comentarios:

• Activador de notificación incorporado : el SDK de Android de distribución de aplicaciones puede mostrar una notificación continua que el evaluador puede aprovechar desde cualquier lugar de la aplicación. Utilice este activador si desea comenzar más rápidamente y no necesita personalizar la forma en que sus evaluadores brindan comentarios.

• Activador personalizado : puede proporcionar su propio mecanismo de activación, como tocar un botón o elemento del menú en su aplicación o agitar el dispositivo.

Cuando utiliza cualquiera de estos activadores y el evaluador envía comentarios, el SDK de Android realiza las siguientes acciones:

1. Captura una captura de pantalla de la actividad actual de la aplicación.

2. Ejecuta comprobaciones para garantizar que el evaluador habilitó las funciones de prueba del SDK. Si las funciones de prueba no están habilitadas, el SDK de Android solicita al evaluador que inicie sesión en App Distribution con su cuenta de Google.

   Nota: La habilitación de funciones de prueba es un proceso único en el dispositivo de prueba y persiste en todas las actualizaciones de su aplicación. Las funciones de prueba permanecen habilitadas en el dispositivo de prueba hasta que el evaluador desinstale la aplicación o hasta que la aplicación llame al método signOutTester .

3. Inicia una actividad en pantalla completa que permite al evaluador escribir y enviar sus comentarios.

Opción 1: Activador de notificación

Utilice showFeedbackNotification() para mostrar una notificación persistente o continua en el dispositivo del evaluador que puede tocar para iniciar comentarios. Cuando configura la notificación, debe proporcionar un texto que se mostrará al evaluador antes de enviar comentarios y un nivel de interrupción para la notificación (correspondiente a la importancia del canal de notificación). Si desea notificar a sus evaluadores sobre la recopilación y el procesamiento de sus datos de comentarios, puede utilizar el texto para proporcionar dicho aviso.

Cuando usas showFeedbackNotification() y cuando la aplicación pasa a segundo plano, la notificación se oculta. Si desea ocultar explícitamente la notificación, utilice cancelFeedbackNotification() . Le recomendamos que coloque showFeedbackNotification() en onCreate() de su actividad principal.

Kotlin+KTX

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        Firebase.appDistribution.showFeedbackNotification(
            // Text providing notice to your testers about collection and
            // processing of their feedback data
            R.string.additionalFormText,
            // The level of interruption for the notification
            InterruptionLevel.HIGH)
    }
}

Java

public class MainActivity extends AppCompatActivity {
    FirebaseAppDistribution firebaseAppDistribution =
        FirebaseAppDistribution.getInstance();
    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        firebaseAppDistribution.showFeedbackNotification(
            // Text providing notice to your testers about collection and
            // processing of their feedback data
            R.string.additionalFormText,
            // The level of interruption for the notification
            InterruptionLevel.HIGH);
    }
}

Nota: En Android 13 y versiones posteriores, este método requiere permiso de tiempo de ejecución para enviar notificaciones : POST_NOTIFICATIONS . Si su aplicación está orientada a Android 13 (nivel de API 33) o superior, debe declarar el permiso y luego solicitarlo en tiempo de ejecución .

Opción 2: disparador personalizado

Utilice el método startFeedback() para iniciar comentarios utilizando un mecanismo de su elección. Por ejemplo, para generar comentarios, es posible que desees agregar un elemento de menú "Enviar comentarios" al menú de acciones de tu aplicación, o dejar que tus evaluadores agiten su dispositivo o tomen una captura de pantalla . Cuando genere comentarios, proporcione un texto que se mostrará al evaluador antes de enviar comentarios. Si desea proporcionar un aviso a sus evaluadores sobre la recopilación y el procesamiento de sus datos de comentarios, puede utilizar este texto para proporcionar dicho aviso.

Kotlin+KTX

Firebase.appDistribution.startFeedback(R.string.feedbackMessage)

Java

FirebaseAppDistribution.getInstance().startFeedback(R.string.feedbackMessage);

Paso 4: cree y pruebe su implementación

Pruebas locales

Para probar su implementación sin tener que distribuir la aplicación primero, siga estos pasos:

1. Habilite el modo de desarrollo en su dispositivo local:

   adb shell setprop debug.firebase.appdistro.devmode true
   

2. Cree su aplicación como una variante de prelanzamiento que incluya las bibliotecas completas de distribución de aplicaciones y pruebe que puede generar comentarios utilizando el mecanismo implementado en el Paso 3: Configurar comentarios en la aplicación . Los comentarios no se envían en modo de desarrollo.

3. Después de la prueba, puede desactivar el modo de desarrollo en su dispositivo:

   adb shell setprop debug.firebase.appdistro.devmode false
   

Pruebas de un extremo a otro

Nota: De forma predeterminada, los nuevos comentarios activan alertas por correo electrónico y en la consola para todos los propietarios y editores del proyecto de Firebase.

Para probar que su aplicación puede enviar comentarios, cree su aplicación como una variante de prelanzamiento que incluya las bibliotecas completas de distribución de aplicaciones y pruebe su implementación siguiendo estos pasos:

1. Cargue una nueva versión de la aplicación en App Distribution.

2. Distribuya la versión de la aplicación a una cuenta a la que tenga permiso para acceder.

3. Descargue la aplicación a través de la aplicación de prueba web o de Android de App Distribution.

4. Active comentarios utilizando el mecanismo implementado en el Paso 3: Configurar comentarios en la aplicación .

5. Asegúrese de haber iniciado sesión con la misma cuenta a la que distribuyó la versión de la aplicación y envíe sus comentarios.

6. Vea sus comentarios en la tarjeta de la nueva versión en Firebase console .

Precaución: antes de lanzar su aplicación a Google Play Store, asegúrese de probarla para verificar que está incluyendo solo la dependencia de biblioteca de API únicamente y que su mecanismo de comentarios no está incluido en su variante de lanzamiento. Para obtener más información, consulte Paso 2: Agregar distribución de aplicaciones a su aplicación .

Para saber cómo resolver problemas comunes, como que los evaluadores no puedan iniciar comentarios en la aplicación, consulte Habilitación de funciones de prueba con el SDK .

Paso 5: gestionar los comentarios de los evaluadores

Después de permitir que sus evaluadores envíen comentarios, puede utilizar las siguientes herramientas para revisar esos comentarios y actuar en consecuencia:

• Consola de base de fuego

• Alertas por correo electrónico para nuevos comentarios

• Herramientas de terceros

Ver y eliminar comentarios en Firebase console

Puedes revisar y eliminar los comentarios de los usuarios, incluidas las capturas de pantalla, abriendo la pestaña Comentarios del probador en una versión específica en Firebase console. Los comentarios de los usuarios están organizados por versión para que pueda confirmar la versión a la que se aplican los comentarios.

Después de revisar los comentarios de los usuarios, puede eliminarlos haciendo clic en el botón Eliminar comentarios . Los comentarios eliminados se eliminan de su versión.

Reciba alertas por correo electrónico para nuevos comentarios

Para conocer de forma proactiva los comentarios de los nuevos testers, puede recibir alertas por correo electrónico cuando un tester envíe comentarios. La alerta por correo electrónico incluye los comentarios escritos que proporcionó el evaluador y un enlace a las capturas de pantalla que envió.

Para recibir alertas por correo electrónico de distribución de aplicaciones a través de este mecanismo predeterminado, debe tener el permiso firebase.projects.update . Los siguientes roles incluyen este permiso requerido de forma predeterminada: Administrador de Firebase o Propietario o Editor del proyecto.

De forma predeterminada, cada miembro del proyecto que tenga los permisos necesarios para recibir alertas por correo electrónico recibirá un correo electrónico cuando se envíe un nuevo informe de comentarios. Los miembros del proyecto pueden optar individualmente por no recibir estas alertas.

Para deshabilitar las alertas por correo electrónico, consulte Recibir alertas de Firebase .

Enviar nuevos comentarios a herramientas de terceros

También puede enviar alertas de distribución de aplicaciones al canal de notificación preferido de su equipo utilizando Cloud Functions para Firebase. Por ejemplo, puede escribir una función que capture un evento de alerta para nuevos comentarios en la aplicación y publique la información de la alerta en un servicio de terceros como Discord, Slack o Jira.

Nota: Para utilizar capacidades de alertas avanzadas, su proyecto de Firebase debe usar el plan de precios Blaze .

Para configurar capacidades de alertas avanzadas usando Cloud Functions para Firebase, siga estos pasos:

1. Configure Cloud Functions para Firebase , que incluye las siguientes tareas:

   1. Descargue Node.js y npm.

   2. Instale e inicie sesión en Firebase CLI.

   3. Inicialice Cloud Functions para Firebase mediante Firebase CLI.

2. Escriba e implemente una función que capture un evento de alerta de comentarios en la aplicación desde App Distribution y maneje la carga útil del evento (por ejemplo, publique la información de la alerta en un mensaje en Discord).

Para ver una función de ejemplo que le muestra cómo enviar nuevos comentarios a Jira, consulte este ejemplo .

Para obtener información sobre todos los eventos de alerta que puede capturar, consulte la documentación de referencia para alertas de distribución de aplicaciones .