Ir a la consola

Explicación de la app de muestra de Firebase Remote Config para iOS

En esta guía, se explican los pasos que debes seguir para integrar Remote Config a tu app de iOS. Para obtener más información sobre la API de Remote Config para iOS, consulta FIRRemoteConfig.

Requisitos

Configura tu proyecto según las instrucciones que se proporcionan en cómo agregar Firebase a tu proyecto iOS.

Instala la biblioteca de cliente

  1. Agrega la siguiente dependencia a tu Podfile:

    pod 'Firebase/RemoteConfig'
    

  2. Guarda el archivo y ejecuta lo siguiente:

    pod install
    

Esto crea un archivo .xcworkspace para tu aplicación. Úsalo para todas las implementaciones futuras de tu aplicación.

Crea un proyecto de Remote Config para la guía de inicio rápido de muestra

La guía de inicio rápido de muestra proporciona un ejemplo del uso de Remote Config para definir el mensaje de bienvenida de la app de muestra. Antes de ejecutar la guía, debes configurar un proyecto de Remote Config.

En Firebase console, haz clic en Crear proyecto nuevo y, luego, sigue las instrucciones para configurar un proyecto de Firebase Remote Config con los siguientes parámetros:

Clave de parámetro Valor predeterminado Notas:
welcome_message Welcome to this sample app Cámbialo si deseas usar un mensaje de bienvenida diferente.
welcome_message_caps false Asígnale el valor true para que el mensaje de bienvenida se muestre en mayúsculas.

Después de configurar tu proyecto, ejecuta la guía de inicio rápido de muestra para ver el mensaje de bienvenida que definiste en Firebase console. Puedes cambiar los valores de estos parámetros en el proyecto y luego presionar Obtener Remote Config en la guía para ver cómo Remote Config te permite actualizar una app.

Compila y ejecuta la guía de inicio rápido de muestra

  1. Descarga el código de la guía de inicio rápido de muestra y descomprímelo.

  2. Abre una ventana de la terminal y navega a la ubicación del proyecto de muestra. Ejecuta pod install y luego abre el archivo .xcworkspace.

  3. Compila y ejecuta la muestra.

Cómo funciona

Primero, la muestra obtiene una instancia de objeto de Remote Config y configura el intervalo de recuperación mínimo, que permite realizar actualizaciones frecuentes:

Swift

Objective-C

Luego, la muestra establece valores predeterminados dentro de la app a partir de un archivo plist:

Swift

Objective-C

Ahora la muestra crea una solicitud fetchAndActivateWithCompletionHandler: a fin de recuperar valores desde el backend de Remote Config y hacer que estén disponibles para la app:

Swift

Objective-C

Ahora que se actualizó el mensaje de bienvenida, puedes mostrar el mensaje de bienvenida actualizado en la app.

Swift

Objective-C

Puedes acceder a tus parámetros de Remote Config mediante una de las propiedades stringValue, numberValue, dataValue o boolValue, o mediante los métodos configValueForKey:.

Regulación

Si una app realiza recuperaciones muchas veces en poco tiempo, es posible que se regulen las llamadas de recuperación. En estos casos, el backend muestra FIRRemoteConfigFetchStatusThrottled. Te recomendamos detectar este error y volver a intentarlo en el modo de retirada exponencial, esperando intervalos más largos entre las solicitudes de recuperación posteriores.

Durante el desarrollo de la app, te recomendamos actualizar la caché con mucha frecuencia (varias veces por hora) para que puedas iterar mientras desarrollas y pruebas tu app. Para permitir iteraciones rápidas en un proyecto que cuenta con un máximo de 10 desarrolladores, puedes agregar temporalmente una propiedad FIRRemoteConfigSettings con un intervalo de recuperación mínimo bajo (MinimumFetchInterval) en la 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 las configuraciones 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 FIRRemoteConfigSettings.MinimumFetchInterval
  3. El valor predeterminado de 12 horas