Installation

Voraussetzungen

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

1. npm-Zugriff konfigurieren

Das SDK ist ein privates npm-Paket. Fügen Sie Ihr Zugriffstoken in .npmrc im Projektstamm hinzu:

.npmrc

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

Ersetzen Sie <YOUR_NPM_TOKEN> durch das von Surt bereitgestellte Token.

warnung

Fügen Sie .npmrc zu Ihrer .gitignore-Datei hinzu, um das Festschreiben von Token zu vermeiden.

2. Paket installieren

npm install @surtai/guardian-rn

iOS-Einrichtung

CocoaPods-Abhängigkeiten installieren:

cd ios && pod install && cd ..

Android-Einrichtung

Android wird automatisch verlinkt - keine zusätzlichen Schritte erforderlich.

3. Plattformberechtigungen

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

Wenn Sie die Standorterfassung aktivieren:

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

Wenn Sie die SIM-Karten-Informationserfassung aktivieren:

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

iOS - ios/<YourApp>/Info.plist

Wenn Sie die Standorterfassung aktivieren:

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

Wenn Sie die Kamerainformationserfassung aktivieren:

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

tipp

Das SDK behandelt Laufzeit-Berechtigungsaufforderungen automatisch während verify(). Sie müssen nur die Berechtigungen deklarieren - kein zusätzlicher Berechtigungscode erforderlich.

Fehlerbehebung

Fehler	Ursache	Lösung
npm 404 Not Found	Fehlender oder ungültiger npm-Token	Prüfen Sie, ob .npmrc einen gültigen _authToken enthält
Pod-Installation schlägt fehl	CocoaPods-Cache-Problem	cd ios && pod install --repo-update ausführen
iOS-Build: "module not found"	Pods nicht synchronisiert	cd ios && pod install nach npm install ausführen