Fixing XA0141 in .NET MAUI: SQLite 16 KB Page Size Support for Android 15 & 16

If you are building a .NET MAUI application targeting modern Android versions, you may have recently encountered a specific and worrying build warning:

warning XA0141: Android 16 will require 16 KB page sizes, shared library 'libe_sqlite3.so' does not have a 16 KB page size.

This guide explains how to update your SQLite dependencies to eliminate this warning and future-proof your app for Android 15 and 16.

🛑 The Problem: libe_sqlite3.so Alignment

The warning explicitly flags libe_sqlite3.so, which is the native C library that powers your SQLite database.

For years, the standard recommendation for .NET MAUI and Xamarin developers was to use:

• SQLitePCLRaw.bundle_green

However, older versions of this bundle (and the system-provided SQLite on many devices) are compiled with 4 KB memory alignment.

When Android 15/16 tries to load these 4 KB-aligned libraries on a system enforcing 16 KB page sizes (such as the Pixel 9 or certain emulators), the app will crash or fail to load the shared library.

✅ The Solution: Switch to bundle_e_sqlite3

To fix XA0141, you must switch your SQLite implementation provider.

The community and maintainers (notably within the sqlite-net ecosystem) have confirmed that:

• SQLitePCLRaw.bundle_e_sqlite3 version 2.1.10+

includes a libe_sqlite3.so binary compiled with the correct 16 KB alignment.

🧹 Step 1: Remove “Green” Dependencies

Check your .csproj file and remove any references to Green bundles or dynamic providers — these are the source of the incompatible binary.

❌ Remove these packages:

• SQLitePCLRaw.bundle_green
• SQLitePCLRaw.provider.dynamic_cdecl

📦 Step 2: Install the 16 KB-Compatible Bundle

Add the bundle_e_sqlite3 package.
⚠️ You must use version 2.1.10 or higher.

CLI Commands

dotnet add package sqlite-net-pcl --version 1.9.172
dotnet add package SQLitePCLRaw.bundle_e_sqlite3 --version 2.1.10

Or update your .csproj manually

<ItemGroup>
    <PackageReference Include="sqlite-net-pcl" Version="1.9.172" />
    <PackageReference Include="SQLitePCLRaw.bundle_e_sqlite3" Version="2.1.10" />
</ItemGroup>

🚀 Step 3: Initialize SQLite in MauiProgram.cs

Since you changed the underlying SQLite bundle, ensure the batteries are initialized correctly during app startup.

This guarantees that the app loads the bundled, aligned SQLite library instead of attempting to use a system version.

public static MauiApp CreateMauiApp()
{
    var builder = MauiApp.CreateBuilder();

    // ... configure fonts and services ...

    // ✅ Initialize SQLite
    // Loads the correct 16 KB-aligned libe_sqlite3.so
    SQLitePCL.Batteries_V2.Init();

    return builder.Build();
}

🎯 Verification Checklist

After applying the changes:

1. Clean and Rebuild your solution
2. Check the build logs
   • The XA0141 warning should be gone
3. Test on real targets
   • Android 15 emulator with 16 KB page size
   • Pixel 9 (or equivalent hardware)

Database operations should work normally without crashes or native load failures.

✅ Final Notes

By migrating to SQLitePCLRaw.bundle_e_sqlite3, your .NET MAUI application becomes fully compliant with Google’s new native code requirements for Android 16, ensuring stability, forward compatibility, and peace of mind.

Happy coding 🚀