.NET MAUI 10 Migration Plan

Updated: 2026-08-08 07:01 ET · Audited: 2026-06-26

TL;DR: The .NET MAUI 9 → 10 migration is complete: the app builds with 0 errors on iOS and Android (.NET 10.0 / MAUI 10.0.10) at 100% feature parity, and builds are in production testing via TestFlight and Google Play Internal Track. All breaking-change categories (async animation methods, ListView → CollectionView, DisplayAlertAsync, Page.IsBusy, MessagingCenter) are resolved; remaining items are deferred warnings, two open bugs, and the Android staged rollout. Live status lives on the board: Epic AB#1810 — .Net 10 (the 2026-02-24 status snapshot is preserved in its discussion).

Executive Summary

This document covers the completed migration of ALPA Mobile from .NET MAUI 9 to .NET MAUI 10. The migration addressed breaking changes (animation methods, ListView, MessagingCenter), deprecated APIs, third-party NuGet compatibility, and platform-specific changes (iOS trimmer, Android API 36).

Key results

• Application builds on both iOS and Android — 0 errors
• 100% feature parity maintained
• 4 iOS bugs + 5 Android bugs found and fixed during testing
• Deployed to TestFlight (build 20260220.2) and Google Play Internal Track
• Crash-free rate ≥ 99.5% — monitoring in production

Breaking Changes Resolved

1. Animation Methods (HIGH IMPACT) — Complete

All animation methods replaced with async variants. No explicit usage found in codebase — documented for future use.

2. ListView Deprecation (CRITICAL) — Complete

Commit 768aa21 — 3 files updated: PilotGroupHotelsPage, InternationalDirectoryPage, JumpseatFlightFinderResultsFiltersPage.

Pattern: replaced IsGroupingEnabled with IsGrouped, removed ViewCell wrappers, added SelectionMode="Single" and BoxView separators. Deprecated: ListView, EntryCell, ImageCell, SwitchCell, TextCell, ViewCell. Note: already using CollectionView in many places prior to migration (DocumentCenterPage, HomePage, FTDTCADutyPeriodDetailsPage, AppShell).

3. DisplayAlert / DisplayActionSheet (MEDIUM) — Complete

60+ DisplayAlert calls updated to DisplayAlertAsync across 21 files. No DisplayActionSheet instances found. All calls already used await — zero compiler errors introduced.

Files updated include: Services/Authentication.cs, Services/DataManager.cs, Services/SharedActionsService.cs, Pages/FTDTSplitDutyPeriodPage.xaml.cs, Pages/PushNotificationsSettingsPage.xaml.cs, ViewModels/LoginPageViewModel.cs (7 instances), ViewModels/SettingsPageViewModel.cs (11 instances), ViewModels/FTDTCADutyPeriodDetailsPageViewModel.cs (14 instances), and 13 more.

4. Page.IsBusy (MEDIUM) — Complete

Commit 0e6d7ef — 40 files updated (164 insertions, 164 deletions). Renamed IsBusy → IsLoading in BasePageViewModel and all consuming ViewModels/XAML. IsBusyIndicatorVisible in AutoLoginWebViewContentView was left unchanged (it is a separate custom bindable property).

5. MessagingCenter (MEDIUM) — Complete

No changes needed — codebase was already migrated to WeakReferenceMessenger (CommunityToolkit.Mvvm). Pattern: WeakReferenceMessenger.Default.Send(new MessageType(...)) / .Register<MessageType>(this, (r, m) => { }).

6. TableView (MEDIUM) — Complete

No <TableView> instances found in codebase — no migration needed.

7. Other APIs — Complete

• FontImageExtension → already using <FontImageSource> elements (17 files)
• ClickGestureRecognizer → already using TapGestureRecognizer
• Compatibility.Layout → not found in codebase

Platform-Specific Changes

Android

• API 36 (Android 16) is now the default target API
• Marshal methods enabled by default (performance improvement)
• Editor and Entry now use MauiAppCompatEditText
• Minimum API kept at 28 (Android 9.0); API 24 recommended to prevent desugaring runtime crashes
• JDK 21 support for builds

iOS

• iOS trimmer now enabled in more configurations (Simulator/arm64, Catalyst/arm64); warnings enabled by default
• SafeAreaEdges enum for granular safe-area control
• Secondary toolbar items now supported (Order="Secondary" → overflow menu)
• MT7158 duplicate MauiAsset warning for kcm_usage_procedures.pdf — fixed by removing redundant explicit include from ALPAMobile.csproj

New MAUI 10 Features Available

Build Results

Key warning categories: CS0618 (LayoutOptions.*AndExpand — deferred), CS0612 (Device.GetNamedSize — deferred), CS8622 (nullability in event handlers), NU1903 (transitive dependency vulnerability in Microsoft.Extensions.Caching.Memory 6.0.1).

Testing Results

iOS (TestFlight build 20260220.2)

33/33 tests complete. 4 bugs found and fixed:

Android (build 2798 / Pixel 9)

33/33 tests complete. 5 bugs found:

Technology Stack (as of 2026-08-08)

Live sources of truth: SDK version in global.json, MauiVersion in Directory.Build.props.

Platform:          .NET MAUI 10.0.60   (MauiVersion, Directory.Build.props)
SDK:               .NET 10.0.203       (global.json)
Target Frameworks: net10.0-ios, net10.0-android
iOS Minimum:       15.0
Android Minimum:   API 28 (Android 9.0)
Xcode:             16.4
Build System:      Azure DevOps Pipelines

Key Dependencies (as of 2026-08-08)

Live source of truth: ALPAMobile/ALPAMobile.csproj — check it for current versions.

Deprecated API Quick Reference

Remaining Open Items

• CS0618 warnings — LayoutOptions.*AndExpand usage should be migrated to Grid layouts (deferred, non-blocking)
• CS0612 warnings — Device.GetNamedSize usage in XAML should migrate to explicit font sizes (deferred)
• NU1903 — Microsoft.Extensions.Caching.Memory 6.0.1 transitive dependency vulnerability — investigate update path
• Bug #1882 — Android flight search swipe icon size (fix attempt 2 in progress)
• Bug #1840 — Auth guards for DocumentCenter (PR #1309 on hold)
• Performance baseline comparison (MAUI 9 vs 10 metrics not yet formally captured)
• Android production staged rollout (Internal Track → Production)

Cross-References