- 11 Jun 2024
- 2 Minuten zu lesen
-
Drucken
-
DunkelLicht
-
pdf
Whatfix Mobile SDK mit Xamarin Android integrieren
- Aktualisiert am 11 Jun 2024
- 2 Minuten zu lesen
-
Drucken
-
DunkelLicht
-
pdf
Um Whatfix Mobile in-App-Erlebnisse in Ihren Xamarin Android-Apps zu erstellen, müssen Sie zuerst Whatfix Mobile einrichten. Sie können das Whatfix Mobile SDK für Xamarin Android-Apps zum Quellcode Ihrer App hinzufügen und dann Inhalt erstellen und veröffentlichen.
Integrationsschritte für Xamarin Android-App
Verwenden Sie die folgenden Schritte, um das Whatfix Mobile SDK in Ihr Xamarin 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: Integrieren Sie das Whatfix Mobile SDK
a. Die Whatfix Mobile Xamarin SDK-Abhängigkeit hinzufügen
Fügen Sie das Whatfix Mobile Xamarin Library-Paket von Nuget hinzu.
Fügen Sie das LeapXamarinLib.Android-Paket aus NuGet zu den Paketen Ihres Android-spezifischen Projekts hinzu.
Weitere Informationen zur neuesten Version des Xamarin Android-Projekts finden Sie unter Xamarin Android Changelog.
b. Das Whatfix Mobile SDK starten
using IS.Leap.Android.Aui;
namespace YourApp
{
[Activity(Label = "@string/app_name", Theme = "@style/AppTheme.NoActionBar", MainLauncher = true)]
public class MainActivity : AppCompatActivity
{
protected override void OnCreate(Bundle savedInstanceState)
{
base.OnCreate(savedInstanceState);
Leap.Start("<YOUR_API_KEY>");
}
}
}
Schritt 2: Den 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 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.
Fügen Sie das Whatfix Mobile Xamarin Creator-Paket von nuget hinzu.
Fügen Sie das LeapXamarinLib.Android.Creator-Paket aus NuGet zu den Paketen Ihres Android-spezifischen Projekts hinzu.
- Wenn Sie Xamarin.Forms verwenden, stellen Sie sicher, dass dessen Version 5.0.0.2125 und höher ist.
- Wenn die Version von Xamarin.Forms 5.0.0.2083 oder niedriger ist, stellen Sie sicher, dass Sie Xamarin.AndroidX.Core (Version 1.6.0) hinzufügen.
Weitere Informationen zur neuesten Version des Xamarin Android-Projekts finden Sie unter Xamarin Android Changelog.
b. Das Whatfix Mobile Creator SDK starten
using IS.Leap.Android.Creator;
namespace YourApp
{
[Activity(Label = "@string/app_name", Theme = "@style/AppTheme.NoActionBar", MainLauncher = true)]
public class MainActivity : AppCompatActivity
{
protected override void OnCreate(Bundle savedInstanceState)
{
base.OnCreate(savedInstanceState);
LeapCreator.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.