Pular para o conteúdo principal
Versão: Guardian v0.5.3

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:

.npmrc
//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.

aviso

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.

dica

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​

ErroCausaSolução
npm 404 Not FoundToken npm ausente ou inválidoVerifique se o .npmrc tem um _authToken válido
O pod install falhaProblema de cache do CocoaPodsExecute cd ios && pod install --repo-update
Build do iOS: "module not found"Pods fora de sincroniaExecute cd ios && pod install após o npm install