Xamarin.Forms → .NET MAUI Migration

For project templates, namespace tables, API deprecation tables, and reference code, see references/forms-migration-api.md.

⚠️ Do not use the .NET Upgrade Assistant. Apply namespace renames, project file updates, and package replacements directly. Build after each batch of changes and use compiler errors to guide the next round of fixes.

Migration Workflow

1. Create new .NET MAUI project (single-project — multi-project causes AOT/build errors)
2. Copy cross-platform code + platform code into Platforms/<platform>/
3. Update namespaces (XAML + C# + Essentials — see references/forms-migration-api.md)
4. Fix layout behavior changes (see below)
5. Migrate renderers → handlers (not shimmed renderers)
6. Migrate effects → behaviors
7. Remove Microsoft.Maui.Controls.Compatibility package
8. Update NuGet dependencies
9. Migrate app data stores
10. Delete bin//obj//Resource.designer.cs, build, test iteratively
11. Verify against .NET 10 deprecated API list