Zum Hauptinhalt springen
Version: Guardian v0.5.3

Provider-Einrichtung

Option A: Provider + Hook (Empfohlen)​

Umschließen Sie Ihren App-Stamm mit GuardianProvider. Dies initialisiert das SDK und macht es über den useGuardian-Hook für alle untergeordneten Komponenten zugänglich.

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

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

Das SDK hält keinen API-Schlüssel. Kunden- und Transaktionskontext stammen aus einem kurzlebigen JWT, das Ihr Backend erzeugt. Siehe Transaktionen verifizieren für Details.

Provider-Props​

PropTypStandardBeschreibung
logLevel'debug' | 'info' | 'warn' | 'error' | 'none''warn'SDK-Protokolldetailliertheit. Wird unter iOS angewendet. Android ignoriert die Option und protokolliert auf der Stufe INFO.
collectLocationbooleanfalseGPS-Erfassung aktivieren (erfordert Berechtigungen)
collectWifiInfobooleanfalseWLAN-Netzwerkdetails aktivieren (nur Android)
collectSimCardInfobooleanfalseSIM-/Anbieterinfo aktivieren (nur Android)
collectCameraInfobooleanfalseKameraanzahl aktivieren (nur Android)

Option B: Imperative API​

Wenn Sie keinen React-Kontext verwenden möchten, rufen Sie initialize() direkt beim App-Start auf:

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

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

useGuardian-Hook​

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

useGuardian() muss innerhalb eines <GuardianProvider> aufgerufen werden. Ein Aufruf außerhalb löst einen Fehler aus.

Fehlerbehebung​

FehlerUrsacheLösung
verification_failed mit not_initialized in der Meldung (iOS)verify() wurde aufgerufen, bevor das SDK bereit warGuardianProvider verwenden oder initialize() beim Start aufrufen
useGuardian-Hook-FehlerHook außerhalb des Providers verwendetKomponentenbaum mit <GuardianProvider> umschließen
verification_failedDie Anfrage an Surt ist fehlgeschlagen. Ein fehlendes, fehlerhaft aufgebautes oder abgelaufenes JWT ist eine mögliche Ursache. Unter Android enthält die Meldung den HTTP-Status.Fordern Sie für jeden Aufruf ein neues JWT von Ihrem Backend an und übergeben Sie es an verify()

verify() und collect() werden mit einem Fehler abgelehnt, dessen error.code auf verification_failed, collect_failed oder sdk_error gesetzt ist. Wie Sie die Details auslesen, steht unter Fehlercodes.