Android: Personalizaciones

En esta página profundizaremos en varios aspectos de nuestra biblioteca de Android que pueden personalizarse para adaptarse a tus necesidades.

Configuración de claves en el código

En lugar de depender del archivo de configuración notificare-services.json, que es el archivo que obtuviste en tu TransferBox, es posible establecer estas claves directamente en el código. Si estás utilizando el plugin Gradle re.notifica.gradle.notificare-services, elimínalo ya que requiere que el archivo de configuración esté presente. Además, añade los siguientes metadatos en tu archivo AndroidManifest.xml.

<meta-data
    android:name="re.notifica.auto_configuration_enabled"
    android:value="false" />

Para configurar Push, debes ejecutar el siguiente código antes de cualquier otra interacción con la biblioteca.

class MainApplication : Application() {

    override fun onCreate() {
        super.onCreate()

        Notificare.configure(
            context = applicationContext,
            applicationKey = "",
            applicationSecret = "",
        )

        // more code ...
    }
}

El método configure() debe ser llamado antes de invocar Notificare.launch() para asegurar que se utilicen las claves correctas. Después de establecer las claves programáticamente, puedes eliminar de forma segura el archivo notificare-services.json.

Canales de notificación

A partir de Android 8 (también conocido como Oreo), para que tu aplicación pueda mostrar notificaciones, necesitas crear canales. Sin un canal, las notificaciones no aparecerán en el administrador de notificaciones. Por defecto, creamos un solo canal.

Cada notificación aparecerá en el canal predeterminado "Push Notifications". Puedes cambiar el nombre y la descripción del canal predeterminado agregando estos valores en tu archivo app/res/strings.xml:

<string name="notificare_default_channel_name">Push Notifications</string>
<string name="notificare_default_channel_description">This channel shows push notifications</string>

También puedes crear canales personalizados en tu aplicación. Si deseas que un canal creado por tu app sea el canal predeterminado, añade la siguiente etiqueta de metadatos en tu archivo AndroidManifest.xml:

<meta-data
    android:name="re.notifica.push.default_channel_id"
    android:value="my_custom_channel_id" />

Si deseas evitar que Notificare cree el canal predeterminado automáticamente, puedes añadir la siguiente etiqueta de metadatos en tu archivo AndroidManifest.xml.

<meta-data
    android:name="re.notifica.push.automatic_default_channel_enabled"
    android:value="false" />

Configuración del LED de notificaciones

Puedes establecer un color predeterminado y el tiempo de parpadeo para tu aplicación. Si no se configuran, se usará por defecto un parpadeo blanco durante 500 ms encendido y 1500 ms apagado.

<meta-data
    android:name="re.notifica.push.notification_lights_color"
    android:value="red" />

<meta-data
    android:name="re.notifica.push.notification_lights_on"
    android:value="1000" />

<meta-data
    android:name="re.notifica.push.notification_lights_off"
    android:value="2000" />

Configuración del ícono de notificación

Usaremos el ícono de la aplicación como ícono para las notificaciones. Puedes cambiar este comportamiento especificando lo siguiente en tu archivo AndroidManifest.xml.

<meta-data
    android:name="re.notifica.push.notification_small_icon"
    android:resource="@drawable/ic_rocket_black_24dp" />

<meta-data
    android:name="re.notifica.push.notification_accent_color"
    android:resource="@color/notificare_blue" />

Desactivar la cancelación automática de notificaciones

Cuando el usuario interactúa con una notificación, la eliminamos automáticamente del Centro de Notificaciones. Si deseas desactivar este comportamiento, puedes establecer la propiedad auto-cancel.

<meta-data
    android:name="re.notifica.push.notification_auto_cancel"
    android:value="false" />

Aumentar el límite de regiones monitorizadas

Cuando las actualizaciones de ubicación están habilitadas y se han otorgado los permisos correspondientes, nuestra biblioteca monitorea automáticamente tanto regiones como balizas. El sistema operativo permite un máximo de 100 regiones y, por defecto, monitoreamos 10 regiones. Puedes personalizar el límite superior para el monitoreo de regiones agregando el siguiente parámetro en el AndroidManifest.xml.

<meta-data
    android:name="re.notifica.geo.monitored_regions_limit"
    android:value="100" />

Interfaz de usuario de notificaciones

Cambiar la interfaz de usuario en Android depende intrínsecamente de los estilos de tu aplicación. Básicamente, Notificare usará los estilos que proporciones en tu app para los distintos elementos utilizados en nuestra interfaz. Recomendamos realizar estos cambios en tus carpetas res/values como se muestra a continuación:

Etiquetas de acciones

Las etiquetas utilizadas para los botones de acción, tanto en el Gestor de Notificaciones como en los Diálogos de Notificación, pueden ser localizadas añadiéndolas como recursos strings, donde el nombre es igual a la etiqueta. Para evitar colisiones de nombres de recursos, se pueden usar prefijos. El prefijo debe establecerse mediante las opciones en el archivo AndroidManifest.xml.

<meta-data
    android:name="re.notifica.action_label_prefix"
    android:value="custom_prefix" />