Saltar al contenido principal
Version: Guardian v0.5.3

Instalación

Requisitos​

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

1. Configura el acceso a npm​

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

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

Reemplaza <YOUR_NPM_TOKEN> con el token proporcionado por Surt. Este token solo se usa para instalar el paquete: es independiente de la clave de API de Surt que tu backend usa para generar JWTs.

aviso

Agrega .npmrc a tu .gitignore para evitar subir tokens al repositorio.

2. Instala el paquete​

npm install @surtai/guardian-rn

Configuración de iOS​

Instala 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 habilitas 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 habilitas la recopilación de información de la tarjeta SIM:

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

iOS: ios/<YourApp>/Info.plist​

Si habilitas la recopilación de ubicación:

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

Las opciones de WiFi, SIM y cámara no tienen efecto en iOS, por lo que no necesitan ninguna clave en Info.plist.

tip

El SDK muestra la solicitud del permiso de ubicación durante verify() o collect() cuando la recopilación de ubicación está habilitada. Solo necesitas declarar los permisos.

Solución de problemas​

ErrorCausaSolución
npm 404 Not FoundToken npm faltante o inválidoVerifica que .npmrc tenga un _authToken válido
Pod install fallaProblema de caché de CocoaPodsEjecuta cd ios && pod install --repo-update
Build iOS: "module not found"Pods desincronizadosEjecuta cd ios && pod install después de npm install