- 11 Jun 2024
- 2 Minuten zu lesen
-
Drucken
-
DunkelLicht
-
pdf
Whatfix Mobile SDK mit React Native Android integrieren
- Aktualisiert am 11 Jun 2024
- 2 Minuten zu lesen
-
Drucken
-
DunkelLicht
-
pdf
Um Whatfix Mobile in-App-Erlebnisse in Ihren React Native-Apps zu erstellen, müssen Sie zuerst Whatfix Mobile einrichten. Sie können das Whatfix Mobile SDK für React Native-Apps zum Quellcode Ihrer App hinzufügen und dann Inhalt erstellen und veröffentlichen.
Voraussetzungen
- API-Key
- Tags zu Ansichten hinzufügen. Weitere Informationen finden Sie unter Ansicht taggen.
- Whatfix Mobile React Native SDK ist nicht mit dem verwalteten Arbeitsablauf kompatibel. Wenn Sie Expo verwenden, um Ihr React Native-Projekt zu starten, stellen Sie sicher, dass Sie zum Baseline-Workflow auskoppeln.
- Die minimale API-Version für die Unterstützung des Whatfix Mobile SDK ist API 16. Außerdem funktioniert das SDK nur für API-Level größer oder gleich 21.
- Ein Android 5.0 oder neuer Gerät oder Emulator mit Google Play-Diensten installiert.
- Whatfix Mobile React Native SDK unterstützt nur androidX, daher sollte Ihr Projekt eine React Native-Version von 0.61.0 und höher verwenden.
Integrationsschritte für React Native Android-App
Verwenden Sie die folgenden Schritte, um das Whatfix Mobile SDK in Ihr React Native Android-Projekt zu integrieren:
Vergewissern Sie sich, dass Sie beide Schritte ausführen, um das In-App-Erlebnis in Ihrem integrierten Build zu erstellen und zu testen.
Schritt 1: Whatfix Mobile SDK integrieren
a. Die Whatfix Mobile SDK-Abhängigkeit hinzufügen
Laden Sie das leap-react-native Paket von npm mit dem folgenden Befehl herunter:
Weitere Informationen zur neuesten Version des React Native Projekts finden Sie unter React Native Changelog.
b. Starten Sie das Whatfix Mobile SDK
Um Whatfix Mobile zu starten, fügen Sie den folgenden Code innerhalb von componentDidMount() {} in Ihrer App.js-Datei hinzu.
import LeapReactNative from 'leap-react-native';
export class App extends React.Component {
componentDidMount() {
Platform.select({
android: () => LeapReactNative.start('API_KEY')
})()
}
}
Schritt 2: Creator-Modus in Ihrer App aktivieren
Um in-App-Erlebnisse im Whatfix Mobile Studio zu erstellen, müssen Sie den Creator-Modus in Ihrer App aktivieren. Dies wird durch die Integration des Whatfix Mobile Creator SDKs erreicht.
a. Abhängigkeiten hinzufügen
- Der Whatfix Mobile Creator SDK muss entfernt werden, bevor die App im Play Store veröffentlicht wird.
- Während sowohl Whatfix Mobile Creator SDK als auch Whatfix Mobile SDK in den Entwicklungs- und Testversionen integriert werden müssen, sollte die Produktionsversion nur das Whatfix Mobile SDK enthalten.
Laden Sie das leap-creator-react-native Paket von npm mit dem folgenden Befehl herunter:
Weitere Informationen zur neuesten Version des React Native Projekts finden Sie unter React Native Changelog.
b. Das Whatfix Mobile Creator SDK starten
Um den Whatfix Mobile Creator zu starten, fügen Sie den folgenden Code innerhalb von componentDidMount() {} in Ihre App.js Datei hinzu.
import LeapCreatorReactNative from 'leap-creator-react-native';
export class App extends React.Component {
componentDidMount() {
Platform.select({
android: () => LeapCreatorReactNative.start('API_KEY')
})()
}
}
Proguard Rules
Wenn Sie Proguard für Ihre Builds verwenden, verwenden Sie die folgenden Regeln in Ihrer Datei proguard-rules.pro,
-dontwarn is.leap.android.**
-keep class is.leap.android.** {*;}
Wenn Sie Android Gradle Plugin (AGP) Version 8.0 oder neuer verwenden, kann es notwendig sein, bestimmte OkHttp-Regeln in Ihre proguard-rules.pro-Datei aufzunehmen. Dieser Schritt ist entscheidend für die korrekte Ausführung von Release-Builds, da das LeapCreator SDK auf die OkHttp-Bibliothek angewiesen ist. Die erforderlichen Regeln lauten wie folgt:
#For Okhttp
-dontwarn okhttp3.internal.platform.**
-dontwarn org.conscrypt.**
-dontwarn org.bouncycastle.**
-dontwarn org.openjsse.**
Für weitere Informationen, sehen Sie Okhttp R8 / ProGuard.
Nachdem Sie den Code integriert haben, können Sie mit Whatfix Mobile Ihr In-App-Erlebnis starten.