MsbSvg.RevenueCat.Maui.Android.PaywallUI 9.2.0.2

MsbSvg.RevenueCat.Maui.Android.PaywallUI

RevenueCat Android Paywall UI bindings for .NET MAUI.

Show RevenueCat's native Paywall UI — including V2 component-based paywalls designed in the RevenueCat Dashboard — on Android in your .NET MAUI app. No official MAUI binding exists for the RevenueCat UI layer; this package fills that gap.

Why this package?

RevenueCat provides purchases-ui for Android, built entirely with Jetpack Compose. Binding 50+ Compose dependencies directly into MAUI is impractical. This package takes a different approach:

Prerequisites

Your MAUI project must already have the RevenueCat core SDK configured. Use one of these NuGet packages:

• Kebechet.Maui.RevenueCat.Android (9.2.0+)
• Tonestro.Maui.RevenueCat.Android (9.x+)

Note: This package provides only the UI layer. The core purchases SDK must come from one of the packages above.

Installation

dotnet add package MsbSvg.RevenueCat.Maui.Android.PaywallUI

That's it — the bundled .targets file automatically injects the native AAR/JAR files into your Android build.

Quick Start

1. Configure RevenueCat SDK (Platforms/Android/MainApplication.cs)

using MsbSvg.RevenueCat.Maui.Android.PaywallUI;

[Application]
public class MainApplication : MauiApplication
{
    public MainApplication(IntPtr handle, JniHandleOwnership ownership)
        : base(handle, ownership) { }

    protected override MauiApp CreateMauiApp() => MauiProgram.CreateMauiApp();

    public override void OnCreate()
    {
        base.OnCreate();
        RevenueCatPaywallUI.Configure(this, "your_google_api_key");
    }
}

2. Show the Paywall

private void OnShowPaywallClicked(object sender, EventArgs e)
{
#if ANDROID
    var activity = Platform.CurrentActivity;
    if (activity != null)
    {
        RevenueCatPaywallUI.ShowPaywall(activity);
    }
#endif
}

3. Show a specific offering

RevenueCatPaywallUI.ShowPaywall(activity, offeringId: "premium_offering");

4. One-shot: configure + show

RevenueCatPaywallUI.ConfigureAndShowPaywall(activity, "your_google_api_key");

API Reference

How it works

Your MAUI C# Code
  → RevenueCatPaywallUI.ShowPaywall(activity)
  → JNI → RevenueCatPaywallBridge.java (bundled AAR)
  → PaywallContract.createIntent()
  → PaywallActivity (Jetpack Compose)
  → Native V1 / V2 paywall rendering

Compatibility

Troubleshooting

"Displaying default template due to validation errors"

This is typically a RevenueCat Dashboard issue, not a code problem:

• Ensure all localization keys have values for every configured language.
• Known dashboard bug: community.revenuecat.com/…/missing-string-localization

AAPT2 APT2144 error (invalid file path '...stamp')

Fixed in v9.2.0.2. This was caused by the .NET Android SDK incorrectly listing .stamp cache files as Android resources in files.cache. The package's .targets file now automatically cleans up these references before AAPT2 compilation runs. Works on both macOS/Linux and Windows.

If you still encounter this on an older version, update to 9.2.0.2 or later.

ClassNotFoundException at runtime

If you see ClassNotFoundException for Compose/AndroidX classes, make sure no build step is stripping this package's AAR files. The Bind="false" attribute in the .targets file should prevent any C# binding generation — the files are included as raw native libraries only.

🐾 A small note

If this package saved you time and you'd like to say thanks — please feed a stray animal 🐶🐱. No donations needed. Just a small act of kindness for a friend on the street.

Author

Musab Sevgi

• NuGet: nuget.org/profiles/musabsevgi
• GitHub: github.com/msbsvg

License

MIT — see LICENSE for details.