A Microsoft open-source framework for building native device applications spanning mobile, tablet, and desktop.
Yes. In this scenario, increasing the minimum Android version is the required fix.
The build error is expected because a referenced Android library declares minSdkVersion 23, so the app cannot ship with minSdkVersion 21. The warning from Google Play is therefore a consequence of raising the app’s minimum supported Android version.
For modern .NET Android and .NET MAUI projects, the minimum Android version should be set in the project file with SupportedOSPlatformVersion, rather than relying on <uses-sdk/> in AndroidManifest.xml. That value maps to android:minSdkVersion at build time.
Use a project setting like this in the Android target:
<PropertyGroup>
<TargetFramework>net10.0-android</TargetFramework>
<SupportedOSPlatformVersion>23</SupportedOSPlatformVersion>
</PropertyGroup>
If android:minSdkVersion is also set manually in AndroidManifest.xml, it must match the project setting. Keeping conflicting values in the manifest can cause build or packaging problems.
About the affected users:
- Users on devices below the new minimum version will not be able to install new updates.
- Existing users on those unsupported devices can continue using the version already installed, but they will not receive future app updates.
- The recommended action is to notify those users that newer app versions require a newer Android OS.
This is consistent with platform guidance that when the minimum supported Android API level is raised, apps can no longer be installed or run on devices below that level, and users should be informed when updates are no longer available for older Android versions.
So the practical path is:
- Set the MAUI project minimum Android version to
23in the.csproj. - Remove or align any
<uses-sdk/>entry inAndroidManifest.xml. - Rebuild and upload the new AAB.
- Inform users on Android versions below API 23 that they must upgrade the device OS to receive future app updates.
Using tools:overrideLibrary does not change the fact that the dependency itself requires a higher minimum SDK. The supported app minimum must still be compatible with the libraries included in the app.