Servicio Live Update

Visión general

La característica Live Update en Mobile Foundation proporciona una forma simple de definir y ofrecer distintas configuraciones para los usuarios de una aplicación. Incluye un componente en la MobileFirst Operations Console para definir la estructura de la configuración así como los valores de la configuración. Se proporciona un SDK de cliente (disponible para aplicaciones Android e iOS nativas para Cordova) para consumir la configuración.

Nota: Para obtener detalles sobre cómo utilizar Live Update con un MobileFirst Server tradicional local, consulte la documentación aquí.

Casos de uso comunes

Live Update da soporte a la definición y utilización de configuraciones, lo que facilita las personalizaciones basadas en segmentos para la aplicación. El siguiente es un ejemplo de casos de uso comunes:

• Trenes de releases y cambios de características

En los releases futuros se dará soporte a los casos de uso siguientes.

• Realización de pruebas A/B
• Personalización basada en el contexto de la aplicación (por ejemplo, segmentación geográfica)

Ir a:

• Concepto
• Arquitectura de Live Update
• Adición de Live Update a MobileFirst Server
• Configuración de la seguridad de las aplicaciones
• Adición de Live Update SDK a aplicaciones
• Utilización de Live Update SDK
• Temas avanzados

Concepto

El servicio Live Update añade las funciones siguientes a cada aplicación.

1. Características: Utilizando las características puede definir características de aplicación configurables y establecer sus valores predeterminados.
2. Propiedades: Utilizando las propiedades puede definir las propiedades de las aplicaciones configurables y establecer sus valores predeterminados.

El desarrollador o el equipo de gestión de aplicaciones debe tomar decisiones sobre lo siguiente.

• El conjunto de características y su estado predeterminado donde se puede utilizar Live Update.
• El conjunto de propiedades de series configurables y sus valores predeterminados.

Cuando haya decidido los parámetros, añada las características y propiedades a la aplicación utilizando la sección Live Update.

Arquitectura de Live Update

Los siguientes componentes de sistema funcionan de forma conjunta con el propósito de proporcionar la funcionalidad de Live Update.

• Servicio Live Update: Un servicio independiente que proporciona:
  • Gestión de aplicaciones
  • Aprovisionamiento de configuraciones a las aplicaciones
• SDK del lado de cliente: Live Update SDK sirve para recuperar y acceder a elementos de configuración como, por ejemplo, las propiedades y características desde MobileFirst Server.
• MobileFirst Operations Console: Se utiliza para configurar los valores y el adaptador de Live Update.

Adición de Live Update a MobileFirst Server

De forma predeterminada, el servicio Live Update está empaquetado en Mobile Foundation DevKit.

Para la instalación de OCP (OpenShift Container Platform) consulte la documentación aquí.

Cuando está activado el servicio Live Update, se muestra la página Valores de Live Update para cada aplicación registrada.

Configuración de la seguridad de las aplicaciones

Con el propósito de permitir la integración con Live Update, se necesita un elemento de ámbito. Sin el elemento de ámbito, el servicio rechazará las solicitudes de las aplicaciones de cliente.

1. Cargue MobileFirst Operations Console.
2. Pulse [su aplicación] → Separador Seguridad → Correlación de elementos de ámbito.
3. Pulse Nuevo y especifique el elemento de ámbito liveupdate.mobileclient.
4. Pulse Añadir.

También puede correlacionar el elemento de ámbito con una comprobación de seguridad en el caso de que utilice una en su aplicación.

Aprenda más sobre la infraestructura de seguridad de MobileFirst

Definir características y propiedades con valores

Vea la demostración siguiente para definir características y propiedades con valores.

Adición de Live Update SDK a las aplicaciones

Live Update SDK proporciona a los desarrolladores una API para consultar propiedades y características de configuración de tiempo de ejecución de consulta que con anterioridad estaban definidas en la pantalla de Valores de Live Update de la aplicación registrada en MobileFirst Operations Console.

Para Cordova, utilice la versión del SDK 8.0.202003051505 o anterior.

• Documentación del plugin de Cordova

Para Android, utilice la versión de SDK 8.0.202003051505.

• Documentación de Android SDK

Para iOS, utilice la versión de SDK 8.0.202003051505 o anterior.

• Documentación de iOS Swift SDK

Adición del plugin de Cordova

En la carpeta de la aplicación Cordova, ejecute el mandato siguiente.

cordova plugin add cordova-plugin-mfp-liveupdate

Adición de iOS SDK

1. Edite el podfile de la aplicación añadiendo el pod IBMMobileFirstPlatformFoundationLiveUpdate.
   Por ejemplo:

   use_frameworks!
   
   target 'your-Xcode-project-target' do
      pod 'IBMMobileFirstPlatformFoundation'
      pod 'IBMMobileFirstPlatformFoundationLiveUpdate'
   end
   

2. En la ventana de línea de mandatos, vaya a la carpeta raíz del proyecto XCode y ejecute el mandato siguiente.

     pod install
   

Adición de Android SDK

1. En Android Studio, seleccione Android → Scripts de Gradle y, a continuación, seleccione el archivo build.gradle (Módulo: app).

2. Añada ibmmobilefirstplatformfoundationliveupdate dentro de dependencies:

   dependencies {
        compile group: 'com.ibm.mobile.foundation',
        name: 'ibmmobilefirstplatformfoundation',
        version: '8.0.+',
        ext: 'aar',
        transitive: true
   
        compile group: 'com.ibm.mobile.foundation',
        name: 'ibmmobilefirstplatformfoundationliveupdate',
        version: '8.0.0',
        ext: 'aar',
        transitive: true
   }   
   

Utilización de Live Update SDK

Existen varias maneras de utilizar Live Update SDK.

Obtenga la configuración

Lógica de implementación para recuperar una configuración.
Sustituya property-name y feature-name por sus propios valores.

Cordova

    var input = { };
    LiveUpdateManager.obtainConfiguration({useClientCache :false },function(configuration) {
        // do something with configration (JSON) object, for example,
        // if you defined in the server a feature named 'feature-name':
        // if (configuration.features.feature-name) {
        //   console.log(configuration.properties.property-name);
	// }
    } ,
    function(err) {
        if (err) {
           alert('liveupdate error:'+err);
        }
  });

iOS

LiveUpdateManager.sharedInstance.obtainConfiguration(completionHandler: { (configuration, error) in
  if error == nil {
    print (configuration?.getProperty("property-name"))
    print (configuration?.isFeatureEnabled("feature-name"))
  } else {
    print (error)
  }
})

Android

LiveUpdateManager.getInstance().obtainConfiguration(new ConfigurationListener() {

    @Override
    public void onSuccess(final Configuration configuration) {
        Log.i("LiveUpdateDemo", configuration.getProperty("property-name"));
        Log.i("LiveUpdateDemo", configuration.isFeatureEnabled("feature-name").toString());
    }

    @Override
    public void onFailure(WLFailResponse wlFailResponse) {
        Log.e("LiveUpdateDemo", wlFailResponse.getErrorMsg());
    }
});

Con la configuración de Live Update recuperada, la lógica de la aplicación y el flujo de la aplicación se basará en el estado de las características y propiedades. Por ejemplo, si hoy es una fiesta nacional, se presentará una nueva promoción de marketing en la aplicación.

Temas avanzados

Colocación en caché

De forma predeterminada está habilitada la colocación en caché para evitar la latencia de red. Esto significa que es posible que las actualizaciones no se realicen de forma inmediata.
La colocación en caché se puede inhabilitar si se necesitan actualizaciones más frecuentes.

Cordova

Controle la caché del lado del cliente utilizando el distintivo booleano useClientCache opcional:

var input = {useClientCache : false };
      LiveUpdateManager.getConfiguration(input,function(configuration) {
              // do something with resulting configuration, for example:
                // console.log(configuration.data.properties.property-name);  
                // console.log(configuration.data.features.feature-name);
        } ,
        function(err) {
                if (err) {
                   alert('liveupdate error:'+err);
                }
  });

iOS

LiveUpdateManager.sharedInstance.obtainConfiguration(useCache: false, completionHandler: { (configuration, error) in
  if error == nil {
    print (configuration?.getProperty("property-name"))
    print (configuration?.isFeatureEnabled("feature-name"))
  } else {
    print (error)
  }
})

Android

LiveUpdateManager.getInstance().obtainConfiguration(false, new ConfigurationListener() {

    @Override
    public void onSuccess(final Configuration configuration) {
      Log.i("LiveUpdateSample", configuration.getProperty("property-name"));
      Log.i("LiveUpdateSample", configuration.isFeatureEnabled("feature-name").toString());
    }

    @Override
    public void onFailure(WLFailResponse wlFailResponse) {
        Log.e("LiveUpdateSample", wlFailResponse.getErrorMsg());
    }
});

Caducidad de caché

El valor expirationPeriod es de 30 minutos, que es el periodo de tiempo hasta que caduca la memoria caché.