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 projeto:
//registry.npmjs.org/:_authToken=<YOUR_NPM_TOKEN>
Substitua <YOUR_NPM_TOKEN> pelo token fornecido pela Surt. Esse token é usado apenas para instalar o pacote - ele é independente da chave de API da Surt que seu backend usa para gerar JWTs.
Adicione o .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 faz o link automaticamente. Nenhuma etapa extra é 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>
As opções de WiFi, SIM e câmera não têm efeito no iOS, então não precisam de nenhuma chave no Info.plist.
O SDK exibe o pedido de permissão de localização durante verify() ou collect() quando a coleta de localização está habilitada. Você só precisa declarar as permissões.
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 |
| O pod install falha | Problema de cache do CocoaPods | Execute cd ios && pod install --repo-update |
| Build do iOS: "module not found" | Pods fora de sincronia | Execute cd ios && pod install após o npm install |