Instalação

Requisitos

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

1. Configurar Acesso npm

O SDK é um pacote npm privado. Adicione seu token de acesso ao .npmrc na raiz do seu projeto:

.npmrc

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

Substitua <YOUR_NPM_TOKEN> pelo token fornecido pela Surt.

aviso

Adicione .npmrc ao seu .gitignore para evitar o commit de tokens.

2. Instalar o Pacote

npm install @surtai/guardian-rn

Configuração iOS

Instale as dependências do CocoaPods:

cd ios && pod install && cd ..

Configuração Android

O Android vincula automaticamente - nenhuma etapa adicional necessária.

3. Permissões de Plataforma

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

Se você habilitar a coleta de localização:

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

Se você habilitar a coleta de informações do cartão SIM:

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

iOS - ios/<YourApp>/Info.plist

Se você habilitar a coleta de localização:

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

Se você habilitar a coleta de informações da câmera:

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

dica

O SDK trata as solicitações de permissão em tempo de execução automaticamente durante verify(). Você só precisa declarar as permissões - nenhum código adicional de permissão é necessário.

Solução de Problemas

Erro	Causa	Solução
npm 404 Not Found	Token npm ausente ou inválido	Verifique se o .npmrc tem um _authToken válido
Falha no pod install	Problema de cache do CocoaPods	Execute cd ios && pod install --repo-update
Build iOS: "module not found"	Pods fora de sincronia	Execute cd ios && pod install após npm install