SDK React Native

Para qué sirve#

Mide sesiones, pantallas, errores de JavaScript y nativos, crashes, pedidos de red y eventos de negocio de tu app React Native. No reimplementa nada: es una capa fina sobre los SDK nativos de Lymen (Android e iOS). El SDK nativo maneja la sesión, la cola en disco, el consentimiento, la privacidad, los crashes, el inicio de la app y la red; JavaScript suma lo que el nativo no ve: errores de JS, promesas rechazadas y pantallas de react-navigation.

Con una sola alta y una sola clave recibís de Android y de iOS. En el detalle de la aplicación filtrás por sistema (Todas, Android, iOS).

Requisitos#

Instalación#

Primero dá de alta la app en Aplicaciones con tipo React Native (podés cargar el paquete Android y el bundle id de iOS).

npm install lymen-sdk-react-native@0.2.1
cd ios && pod install

Android#

En android/build.gradle de la app, la versión de compilación y la de Kotlin que exige el SDK:

buildscript {
  ext {
    compileSdkVersion = 37
    minSdkVersion = 24
    kotlinVersion = "2.4.21"
  }
  dependencies { classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlinVersion") }
}

El paquete le agrega el seguimiento de pedidos al cliente de red de React Native. Si minSdkVersion es menor que 26, la app necesita desugaring (ver SDK Android).

iOS#

El pod install suma el SDK nativo de iOS como paquete de Swift (React Native 0.75 o más nuevo).

Expo#

Con un development build no hace falta un plugin propio. Para Android, configurá compileSdkVersion: 37 y minSdkVersion: 24 con expo-build-properties.

Iniciar#

Lo antes posible, en index.js, antes de AppRegistry.registerComponent:

import lymen from 'lymen-sdk-react-native';

lymen.iniciar({
  sitio: 'ly_pub_TU_CLAVE',                 // la misma para Android e iOS
  endpoint: 'https://<tu-cuenta>-ingesta.lymen.app',
  version: '1.4.0',
  propagarA: ['api.tu-empresa.com'],
});

Iniciar también desde el código nativo (opcional)#

Iniciar desde JavaScript es lo más simple, pero JavaScript arranca cuando la app ya abrió: el inicio de la app en frío y un crash en los primeros segundos no se miden. Para medirlos, iniciá también el SDK nativo al abrir la app (MainApplication.onCreate() en Android, AppDelegate en iOS). Después, el iniciar de JS se ignora en el nativo (gana el primero) y solo engancha lo de JS. En Android, usá vistasAutomaticas = false: las pantallas las marca JS.

Opciones#

API#

lymen.usuario('paciente-123');   // se manda el hash SHA-256; null lo borra
lymen.evento('turno.reservado', { especialidad: 'clinica', monto: 15000 });
lymen.error(err, { 'pantalla.accion': 'pagar' });   // error manejado
lymen.vista('Pago');             // pantalla manual
lymen.consentimiento('denegado');
lymen.log('warn', 'reintento del pago');   // apagado salvo que el portal lo prenda
lymen.enviarAhora();
await lymen.sesionActual();      // id de sesión o null

Los eventos de negocio se llaman entidad.accion (minúsculas, números y _). Mandalos desde la app o desde el backend, nunca desde los dos. Ninguna función lanza excepciones. probarCierreNativo() existe solo para comprobar la instalación: cierra la app con un error nativo, no la uses en producción.

Pantallas con react-navigation#

import { NavigationContainer, useNavigationContainerRef } from '@react-navigation/native';
import { useVistasLymen } from 'lymen-sdk-react-native';

export default function App() {
  const navigationRef = useNavigationContainerRef();
  useVistasLymen(navigationRef);   // cada cambio de pantalla es una vista
  return <NavigationContainer ref={navigationRef}>{/* ... */}</NavigationContainer>;
}

El nombre de la vista es el nombre de la ruta, nunca sus parámetros (pueden tener datos personales). Para cambiarlo: useVistasLymen(navigationRef, { nombrar: (ruta) => ruta.name }).

Errores de JavaScript#

iniciar engancha el manejador global de errores encadenándolo al que había: la pantalla roja en desarrollo y el cierre de la app ante un error fatal siguen igual. Cada error trae el tipo, el mensaje, el stack (hasta 8 KB) y una huella para agruparlos. Tope: 100 errores por ejecución y 10 por huella. Un error fatal en la versión de producción cierra la app: llega el error de JS y, en el próximo arranque, el crash nativo.

Red#

El fetch y el XMLHttpRequest de React Native viajan por la red nativa, así que la red la mide el SDK nativo y cada pedido tiene un solo span. Solo si el nativo no mide la red (por ejemplo, en Android si la app arma su propio cliente HTTP) se usa instrumentarFetch(), que es seguro de llamar siempre: si el nativo ya mide, no hace nada.

Privacidad#

Las reglas de Privacidad bajan del portal y las aplica el SDK nativo antes de mandar; el servidor las vuelve a aplicar. JavaScript no captura textos ingresados ni parámetros de navegación, y user.id sale siempre hasheado.

Problemas comunes#