Xamarin.Android → .NET for Android Migration

For SDK-style project templates, MSBuild property tables, ABI conversion, namespace mappings, and CLI commands, see references/android-migration-api.md.

⚠️ Field-tested advice: Android migration is significantly harder than iOS. Expect more UI bugs, OEM-specific rendering differences, and issues not reproducible on emulators. Test on physical devices.

Migration Workflow

1. Create new .NET for Android project (dotnet new android)
2. Copy code and resources into the new project
3. Update MSBuild properties (see references/android-migration-api.md)
4. Update AndroidManifest.xml — remove <uses-sdk>, use csproj properties
5. Delete Resource.designer.cs (regenerated automatically)
6. Update NuGet dependencies
7. Migrate binding libraries (if applicable)
8. Replace Xamarin.Essentials with <UseMauiEssentials>true</UseMauiEssentials>
9. Handle encoding changes