MsbSvg.RevenueCat.Maui.Android.PaywallUI 9.2.0.28

MsbSvg.RevenueCat.Maui.Android.PaywallUI

RevenueCat Android Paywall UI bindings for .NET MAUI.

Display 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 Paywall UI layer. This package fills that gap with a production-ready solution.

Why This Package?

RevenueCat's purchases-ui for Android is built entirely with Jetpack Compose. Creating traditional C# bindings for 30+ Compose libraries is impractical. This package takes a smarter approach:

The core RevenueCat SDK (purchases) and its C# bindings are not included — they come from the required Kebechet.Maui.RevenueCat.Android dependency. This separation prevents duplicate class conflicts and keeps each package focused on its responsibility.

Prerequisites

Your MAUI project must have the RevenueCat core Android SDK installed:

• Kebechet.Maui.RevenueCat.Android (9.2.0.2+)

This package is automatically pulled as a dependency, but it's good practice to reference it explicitly so you have access to the full C# API (CustomerInfo, Purchases, etc.).

Installation

dotnet add package Kebechet.Maui.RevenueCat.Android         # Core SDK + C# bindings
dotnet add package MsbSvg.RevenueCat.Maui.Android.PaywallUI  # Paywall UI (this package)

That's it. The bundled .targets file automatically injects the native AAR/JAR files into your Android build. No manual configuration needed.

Quick Start

1. Configure the 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");

Paywall Presentation Modes

RevenueCat Dashboard offers three presentation styles. Here's how they behave on each platform:

On Android, PaywallActivity always launches as a full-screen Activity — this is the standard Android platform convention. The user can dismiss it by pressing the back button or the close button within the paywall. All three dashboard modes produce the same behavior on Android.

API Reference

How It Works

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

The bridge uses PaywallContract.createIntent() to construct the Intent and launches PaywallActivity as a standard Android Activity. Jetpack Compose handles all rendering inside PaywallActivity — your MAUI code never touches Compose directly.

Compatibility

Troubleshooting

"Displaying default template due to validation errors"

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

• Ensure all localization keys have values for every configured language
• Known RevenueCat dashboard bug: Missing string localization for locale en_US
• Fix: Remove extra languages from the paywall in the dashboard, save, re-add them, then fill in all strings

AAPT2 / Stamp File Errors

Clean the build artifacts and rebuild:

dotnet clean
rm -rf obj/ bin/
dotnet build

ClassNotFoundException at Runtime

Make sure both packages are installed:

1. Kebechet.Maui.RevenueCat.Android — core SDK with C# bindings
2. MsbSvg.RevenueCat.Maui.Android.PaywallUI — Paywall UI (this package)

If you see ClassNotFoundException for Compose/AndroidX classes, ensure your build is not stripping native AAR files.

D8 Duplicate Class Errors

If another package in your project provides the same native library (e.g., OkHttp, Play Services), you may see duplicate class errors. This package is designed to work alongside Kebechet.Maui.RevenueCat.Android without conflicts. If you're using additional packages that bundle the same native libraries, you may need to exclude the conflicting dependency from one side.

Package Architecture

MsbSvg.RevenueCat.Maui.Android.PaywallUI (this package)
├── Paywall UI (purchases-ui-9.2.0.aar)
├── Jetpack Compose Runtime, UI, Foundation, Animation
├── Material 3
├── Coil (image loading for paywall assets)
├── Compose integrations (activity-compose, lifecycle-compose, etc.)
├── Java Bridge (RevenueCatBridge-release.aar)
└── C# wrapper (RevenueCatPaywallUI.cs)

Kebechet.Maui.RevenueCat.Android (required dependency)
├── Core RevenueCat SDK (purchases-9.2.0.aar)
├── Google Play Billing
├── Play Services
├── OkHttp / OkIO
├── Kotlin Serialization
└── Full C# bindings (CustomerInfo, Purchases, etc.)

🐾 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.