SDK Android

Para qué sirve#

El SDK de Android mide la experiencia real de quienes usan tu app: sesiones, pantallas, tiempo de arranque, errores, cierres inesperados (crashes), apps trabadas (ANR), pedidos de red y eventos de negocio. Lo ves en Aplicaciones.

• Kotlin, minSdk 24. La app tiene que compilar con compileSdk 37.
• Versión actual: 0.2.1 (artefacto de unos 190 KB).

Cuándo usarlo#

Cuando tenés una app Android propia. Antes, dala de alta en Aplicaciones (tipo Android): ahí obtenés la clave (ly_pub_…) y el código listo para copiar. Si tu app es React Native, mirá SDK React Native.

Instalación#

// settings.gradle.kts
dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        // más el repositorio donde tengas el SDK
    }
}

// app/build.gradle.kts
android {
    compileOptions {
        // Hace falta si minSdk < 26.
        isCoreLibraryDesugaringEnabled = true
    }
}
dependencies {
    implementation("app.lymen:lymen-sdk-android:0.2.1")
    coreLibraryDesugaring("com.android.tools:desugar_jdk_libs:2.1.5")
}

No hace falta configurar R8/ProGuard: el SDK trae sus propias reglas.

Iniciar#

Una sola vez, en Application.onCreate():

class MiApp : Application() {
    override fun onCreate() {
        super.onCreate()
        LymenSdk.iniciar(
            this,
            Opciones(
                sitio = "ly_pub_XXXXXXXXXXXXXXXXXXXXXXXX",   // clave pública (no es secreta)
                endpoint = "https://<tu-cuenta>-ingesta.lymen.app",
                propagarA = listOf("api.tu-empresa.com"),
            ),
        )
    }
}

iniciar vuelve enseguida: solo instala lo necesario para medir el arranque y la primera pantalla; el resto se arma en segundo plano. Lo que mandes mientras tanto (evento, usuario, error) se guarda y sale después, con su hora original.

Opciones#

API#

LymenSdk.usuario("id-del-usuario")        // se manda el hash SHA-256; null lo borra
LymenSdk.evento("turno.reservado", mapOf("monto" to 15000, "moneda" to "ARS"))
LymenSdk.error(excepcion, mapOf("pantalla.accion" to "pagar"))   // error manejado
LymenSdk.vista("Pago")                    // pantalla manual
LymenSdk.consentimiento(Consentimiento.DENEGADO)
LymenSdk.log(NivelLog.WARN, "reintento del pago")   // apagado salvo que el portal prenda los mensajes
LymenSdk.sesionActual()                   // id de sesión, para mandarlo a tu backend
LymenSdk.enviarAhora()

Los eventos de negocio se llaman entidad.accion (minúsculas, números y _); si no, se ignoran. Mandá un mismo evento desde la app o desde el backend, nunca desde los dos, o se cuenta doble.

Pantallas#

• Activity y Fragment: automáticas. Si una Activity solo aloja fragments, cuenta el Fragment.
• Jetpack Compose: poné VistaLymen("Nombre") al principio de cada pantalla y marcá la Activity con @SinVistaAutomatica para que no cuente doble.
• Manual: LymenSdk.vista("Nombre").

Red (OkHttp)#

val cliente = OkHttpClient.Builder()
    .addInterceptor(LymenOkHttp.interceptor())
    .build()

Cada pedido es un span con los atributos HTTP estándar. traceparent se agrega solo a los orígenes de propagarA.

Qué mide#

Envío y reintentos#

• Datos comprimidos, en lotes de hasta 50 elementos, cada 5 segundos o al juntar 50, y al pasar a segundo plano.
• Cola en disco con tope de 5 MB: si se llena, se descartan los lotes más viejos.
• Ante errores de red o del servidor se reintenta con espera creciente (5 s, 10 s, 20 s… hasta 5 minutos). Si la clave es inválida o la aplicación está pausada en el portal, se frenan los envíos 10 minutos.

Privacidad#

• Las reglas de Privacidad bajan del servidor (al iniciar y cada 10 minutos) y se aplican en el celular antes de mandar. El servidor las vuelve a aplicar.
• Sin reglas descargadas, se usan las de respaldo: DNI, email, tarjetas y CUIT/CUIL.
• No se captura el valor de ningún campo de texto y no se graban sesiones. user.id sale siempre hasheado.
• Desde el portal podés apagar tipos de dato (vistas, tiempos, errores, red, clics, sesiones, logs): lo apagado no sale del celular. Los logs vienen apagados.

Problemas comunes#