SDKs:Register:Android:index

1. CÓMO AGREGAR LA LIBRERÍA REGISTER

INTRODUCCIÓN.

La librería Register registra al usuario de la aplicación en la que va incorporada.

VERSIONES DE ANDROID SOPORTADAS.

Esta librería soporta todas las versiones de Android superiores a la version 4.0 (API level 14 y nombre en código Ice Cream Sandwich).

FUNCIONAMIENTO DE LA LIBRERÍA.

La librería Register actúa solo la primera vez que se llama.

Registra los datos del terminal en función de los permisos concedidos a la aplicación.

INSTALACION DE LA LIBRERIA.

Disponemos de un repositorio maven para que sus librerías puedan ser utilizadas en Android Studio. Para poder usar la librería Register es necesario realizar varios cambios, tanto en el archivo build.gradle como en el AndroidManifest.xml de su aplicación.

Cambios en el archivo build.gradle.

En el apartado repositories deberá añadir:

   repositories {
       mavenCentral()
       maven { url 'https://maven.mobeleader.com' }
   }

La librería Register utiliza la librería auxiliar UtilsLib. Por tanto, para utilizar la librería Register en su aplicación, en el apartado dependencies deberá añadir:

   //noinspection GradleDynamicVersion
   compile 'com.mobeleader.utils:UtilsLib:+'
   //noinspection GradleDynamicVersion
   compile 'com.mobeleader.register:RegisterLib:+'

Cambios en el archivo AndroidManifest.xml.

Es necesario añadir el siguiente permiso para poder registrar el usuario:

   <uses-permission android:name="android.permission.INTERNET" />

Con este permiso se registrarán los datos básicos y anónimos del usuario. El resto de datos se obtendrán en función de los permisos opcionales añadidos:

   <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
   <uses-permission android:name="android.permission.GET_ACCOUNTS" />
   <uses-permission android:name="android.permission.READ_PROFILE" />
   <uses-permission android:name="android.permission.READ_CONTACTS" />
   <uses-permission android:name="android.permission.READ_PHONE_STATE" />
   <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
   <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

Cambios en el Proguard.

En caso de que esté utilizando el Proguard (variable minifyEnabled a TRUE en el build.gradle), será necesario añadir en el fichero del Proguard utilizado (proguard-rules.pro por defecto) la siguiente regla:

   -keep class com.mobeleader. {*;}

LANZAMIENTO DE LA LIBRERIA.

Lo primero que debe hacer es elegir el Activity (o Fragment) desde el que quiera realizar el registro. Recuerde que el registro sólo se realizará una vez. Importe el paquete com.mobeleader.sps:

   import com.mobeleader.register.*;

Una vez importado el paquete, se procederá al lanzamiento de la librería. Para ello deberá obtener previamente el código hash de su aplicación, generado al registrarla en nuestro panel. Lo puede obtener a través del panel en la sección Mis Aplicaciones, pulsando el icono de la columna "Hash" de su aplicación.

Lanzamiento básico.

Si sólo desea registrar el usuario añada el siguiente código:

   RegisterLib registerLib = new RegisterLib(this);
   registerLib.register("app_hash");

En el campo "app_hash" añada el código hash obtenido previamente en el panel.

Lanzamiento con listener.

Si además de registrar el usuario, desea saber si el proceso se ha realizado correctamente, o necesita saber el momento exacto en el que se ha realizado el registro, puede utilizar el listener de la librería. Implemente el listener en el Activity o Fragment seleccionado:

   public class MyActivity implements RegisterLibListener

Implemente a continuación los métodos requeridos onError y registerFinish. El método onError se ejecutará en caso de haberse producido un error durante la ejecución del registro. El método registerFinish indicará que el registro se ha realizado correctamente.

Para lanzar la librería añada el siguiente código:

   RegisterLib registerLib = new RegisterLib(this);

registerLib.setRegisterLibListener(this);

   registerLib.register("app_hash");

A continuación complete como desee los listeners:

   @Override
   public void onError(String error) {
       // TODO complete listener
   }

   @Override
   public void registerFinish() {
       // TODO complete listener
   }