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

Configuração do Provider

Opção A: Provider + Hook (Recomendado)​

Envolva a raiz do seu app com GuardianProvider. Isso inicializa o SDK e o expõe a todos os componentes filhos pelo hook useGuardian.

App.tsx
import { GuardianProvider } from '@surtai/guardian-rn';

export default function App() {
return (
<GuardianProvider
collectLocation={true}
>
<Navigation />
</GuardianProvider>
);
}

O SDK não guarda uma chave de API. O contexto de cliente e transação vem de um JWT de curta duração que seu backend gera. Veja Verificar Transações para mais detalhes.

Props do Provider​

PropTipoPadrãoDescrição
logLevel'debug' | 'info' | 'warn' | 'error' | 'none''warn'Nível de detalhe dos logs do SDK. Aplicado no iOS. O Android o ignora e registra logs no nível INFO.
collectLocationbooleanfalseHabilita a coleta de GPS (requer permissões)
collectWifiInfobooleanfalseHabilita os detalhes da rede WiFi (somente Android)
collectSimCardInfobooleanfalseHabilita as informações de SIM/operadora (somente Android)
collectCameraInfobooleanfalseHabilita a quantidade de câmeras (somente Android)

Opção B: API Imperativa​

Se você preferir não usar o contexto do React, chame initialize() diretamente na inicialização do app:

index.ts
import { GuardianSDK } from '@surtai/guardian-rn';

GuardianSDK.initialize({
logLevel: 'warn',
collectLocation: true,
});

Hook useGuardian​

const {
isInitialized, // boolean - true after SDK is ready
verify, // (jwt: string, options?: VerifyOptions) => Promise<VerificationResult>
collect, // (jwt?: string, options?: VerifyOptions) => Promise<CollectResult>
} = useGuardian();
aviso

useGuardian() deve ser chamado dentro de um <GuardianProvider>. Chamá-lo fora lança um erro.

Solução de Problemas​

ErroCausaSolução
verification_failed com not_initialized na mensagem (iOS)verify() chamado antes de o SDK estar prontoUse GuardianProvider ou chame initialize() na inicialização
Erro do hook useGuardianHook usado fora do providerEnvolva a árvore de componentes com <GuardianProvider>
verification_failedA requisição à Surt falhou. Um JWT ausente, malformado ou expirado é uma das causas. No Android, a mensagem contém o status HTTP.Solicite um novo JWT ao seu backend para cada chamada e passe-o para verify()

verify() e collect() rejeitam com error.code definido como verification_failed, collect_failed ou sdk_error. Veja Códigos de Erro para saber como ler o detalhe.