Instalación

Requisitos

• React Native 0.73+
• iOS 14.0+ / Android SDK 24+
• Node.js 18+

1. Configurar acceso npm

El SDK es un paquete npm privado. Agregue su token de acceso a .npmrc en la raíz de su proyecto:

.npmrc

//registry.npmjs.org/:_authToken=<YOUR_NPM_TOKEN>

Reemplace <YOUR_NPM_TOKEN> con el token proporcionado por Surt.

aviso

Agregue .npmrc a su .gitignore para evitar confirmar tokens.

2. Instalar el paquete

npm install @surtai/guardian-rn

Configuración de iOS

Instale las dependencias de CocoaPods:

cd ios && pod install && cd ..

Configuración de Android

Android se enlaza automáticamente - no se necesitan pasos adicionales.

3. Permisos de plataforma

Android - android/app/src/main/AndroidManifest.xml

Si habilita la recopilación de ubicación:

<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />

Si habilita la recopilación de información de tarjeta SIM:

<uses-permission android:name="android.permission.READ_PHONE_STATE" />

iOS - ios/<YourApp>/Info.plist

Si habilita la recopilación de ubicación:

<key>NSLocationWhenInUseUsageDescription</key>
<string>Your location helps verify your identity and protect your account.</string>

Si habilita la recopilación de información de cámara:

<key>NSCameraUsageDescription</key>
<string>Camera access helps verify device authenticity.</string>

tip

El SDK gestiona automáticamente los cuadros de diálogo de permisos en tiempo de ejecución durante verify(). Solo necesita declarar los permisos - no se necesita código adicional de permisos.

Solución de problemas

Error	Causa	Solución
npm 404 Not Found	Token npm faltante o inválido	Verifique que .npmrc tenga un _authToken válido
Pod install falla	Problema de caché de CocoaPods	Ejecute cd ios && pod install --repo-update
Build iOS: "module not found"	Pods desincronizados	Ejecute cd ios && pod install después de npm install