Android Get started

En este artículo tienes las instrucciones paso a paso para añadir Connectif Mobile SDK a tu proyecto Android. Este comienzo de la integración de tu App Móvil con Connectif, una vez hayas revisado que cumples los requisitos previos para poder realizarla.

  

Para realizar esta integración, necesitarás de un experto con conocimientos de programación.

 

1. Requisitos para poder añadir Connectif Mobile SDK a tu proyecto Android

  • Necesitaremos tener activada nuestra integración App Mobil en Connectif para tener acceso en la configuración de la integración a nuestra key. Puede consultar nuestra guía de implementación.
  • Desarrollado como librería de Android.
     
  • Versión mínima soportada Android 5.0 (Level 21).
  • Implementado en la app Firebase Cloud Messaging para la recepción de notificaciones push.

 

2. Cómo añadir Connectif Mobile SDK a tu proyecto Android

2.1. Añadir el SDK

Añade la dependencia del SDK a tu fichero build.gradle (Module: app).

Kotlin

implementation("ai.connectif:sdk:1.0.1")

Groovy

implementation 'ai.connectif:sdk:1.0.1'


Haz clic sobre la opción Sync Now de la toolbar superior, para hacer que se sincronice el fichero de gradle.

 

2.2. Iniciar el SDK de Connectif

El mejor lugar para iniciar nuestro SDK será en el callback onCreate de la Application Class

De forma opcional, para obtener el email de usuarios que se registraron o iniciaron sesión antes de implementar el Mobile SDK de Connectif, enviaremos el email del usuario al iniciar el SDK. El email deberá cumplir estos requisitos:

  • Un correo válido debe tener un nombre de usuario, seguido por @, un dominio y una extensión, sin espacios ni caracteres especiales.
  • Un máximo de 200 caracteres.

Ejemplo del email: 

class SampleApp : Application() {
override fun onCreate() {
super.onCreate()
Connectif.init(
context = applicationContext,
apiKey = "YOUR_API_KEY",
"usermail@example.com"
)
}
}

 

3. Configuraciones adicionales

Recuerda que al iniciar el SDK podrá definir algunos valores usando el parámetro ConnectifConfig en Connectif.initialize().

3. 1. Icono 

Por defecto este es icono asignado a nuestras notificaciones push:

ic_default_notification default_push_icon.png 

Si lo deseas, podrás personalizando indicando el recurso en la propiedad pushSmallIcon de ConnectifConfig al iniciar el SDK, recuerda que para que se visualice correctamente debe contener únicamente color blanco y transparencias.

3.2. Canal de notificaciones

Desde Android 8 es obligatorio crear un canal para poder mostrar las notificaciones, por defecto asignaremos a las notificaciones mostradas por Connectif el nombre de canal "Default Channel" y "connectif_channel" como identificador de canal.

Podrás indicarnos tu nombre y canal personalizado usando las propiedades pushChannelName y pushChannelId de ConnectifConfig al iniciar el SDK.

3.3. Log

Puedes definir el logLevel, es decir, el nivel de logs que querremos mostrar (default: LogLevel.NONE). Cada nivel mantiene los logs del nivel anterior, por lo que el nivel INFO mostrará todos los logs.

  • NONE: Desactiva todos los registros.
  • ERROR: Solo se registran errores.
  • WARN: Se registran advertencias y errores.
  • INFO: Se registran mensajes de información, advertencias y errores.

 

4. Implementar el tracking de los usuarios

Una vez tengas configurada la inicialización podrás comenzar con el tracking del usuario, a través de la implementación de las diferentes notificaciones.

 

 

¡Enhorabuena!
Has llegado al final de la lección.

  

¿Te han quedado dudas sin resolver?
Recuerda que tienes a tu disposición a nuestros especialistas en Connectif. Para contactar con ellos, tan solo tendrás que abrir ticket a Soporte haciendo clic en el botón azul de “Ayuda” de tu dashboard.


¡Sigue aprendiendo!

Para aprovechar todo el potencial de tu cuenta en Connectif, te recomendamos continuar con los siguientes artículos:

¿Fue útil este artículo?
Usuarios a los que les pareció útil: 0 de 0