xamarin-android-migration

What problem does it solve?

This Skill provides a practical, step-by-step workflow and checklist to migrate Xamarin.Android native applications to .NET for Android, reducing build errors, runtime encoding issues, and platform-specific UI surprises during upgrades.

Core Features & Use Cases

• SDK-style project conversion: guidance for creating a new dotnet android project, mapping old csproj properties to the new TargetFramework and SupportedOSPlatformVersion.
• MSBuild and ABI mapping: convert AndroidSupportedAbis into RuntimeIdentifiers and update AOT and debug settings for .NET for Android.
• Manifest, NuGet, and binding library migration: remove uses-sdk from AndroidManifest.xml, update NuGet dependencies, and migrate or recreate binding libraries using the android-bindinglib template.
• Platform gotchas and testing guidance: explains encoding changes, Essentials initialization and permission handling, and the importance of testing on physical devices across OEMs.
• Use Case: upgrade a legacy Xamarin.Android app to net8.0-android, recompile dependencies if needed, and resolve binding library issues while preparing release artifacts.

Quick Start

Ask the skill to migrate my Xamarin.Android project by creating a new .NET for Android project, copying source and resources, updating MSBuild properties and the AndroidManifest, converting ABIs to RuntimeIdentifiers, deleting Resource.designer.cs, updating NuGet packages, and testing the build on physical devices.