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 .
Paso 1: habilite la API del probador de distribución de aplicaciones
Abra la consola de Google Cloud y seleccione su proyecto de Firebase.
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).
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.
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.ktso<project>/<app-module>/build.gradle).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.
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:
Captura una captura de pantalla de la actividad actual de la aplicación.
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.
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);
}
}
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:
Habilite el modo de desarrollo en su dispositivo local:
adb shell setprop debug.firebase.appdistro.devmode true
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.
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
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:
Cargue una nueva versión de la aplicación en App Distribution.
Distribuya la versión de la aplicación a una cuenta a la que tenga permiso para acceder.
Descargue la aplicación a través de la aplicación de prueba web o de Android de App Distribution.
Active comentarios utilizando el mecanismo implementado en el Paso 3: Configurar comentarios en la aplicación .
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.
Vea sus comentarios en la tarjeta de la nueva versión en Firebase console .
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:
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.
Para configurar capacidades de alertas avanzadas usando Cloud Functions para Firebase, siga estos pasos:
Configure Cloud Functions para Firebase , que incluye las siguientes tareas:
Descargue Node.js y npm.
Instale e inicie sesión en Firebase CLI.
Inicialice Cloud Functions para Firebase mediante Firebase CLI.
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 .