SDK iOS

Para qué sirve#

El SDK de iOS mide la experiencia real de quienes usan tu app: sesiones, pantallas, inicio de la app, pedidos de red, errores, crashes y los eventos de negocio que quieras contar. Lo ves en Aplicaciones.

• Swift, iOS 13 o superior. Paquete lymen-sdk-ios, módulo LymenSdk. Versión actual: 0.2.1.

Cuándo usarlo#

Cuando tenés una app iOS propia. Antes, dala de alta en Aplicaciones (tipo App iOS): el paso Instalar te da el código listo para copiar, con la clave (ly_pub_…) y la dirección de tu cuenta ya puestas. Si tu app es React Native, mirá SDK React Native.

Instalación (Swift Package Manager)#

En Xcode: File › Add Package Dependencies…, pegá https://github.com/Lymen-ops/lymen-sdk-ios y elegí el producto LymenSdk. O en un Package.swift:

dependencies: [
  .package(url: "https://github.com/Lymen-ops/lymen-sdk-ios.git", exact: "0.2.1"),
],
targets: [
  .target(name: "MiApp", dependencies: [.product(name: "LymenSdk", package: "lymen-sdk-ios")]),
]

Iniciar#

Llamá a LymenSdk.iniciar una sola vez, lo antes posible y desde el hilo principal.

SwiftUI:

import LymenSdk
import SwiftUI

@main
struct TurnosApp: App {
  init() {
    LymenSdk.iniciar(Opciones(
      sitio: "ly_pub_XXXXXXXXXXXXXXXXXXXXXXXX",            // clave pública (no es secreta)
      endpoint: URL(string: "https://<tu-cuenta>-ingesta.lymen.app")!,
      servicio: "app-turnos",
      version: Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String ?? "1.0",
      entorno: "produccion"
    ))
  }
  var body: some Scene { WindowGroup { InicioView() } }
}

UIKit: se llama igual desde application(_:didFinishLaunchingWithOptions:), con vistasAutomaticas: true si querés pantallas automáticas.

Opciones#

El muestreo, los toques y las direcciones de tus APIs conviene manejarlos desde el portal, en Observar › Aplicaciones › (tu app) › Configurar (ver Aplicaciones): el cambio llega solo a los teléfonos, sin publicar una versión nueva de la app, y manda sobre lo que diga el código.

API#

LymenSdk.usuario("paciente-123")       // se manda como SHA-256; nil lo borra
LymenSdk.evento("turno.reservado", ["especialidad": "clinica", "monto": 15000, "moneda": "ARS"])
LymenSdk.error(error, ["pantalla": "medicos"])   // error manejado
LymenSdk.vista("Confirmar turno")
LymenSdk.consentimiento(.concedido)    // .pendiente | .concedido | .denegado
LymenSdk.log(.warn, "Reintento del pago")   // solo llega si en el portal están encendidos los mensajes
LymenSdk.origenSesion(.push)           // la sesión se abrió desde una notificación (o .link)
LymenSdk.enviarAhora()                 // manda ya lo juntado

Los eventos de negocio se llaman entidad.accion en minúsculas. Un nombre inválido se ignora. Mandá un mismo evento desde la app o desde el backend, nunca desde los dos.

Qué mide#

• Sesión: se renueva a los 30 minutos sin actividad o a las 4 horas; se guarda en disco, así reabrir la app enseguida sigue en la misma sesión.
• Inicio de la app: en frío, tibio y caliente.
• Pantallas, pedidos de red, errores manejados y crashes.
• Clics: solo si los activás.

Crashes#

Al crashear, el SDK guarda un reporte en disco y lo manda en el próximo arranque, atribuido a la sesión, la pantalla y el usuario del momento.

Limitaciones que conviene conocer:

• Captura señales (SIGABRT, SIGSEGV, SIGBUS, SIGILL, SIGFPE, SIGTRAP) y excepciones de Objective-C sin atrapar. Los errores de Swift (fatalError, índice fuera de rango, ! sobre nil) llegan sin el mensaje.
• No captura cierres por SIGKILL: el sistema que cierra la app por tardar demasiado o por falta de memoria, ni cuando el usuario la cierra desde el selector de apps.
• El stack no está simbolizado (no se suben dSYM).
• Es esfuerzo razonable, no garantizado. Si usás otro capturador de crashes, pueden pisarse: usá uno solo.
• Con el depurador de Xcode conectado no se captura: probá desde el simulador o dispositivo sin depurador.

Envío y reintentos#

• Cola en disco con tope de 5 MB (si se llena, se descartan los envíos más viejos).
• Sin red, se reintenta con espera creciente (2 s, 4 s, 8 s… hasta 5 minutos).
• Al pasar a segundo plano, el SDK pide unos segundos al sistema para guardar y probar un envío.

Privacidad#

• Las reglas de Configuración › Privacidad bajan al teléfono y se aplican antes de mandar; Lymen las vuelve a aplicar al recibir.
• Sin reglas descargadas se usan las de respaldo (DNI, email, tarjetas y CUIT/CUIL).
• No se captura el valor de campos de texto y no se graban sesiones. el id de usuario sale siempre hasheado.
• En la pestaña Datos recibidos de la app podés apagar tipos de dato; lo apagado no sale del teléfono. Los mensajes vienen apagados.

Problemas comunes#