Comienza a usar Firebase Remote Config

iOS+ Android Web Flutter Unity C++

Importante: En esta sección, se describen los pasos para configurar Remote Config con clientes web y de dispositivos móviles. Para entornos de servidor, consulta Usa Remote Config en entornos de servidor.

Puedes usar Firebase Remote Config para definir los parámetros en tu app y actualizar sus valores en la nube, lo que te permite modificar el aspecto y el comportamiento de la app sin distribuir una actualización de la app. En esta guía, se explican los pasos que debes seguir para comenzar y se proporcionan códigos de muestra que puedes clonar o descargar desde el repositorio firebase/quickstart-android de GitHub.

Paso 1: Agrega Firebase y el SDK de Remote Config a tu app

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

2. En el caso de Remote Config, se requiere Google Analytics para la segmentación condicional de las instancias de apps a las propiedades del usuario y los públicos. Asegúrate de habilitar Google Analytics en tu proyecto.

3. En el archivo Gradle del módulo (nivel de la app) (generalmente <project>/<app-module>/build.gradle.kts o <project>/<app-module>/build.gradle), agrega la dependencia de la biblioteca de Remote Config para Android. Te recomendamos usar Firebase Android BoM para controlar las versiones de las bibliotecas.

   Además, como parte de la configuración de Analytics, debes agregar el SDK de Firebase de Google Analytics a tu app.

   dependencies {
       // Import the BoM for the Firebase platform
       implementation(platform("com.google.firebase:firebase-bom:33.6.0"))
   
       // Add the dependencies for the Remote Config and Analytics libraries
       // When using the BoM, you don't specify versions in Firebase library dependencies
       implementation("com.google.firebase:firebase-config")
       implementation("com.google.firebase:firebase-analytics")
   }

   Cuando usas Firebase Android BoM, tu app siempre usará versiones compatibles de las bibliotecas de Firebase para Android.

   (Alternativa)  Agrega dependencias de la biblioteca de Firebase sin usar la BoM

   Si eliges no usar la Firebase BoM, debes especificar cada versión de la biblioteca de Firebase en su línea de dependencia.

   Ten en cuenta que, si usas múltiples bibliotecas de Firebase en tu app, es muy recomendable que uses la BoM para administrar las versiones de las bibliotecas para garantizar que todas las versiones sean compatibles.

   dependencies {
       // Add the dependencies for the Remote Config and Analytics libraries
       // When NOT using the BoM, you must specify versions in Firebase library dependencies
       implementation("com.google.firebase:firebase-config:22.0.1")
       implementation("com.google.firebase:firebase-analytics:22.1.2")
   }

   ¿Buscas un módulo de biblioteca específico de Kotlin? A partir de octubre de 2023 (Firebase BoM 32.5.0), tanto los desarrolladores de Kotlin como los de Java pueden depender del módulo de la biblioteca principal (para obtener más información, consulta las Preguntas frecuentes sobre esta iniciativa).

Nota: Dado que el SDK de Android depende de la API de REST de Remote Config, esta viene habilitada de forma predeterminada en los proyectos típicos. Asegúrate de no inhabilitarla.

Paso 2: Obtén el objeto singleton de Remote Config

Obtén una instancia de objeto de Remote Config y establece el intervalo de recuperación mínimo para permitir actualizaciones frecuentes:

Kotlin+KTX

val remoteConfig: FirebaseRemoteConfig = Firebase.remoteConfig
val configSettings = remoteConfigSettings {
    minimumFetchIntervalInSeconds = 3600
}
remoteConfig.setConfigSettingsAsync(configSettings)
MainActivity.kt

Java

FirebaseRemoteConfig mFirebaseRemoteConfig = FirebaseRemoteConfig.getInstance();
FirebaseRemoteConfigSettings configSettings = new FirebaseRemoteConfigSettings.Builder()
        .setMinimumFetchIntervalInSeconds(3600)
        .build();
mFirebaseRemoteConfig.setConfigSettingsAsync(configSettings);
MainActivity.java

El objeto singleton se usa para almacenar los valores de parámetros predeterminados en la app, recuperar los valores de parámetros actualizados desde el backend y controlar cuándo estos valores estarán disponibles para la app.

Durante el desarrollo, se recomienda establecer un intervalo de recuperación mínimo relativamente bajo. Consulta la sección Regulación para obtener más detalles.

Paso 3: Configura los valores de parámetros predeterminados en la app

Puedes configurar los valores de los parámetros predeterminados en la app en el objeto de Remote Config, de modo que la app se comporte según lo previsto antes de conectarse al backend de Remote Config y para que los valores predeterminados estén disponibles si no hay ninguno configurado en el backend.

Importante: No almacenes datos confidenciales en las claves ni en los valores de parámetros de Remote Config. Los datos de Remote Config se encriptan en tránsito, pero los usuarios finales pueden acceder a cualquier parámetro predeterminado o recuperado de Remote Config que esté disponible para su instancia de app cliente.

1. Define un conjunto de nombres de parámetros y valores de parámetros predeterminados con un objeto Map o un archivo de recursos XML almacenado en la carpeta res/xml de tu app. La app de ejemplo de la guía de inicio rápido de Remote Config usa un archivo XML para definir los valores y nombres de los parámetros predeterminados.

   Si ya configuraste los valores de los parámetros de backend de Remote Config, puedes descargar un archivo en formato XML generado que incluya todos los valores predeterminados y guardarlo en el directorio res/xml de la app:

   REST

   curl --compressed -D headers -H "Authorization: Bearer token" -X GET https://firebaseremoteconfig.googleapis.com/v1/projects/my-project-id/remoteConfig:downloadDefaults?format=XML -o remote_config_defaults.xml
   

   Consola de Firebase

   1. En la pestaña Parámetros, abre el Menú y selecciona Descargar valores predeterminados.

   2. Cuando se solicite, habilita .xml para Android y haz clic en Descargar archivo.

2. Agrega estos valores al objeto de Remote Config con setDefaultsAsync(int), como se muestra a continuación:

   Kotlin+KTX

   remoteConfig.setDefaultsAsync(R.xml.remote_config_defaults)

   Java

   mFirebaseRemoteConfig.setDefaultsAsync(R.xml.remote_config_defaults);

Paso 4: Obtén los valores de los parámetros para usarlos en tu app

Ahora puedes obtener los valores de los parámetros desde el objeto de Remote Config. Si configuras valores en el backend, los recuperas y, luego, los activas, estos valores estarán disponibles para la app. De lo contrario, obtendrás los valores de los parámetros configurados en la app con setDefaultsAsync(int). Para obtener estos valores, llama al método siguiente, que aplica asignaciones al tipo de datos que espera la app y proporciona la clave de parámetro como un argumento:

• getBoolean()
• getDouble()
• getLong()
• getString()

Paso 5: Configura los valores de los parámetros en el backend de Remote Config

Con Firebase console o las APIs de backend de Remote Config, puedes crear nuevos valores predeterminados del servidor que anulen los valores de la app según la lógica condicional o la segmentación de usuarios que desees. En esta sección, se describen los pasos que se deben seguir en Firebase console para crear los valores.

1. En Firebase console, abre tu proyecto.
2. Selecciona Remote Config en el menú para ver el panel de Remote Config.
3. Define parámetros que tengan los mismos nombres que los que definiste en tu app. Para cada parámetro, puedes definir un valor predeterminado (que, en última instancia, anulará el valor predeterminado de la app) y valores condicionales. Para obtener más información, consulta Parámetros y condiciones de Remote Config.

Paso 6: Recupera y activa valores

1. Para recuperar valores de los parámetros del backend de Remote Config, llama al método fetch(). Todos los valores que establezcas en el backend se recuperan y almacenan en el objeto de Remote Config.

2. Para que los valores de parámetros recuperados estén disponibles en la app, llama al método activate().

   Para los casos en los que desees recuperar y activar valores en una sola llamada, puedes usar una solicitud fetchAndActivate() y recuperar valores desde el backend de Remote Config y hacer que estén disponibles para la app de la siguiente manera:

   Kotlin+KTX

   remoteConfig.fetchAndActivate()
       .addOnCompleteListener(this) { task ->
           if (task.isSuccessful) {
               val updated = task.result
               Log.d(TAG, "Config params updated: $updated")
               Toast.makeText(
                   this,
                   "Fetch and activate succeeded",
                   Toast.LENGTH_SHORT,
               ).show()
           } else {
               Toast.makeText(
                   this,
                   "Fetch failed",
                   Toast.LENGTH_SHORT,
               ).show()
           }
           displayWelcomeMessage()
       }

   Java

   mFirebaseRemoteConfig.fetchAndActivate()
           .addOnCompleteListener(this, new OnCompleteListener<Boolean>() {
               @Override
               public void onComplete(@NonNull Task<Boolean> task) {
                   if (task.isSuccessful()) {
                       boolean updated = task.getResult();
                       Log.d(TAG, "Config params updated: " + updated);
                       Toast.makeText(MainActivity.this, "Fetch and activate succeeded",
                               Toast.LENGTH_SHORT).show();
   
                   } else {
                       Toast.makeText(MainActivity.this, "Fetch failed",
                               Toast.LENGTH_SHORT).show();
                   }
                   displayWelcomeMessage();
               }
           });

Dado que estos valores de parámetros actualizados influyen en el comportamiento y el aspecto de la app, debes activar los valores recuperados en un momento en el que se garantice una experiencia fluida para el usuario, como la próxima vez que abra la app. Consulta las estrategias de carga de Remote Config para obtener más información y ejemplos.

Nota: Si la app no se compila con Gradle, debes agregar manualmente el recurso de cadenas google_app_id correcto a tu app para que Remote Config pueda inicializarse. En general, el complemento para Gradle google-services lo agrega automáticamente, pero puedes encontrar el valor correspondiente en el archivo google-services.json que descargaste de Firebase console. Si quieres más información para obtener el valor google_app_id a partir del archivo google-services.json, consulta Procesa el archivo JSON.

Paso 7: Escucha actualizaciones en tiempo real

Después de recuperar los valores de los parámetros, puedes usar Remote Config en tiempo real para escuchar actualizaciones del backend de Remote Config. Remote Config en tiempo real envía señales a los dispositivos conectados cuando hay actualizaciones disponibles y recupera automáticamente los cambios después de que publicas una nueva versión de Remote Config.

Las actualizaciones en tiempo real son compatibles con la versión 21.3.0 (y versiones posteriores) del SDK de Firebase para Android (Firebase BoM v31.2.4 y versiones posteriores).

Importante: Remote Config en tiempo real también requiere la API en tiempo real para Firebase Remote Config, que ya debería estar habilitada. Para verificar, abre Google Cloud console, selecciona tu proyecto y abre la página APIs y servicios. La API debería aparecer como habilitada. Si falta o no está habilitada, haz clic en Habilitar APIs y servicios, busca la API en tiempo real para Firebase Remote Config y habilítala.

1. En tu app, usa addOnConfigUpdateListener() para comenzar a detectar actualizaciones y recuperar automáticamente los valores de parámetros nuevos. Implementa la devolución de llamada onUpdate() para activar la configuración actualizada.

   Kotlin+KTX

   remoteConfig.addOnConfigUpdateListener(object : ConfigUpdateListener {
       override fun onUpdate(configUpdate : ConfigUpdate) {
          Log.d(TAG, "Updated keys: " + configUpdate.updatedKeys);
   
          if (configUpdate.updatedKeys.contains("welcome_message")) {
              remoteConfig.activate().addOnCompleteListener {
                  displayWelcomeMessage()
              }
          }
       }
   
       override fun onError(error : FirebaseRemoteConfigException) {
           Log.w(TAG, "Config update error with code: " + error.code, error)
       }
   })

   Java

   mFirebaseRemoteConfig.addOnConfigUpdateListener(new ConfigUpdateListener() {
       @Override
       public void onUpdate(ConfigUpdate configUpdate) {
           Log.d(TAG, "Updated keys: " + configUpdate.getUpdatedKeys());
           mFirebaseRemoteConfig.activate().addOnCompleteListener(new OnCompleteListener<Boolean>() {
               @Override
               public void onComplete(@NonNull Task<Boolean> task) {
                   displayWelcomeMessage();
               }
           });
       }
       @Override
       public void onError(FirebaseRemoteConfigException error) {
           Log.w(TAG, "Config update error with code: " + error.getCode(), error);
       }
   });

2. La próxima vez que publiques una versión nueva de Remote Config, los dispositivos que ejecutan tu app y detectan cambios llamarán a ConfigUpdateListener.

Regulación

Si una app realiza recuperaciones muchas veces en poco tiempo, se regulan las llamadas de recuperación y el SDK muestra el estado FirebaseRemoteConfigFetchThrottledException. Antes de la versión 17.0.0 del SDK, el límite eran 5 solicitudes de recuperación en un período de 60 minutos (las versiones más recientes tienen límites más permisivos).

Sugerencia: A partir de la versión 21.3.0 o posterior del SDK de Android (versión 31.3.0 o posterior de Firebase BoM), puedes usar Remote Config en tiempo real para recuperar automáticamente los valores de los parámetros actualizados del backend de Remote Config apenas se publiquen y así evitar la configuración de intervalos de recuperación mínimos. Para obtener más información, consulta Escucha actualizaciones en tiempo real.

Durante el desarrollo de la app, te recomendamos recuperar y activar los parámetros de configuración con mucha frecuencia (varias veces por hora) para que puedas iterar con rapidez mientras desarrollas y pruebas tu app. Las actualizaciones de Remote Config en tiempo real omiten la caché automáticamente cuando se actualiza la configuración en el servidor. Para permitir iteraciones rápidas en un proyecto con un máximo de 10 desarrolladores, puedes configurar de manera temporal un objeto FirebaseRemoteConfigSettings con un intervalo de recuperación mínimo (setMinimumFetchIntervalInSeconds) en tu app.

Según la configuración predeterminada, el intervalo de recuperación mínimo de Remote Config es de 12 horas, lo que significa que los parámetros de configuración se recuperarán desde el backend solo una vez cada 12 horas, sin importar cuántas llamadas se realicen. Específicamente, el intervalo de recuperación mínimo se determina en el siguiente orden:

1. El parámetro de fetch(long)
2. El parámetro de FirebaseRemoteConfigSettings.setMinimumFetchIntervalInSeconds(long)
3. El valor predeterminado de 12 horas

Para establecer un valor personalizado en el intervalo de recuperación mínimo, usa FirebaseRemoteConfigSettings.Builder.setMinimumFetchIntervalInSeconds(long).

Ten en cuenta que esta configuración solo debería usarse durante el desarrollo y no en las apps en producción. Si solo pruebas tu app con un equipo de desarrollo pequeño de 10 personas, es poco probable que alcances los límites de cuota por hora del servicio. Sin embargo, si enviaste tu app a miles de usuarios de prueba con un intervalo de recuperación muy bajo, es probable que tu app alcance esta cuota.

Próximos pasos

Si aún no lo has hecho, explora los casos de uso de Remote Config y revisa algunos de los conceptos clave y la documentación de estrategias avanzadas, en las que se incluye lo siguiente:

• Administra las versiones de plantillas de Remote Config
• Estrategias de carga de Config