SDK de Applivery: integra distribución de apps y gestión de usuarios

Versión actual: 5.0.0
Versión mínima de Android: Android 7.0 (API level 24)
Lenguaje: Kotlin
Distribución: Maven Central
Repositorio: applivery/applivery-android-sdk

Instalación

Añade la dependencia al build.gradle de tu App. El SDK está pensado para Builds que no son de producción:

// Usa debugImplementation para que Applivery solo se ejecute en builds de debug o de testing
debugImplementation("com.applivery:applivery-sdk:${latestVersion}")

Artefacto no-op para Builds de release

Para no tener que montar una configuración compleja de source sets que excluya el SDK de los Builds de release, usa el artefacto no-op. Expone la misma API pública que el SDK completo, pero no hace nada en tiempo de ejecución:

releaseImplementation("com.applivery:applivery-sdk-no-op:${latestVersion}")

Así puedes llamar a los métodos del SDK de Applivery desde cualquier punto de tu código sin que afecte a los Builds de release.

Configuración inicial

Inicializa el SDK en el método Application.onCreate():

import com.applivery.android.sdk.Applivery
import com.applivery.android.sdk.start

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()
        Applivery.start(APPLIVERY_TOKEN)
        // Para instancias privadas de Applivery, pasa también el tenant:
        // Applivery.start(APPLIVERY_TOKEN, TENANT)
    }
}

Tu App Token está disponible en Ajustes de la App → API Tokens, en el panel de Applivery.

Configuración

Pasa un objeto Configuration a Applivery.start() para personalizar el comportamiento:

val configuration = Configuration(
    postponeDurations = listOf(2.hours, 30.minutes, 5.minutes),
    enforceAuthentication = false,
    downloadAction = BuildDownloadAction.IMMEDIATE
)

Applivery.start(APPLIVERY_TOKEN, configuration = configuration)

Gestión de actualizaciones

// Comprobar actualizaciones manualmente
Applivery.getInstance().checkForUpdates()

// Comprobar automáticamente cuando la app vuelve de segundo plano
Applivery.getInstance().setCheckForUpdatesBackground(true)

// Descargar la última actualización sin instalarla de inmediato
val callback = object : DownloadLastUpdateCallback {
    override fun onSuccess(update: CachedAppUpdate) {
        update.install() // instalar cuando esté listo
    }
    override fun onError(error: Throwable) { /* gestionar el error */ }
}
Applivery.getInstance().downloadLastUpdate(callback)

// Activar la descarga automática en segundo plano
Applivery.getInstance().enableDownloadLastUpdateBackground(callback)

// Lanzar descarga e instalación inmediatas (sigue el downloadAction configurado)
Applivery.getInstance().update()

Feedback

// Activar o desactivar el feedback por captura de pantalla
Applivery.getInstance().enableScreenshotFeedback()
Applivery.getInstance().disableScreenshotFeedback()

// Mostrar la interfaz de feedback de forma programática
Applivery.getInstance().feedbackEvent()

Gestión de usuarios

// Vincular un usuario para analítica y seguimiento del feedback
Applivery.getInstance().bindUser(email, firstName, lastName, tags)

// Eliminar el usuario vinculado
Applivery.getInstance().unbindUser()

// Obtener el usuario actual
Applivery.getInstance().getUser(getUserCallback)

Permisos necesarios

El SDK necesita los siguientes permisos en tiempo de ejecución. Solicítalos en tu App antes de usar las funciones que los requieren:

Personalización de la interfaz

Crea un archivo res/values/applivery.xml para sobrescribir los colores y textos por defecto:

<?xml version="1.0" encoding="utf-8"?>
<resources>
    <color name="applivery_primary_color">#FF0241E3</color>
    <color name="applivery_accent_color">#FF0241E3</color>
    <color name="applivery_foreground_color">#FF010258</color>

    <string name="appliveryUpdateMsg">A new version is available. Update now?</string>
    <string name="appliveryMustUpdateAppLocked">This version is outdated. Please update to continue.</string>
</resources>