Home

AMDev.IT AdMob Wrapper

Welcome to the documentation for AMDev.IT AdMob Wrapper, a .NET 10 library that exposes Google Mobile Ads and User Messaging Platform (UMP) on Android, iOS, and .NET MAUI.

The project provides:

• native Kotlin and Swift wrappers;
• .NET bindings for Android and iOS;
• shared callback and async/await APIs;
• MAUI XAML controls and dependency-injection services;
• UMP consent and privacy-options workflows;
• native-to-managed logging;
• Windows and Mac Catalyst fallback behavior for cross-platform MAUI apps.

Packages

Package	Use it when
AMDevIT.Admob.Wrapper.Droid	You need the low-level Android binding and callback APIs.
AMDevIT.Admob.Wrapper.iOSNative	You need the low-level iOS binding and callback APIs.
AMDevIT.Admob.Wrapper	You need the shared consent models and async/await extensions on Android or iOS.
AMDevIT.Admob.Wrapper.MAUICross	You are building a MAUI app and want XAML banners, DI services, logging adapters, and cross-platform consent handling.

Platform matrix

Capability	Android	iOS	Windows	Mac Catalyst
Native AdMob	Yes	Yes	No	No
UMP consent	Yes	Yes	No-op	No-op
MAUI banner	Native	Native	Fallback template	Fallback template
MAUI full-screen ads	Yes	Yes	Not supported	Not supported

Start here

1. Read Getting Started.
2. Implement the mandatory Privacy and Consent UMP flow.
3. Choose MAUI Usage, Android Usage, or iOS Usage.
4. Configure the formats described in Ad Formats.
5. Add Logging and Diagnostics.
6. Review Testing and Troubleshooting before release.

For MAUI applications that also target desktop, read Desktop Fallbacks.

Important privacy rule

Gather or refresh consent before initializing Google Mobile Ads or loading any ad. A previous consent state may still permit ad requests when UMP refresh fails; use ConsentException.CanRequestAds to make that decision explicitly.

Never ship debug geography or test-device consent settings in production.

Source and releases

• GitHub repository
• NuGet packages
• Apache 2.0 license