- 06 Jun 2024
- 1 Minute zum Lesen
-
Drucken
-
DunkelLicht
-
pdf
Whatfix Mobile SDK mit Cordova Android integrieren
- Aktualisiert am 06 Jun 2024
- 1 Minute zum Lesen
-
Drucken
-
DunkelLicht
-
pdf
Um Whatfix Mobile in-App-Erlebnisse in Ihren Cordova Android-Apps zu erstellen, müssen Sie zuerst Whatfix Mobile einrichten. Sie können das Whatfix Mobile SDK für Cordova Android-Apps zum Quellcode Ihrer App hinzufügen und dann Inhalt erstellen und veröffentlichen.
Integrationsschritte für Cordova Android-App
Verwenden Sie die folgenden Schritte, um das Whatfix Mobile SDK in Ihr Cordova 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 Plugin integrieren
a. Die Whatfix Mobile-Abhängigkeit hinzufügen
Laden Sie das Whatfix Mobile Cordova Plugin-Paket von npm mit dem folgenden Befehl herunter:
b. Das Whatfix Mobile SDK starten
Um Whatfix Mobile zu starten, fügen Sie den folgenden Code innerhalb von onDeviceReady() {} hinzu.
document.addEventListener('deviceready', onDeviceReady, false);
function onDeviceReady() {
if(device.platform === 'Android') {
cordova.plugins.LeapAndroid.start("<YOUR_API_KEY>");
}
}
Schritt 2: Aktivieren Sie den Creator-Modus in Ihrer App
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 Plugin erreicht.
a. Abhängigkeiten hinzufügen
- Der Whatfix Mobile Creator Plugin 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 Whatfix Mobile Creator Cordova Plugin-Paket von npm mit dem folgenden Befehl herunter:
b. Das Whatfix Mobile Creator Plugin starten
Um den Whatfix Mobile Creator zu starten, fügen Sie den folgenden Code innerhalb von onDeviceReady() {} hinzu.
document.addEventListener('deviceready', onDeviceReady, false);
function onDeviceReady() {
if(device.platform === 'Android') {
cordova.plugins.LeapCreatorAndroid.start("<YOUR_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.