Walkme.Sdk.Maui.Android 1.1.2

WalkMe.Maui

A .NET MAUI bridge/plugin for the WalkMe Android SDK.

NuGet packages (both target net8.0-android):

• Walkme.Sdk.Maui.Android.Bindings — .NET for Android binding library for a locally built WalkMe .aar, plus NuGet PackageReferences for AndroidX / OkHttp / Room / Lottie / etc.
• Walkme.Sdk.Maui.Android — plugin surface: IWalkMe and managed models that wrap the native WalkMeSDK singleton (C# namespace remains WalkMe.Maui).

Install (consumers)

dotnet add package Walkme.Sdk.Maui.Android

Or add a PackageReference to Walkme.Sdk.Maui.Android in your MAUI Android app. The bindings package is pulled in as a dependency; you do not need to build the WalkMe AAR yourself.

Prerequisites (building this repo)

• .NET 8+ SDK
• MAUI and Android workloads: dotnet workload install maui android
• A JDK compatible with the Android workload
• A locally built WalkMe Android SDK 1.1.2 AAR (see below)

Local WalkMe AAR

The bindings project binds:

WalkMe.Maui.Android.Bindings/Jars/walkme-android-sdk-1.1.2.aar

Build the AAR from walkme-android-sdk tag 1.1.2 (or copy the release artifact from that tag, e.g. wmSdkRelease-release.aar), then:

mkdir -p WalkMe.Maui.Android.Bindings/Jars
cp /path/to/wmSdkRelease-release.aar \
  WalkMe.Maui.Android.Bindings/Jars/walkme-android-sdk-1.1.2.aar

That path is tracked in git (see .gitignore exception). NuGet packing embeds the AAR into the package for consumers.

Building and packing

dotnet restore
dotnet build
dotnet pack

Koin, Stately, and Lottie have no suitable net8 .NET NuGets; they are downloaded from Maven Central into libs/ at build time via MSBuild DownloadFile and shipped with Bind="false".

What's wrapped

IWalkMe mirrors the native WalkMeSDK singleton:

Start, Stop, Restart, SetUserId, SetLanguage, SetVariable, SetEventUserVars, SetTenantId, StartItemById, DismissItem, SendEvent, plus ItemPresented / ItemDismissed / ItemAction / AnalyticsEventSent C# events.

using WalkMe.Maui;

var options = new WalkMeStartOptions
{
    SystemGuid = "<YOUR_SYSTEM_GUID>",
    Environment = "Production",
    DataCenter = WalkMeDataCenter.Prod,
};

CrossWalkMe.Default.Start(options); // after the host Activity exists

Or via DI: builder.UseWalkMe() in MauiProgram.cs and inject IWalkMe.

Known risk areas

1. WalkMeSDK.Instance — Kotlin object; this binding always uses WalkMeSDK.Instance!.Xxx(...).
2. WalkmeDataCenter mapping — sealed class cases mapped in ToNative at the bottom of WalkMeImplementation.cs. If generated names differ after an SDK bump, adjust that method only.

Transforms/Metadata.xml is the place for binding fixups if needed.