Releases: dotnet/maui
11.0.0-preview.5.26304.4
Workloads
Workload Set: Microsoft.NET.Workloads.11.0.100-preview.5 @ 11.0.100-preview.5.26309.3
Installation
dotnet workload update --version 11.0.100-preview.5.26309.3
# Or install specific workloads
dotnet workload install maui ios maccatalyst android --version 11.0.100-preview.5.26309.3Recommended Tools:
- Xcode: 26.5
- Java JDK: 21.0.8
- Android API-36
Workload Versions
| Workload | Full ID | Version | SDK Band | Links |
|---|---|---|---|---|
| MAUI | Microsoft.NET.Sdk.Maui | 11.0.0-preview.5.26304.4 | 11.0.100-preview.5 | NuGet · Release |
| iOS | Microsoft.NET.Sdk.iOS | 26.5.11546-net11-p5 | 11.0.100-preview.5 | NuGet · Release |
| Mac Catalyst | Microsoft.NET.Sdk.MacCatalyst | 26.5.11546-net11-p5 | 11.0.100-preview.5 | NuGet · Release |
| Android | Microsoft.NET.Sdk.Android | 36.99.0-preview.5.308 | 11.0.100-preview.5 | NuGet · Release |
| tvOS | Microsoft.NET.Sdk.tvOS | 26.5.11546-net11-p5 | 11.0.100-preview.5 | NuGet · Release |
| macOS | Microsoft.NET.Sdk.macOS | 26.5.11546-net11-p5 | 11.0.100-preview.5 | NuGet · Release |
MAUI NuGet Packages
The following NuGet packages are the core .NET MAUI libraries. The Implicit Version is bundled with the workload, while Latest Version may be newer due to out-of-band releases.
| Package | Implicit Version | Latest Version |
|---|---|---|
| Microsoft.Maui.Controls | 11.0.0-preview.5.26304.4 | 11.0.0-preview.5.26304.4 |
| Microsoft.Maui.Controls.Compatibility | 11.0.0-preview.5.26304.4 | 11.0.0-preview.5.26304.4 |
| Microsoft.Maui.Essentials | 11.0.0-preview.5.26304.4 | 11.0.0-preview.5.26304.4 |
| Microsoft.Maui.Graphics | 11.0.0-preview.5.26304.4 | 11.0.0-preview.5.26304.4 |
| Microsoft.Maui.Maps | 11.0.0-preview.5.26304.4 | 11.0.0-preview.5.26304.4 |
Native Tool & SDK Compatibility
Apple (iOS, Mac Catalyst, tvOS, macOS)
| Tool | Min Version | Recommended Version |
|---|---|---|
| Xcode | ≥ 26.5 | 26.5 |
Java JDK (Android)
| Tool | Min / Required Version | Recommended Version |
|---|---|---|
| Java JDK | ≥ 21.0 and < 22.0 | 21.0.8 |
Android SDK Packages (Required)
| SDK Package | Description |
|---|---|
build-tools;36.0.0 |
Android SDK Build-Tools 36 |
cmdline-tools;19.0 |
Android SDK Command-line Tools (latest) |
platforms;android-36 |
Android SDK Platform 36 |
platform-tools |
Android SDK Platform-Tools 36.0.0 |
Android SDK Packages (Optional)
| Package | Description |
|---|---|
emulator |
Android Emulator (recommended 36.2.12) |
ndk-bundle |
NDK (recommended 27.2.12479018) |
| System Images | Google APIs ARM 64 v8a / x86_64 (system-images;android-36.1;google_apis;...) |
MAUI Windows Dependencies
| Dependency | Minimum Version | Recommended |
|---|---|---|
| Windows App SDK | ≥ 1.8.251106002 | 1.8.251106002 |
| Windows SDK Build Tools | ≥ 10.0.26100.4654 | 10.0.26100.4654 |
| Win2D | ≥ 1.3.2 | 1.3.2 |
| WebView2 | ≥ 1.0.3179.45 | 1.0.3179.45 |
✨ New in .NET 11
The following 22 features and changes are unique to .NET 11 and not yet in the main branch:
Animation
- Add CancellationToken support to animation methods in ViewExtensions by @StephaneDelcroix in #33372
Checkbox
-
[net11.0] Workaround #35665: use DI handler registration for CheckBox by @simonrozsival in #35666
Docs
- Fix SafeAreaEdges comments and access modifiers by @jeremy-visionaid in #34397
Drawing
-
[NET11.0] Provided Fill property support for BoxView control by @NirmalKumarYuvaraj in #31789
Navigation
-
[Enhancement]Add accessibility label support for toolbar back button by @Vignesh-SF3580 in #35011
Toolbar
- Fix iOS toolbar empty badge indicator by @jfversluis in #35504
🔧 Infrastructure (7)
- [net11.0] Update dependencies from dotnet/android, dotnet/dotnet, dotnet/macios by @dotnet-maestro[bot] in #34552
- [net11.0] Use Azure Artifacts feed only in CI, standard repos locally by @Tamilarasan-Paranthaman in #35518
- [release/11.0.1xx-preview5] Update dependencies from dotnet/android, dotnet/dotnet by @dotnet-maestro[bot] in #35718
- Increment PreReleaseVersionIteration from 4 to 5 by @PureWeen in #35721
- [ci] Use macOS 26 hosted image for preview5 by @PureWeen in #35723
- Update dotnet/dotnet dependencies to 11.0.100-preview.5.26302.115 by @PureWeen in #35769
- Backport simulator runtime provisioning fix by @PureWeen in #35773
🧪 Testing (2)
- [Testing] Fixed test failure in net11 branch by @TamilarasanSF4853 in #35225
- [Testing] Fixed test failure in net11 branch - 2 by @TamilarasanSF4853 in #35345
🏠 Housekeeping (1)
- [Housekeeping] Remove hardcoded net10 TargetFramework values by @NirmalKumarYuvaraj in #35515
📦 Other (6)
-
Remove IsTrimmable=false from assemblies that are already AotCompatible by @kotlarmilos in #34573
-
Merge release/11.0.1xx-preview4 into net11.0 by @PureWeen in #35330
-
[Material3] Expose Material Handlers and Helpers as Public by @Dhivya-SF4094 in #35323
-
[automated] Merge branch 'main' => 'net11.0' by @github-actions[bot] in #35422
-
[net11.0] Bump Android SupportedOSPlatformVersion from 23 to 24 by @sbomer in #35452
-
Don't change the default trimming for iOS and Mac Catalyst when using CoreCLR. by @rolfbjarne in #35311
10.0.71
What's Changed
- [release/10.0.1xx-sr7] [Windows] Fix WebView blank rendering when used with HybridWebView by @kubaflo in #35585
- [release/10.0.1xx-sr7] Revert PR #30068 — Fix FontImageSource centering regression on Windows by @kubaflo in #35689
- [release/10.0.1xx-sr7] Fix iOS/Catalyst MapPool retention with MapElements by @kubaflo in #35690
- [release/10.0.1xx-sr7] [iOS] Fix Shell - opened keyboard on modal page shifts parent page/frame behind modal after update to 10.0.60 by @kubaflo in #35691
- [release/10.0.1xx-sr7] [Android] Fix BottomNavigationView remaining visible for TabbedPage inside modal NavigationPage after PushAsync by @kubaflo in #35692
- [release/10.0.1xx-sr7] Gate SafeArea inset listeners in recycler items by @kubaflo in #35693
- [release/10.0.1xx-sr7] Revert - Fix TalkBack not correctly narrating RadioButtons with Content by @kubaflo in #35694
- [release/10.0.1xx-sr7] Revert - Fix Changing Shell.NavBarIsVisible does not update the nav bar by @Tamilarasan-Paranthaman in #35703
- [Revert] - [Windows] Fix WebView blank rendering when used with HybridWebView by @SubhikshaSf4851 in #35744
- Fix OnNavigatedTo not firing after PopModalAsync when tab is changed inside modal by @praveenkumarkarunanithi in #35768
- Increment patch version from 70 to 71 by @PureWeen in #35786
Full Changelog: 10.0.70...10.0.71
10.0.70
What's Changed
.NET MAUI 10.0.70 introduces significant improvements across all platforms with focus on quality, performance, and developer experience. This release includes 135 commits with various improvements, bug fixes, and enhancements.
Ai Agents
-
[CI] Extend gate to all test types and decouple from PR review by @kubaflo in #34705
-
Integrate UI test category detection into PR review and fix gate reliability by @kubaflo in #35133
API
Blazor
-
Fix: Filter precompressed RCL assets from MAUI Blazor Hybrid APKs by @mattleibow in #33917
-
[Windows] Fix for Runtime error when closing external window with WPF Webview Control by @BagavathiPerumal in #34006
Button
-
[Android] ImageButton CornerRadius not being applied - fix by @kubaflo in #30074
-
Fix Disabled visual state ignored when Button has locally-set BackgroundColor/TextColor by @Dhivya-SF4094 in #34444
CollectionView
-
Fix CollectionView grid spacing updates for first row and column by @KarthikRajaKalaimani in #34527
-
Fix CollectionView record struct selection on Windows by @jeremy-visionaid in #33488
-
[Android] Ensure disconnected ItemsViewHandler doesn't hold onto the items source by @filipnavara in #24610
-
[Windows] Fixed VisualState Setters not working properly for CollectionView by @Dhivya-SF4094 in #27230
-
[Windows] Fixed Margin doesn't work inside CollectionView EmptyView by @Dhivya-SF4094 in #29897
-
[Android, Windows] Fix CarouselView PreviousPosition/PreviousItem incorrect during animated ScrollTo() by @praveenkumarkarunanithi in #34570
-
[iOS] CarouselView2: Update internal scroll indicators for compositional layout by @SubhikshaSf4851 in #33639
-
[CarouselViewHandler2] Fir fox CurrentItem does not work when ItemSpacing is set by @SyedAbdulAzeemSF4852 in #32135
-
[iOS] Fix for Incorrect Scroll in Loop Mode When CurrentItem Is Not Found in ItemsSource by @SyedAbdulAzeemSF4852 in #32141
-
[Android] IndicatorView: Add TalkBack accessibility descriptions for indicators by @praveenkumarkarunanithi in #31775
-
[iOS, macOS] Fixed CollectionView KeepLastItemInView Not Updating Correctly When Items Are Added Dynamically by @NanthiniMahalingam in #32191
-
[Windows, Android] Resolved issue with dynamic Header/Footer reassignment in CollectionView. by @prakashKannanSf3972 in #28403
-
[Android] Fix CollectionView inside disabled RefreshView blocks scroll by @Vignesh-SF3580 in #34702
-
[Android] CollectionView: Fix SelectedItem visual state not applying when re-selecting same item by @KarthikRajaKalaimani in #31591
-
[Windows] Fixed CollectionView.EmptyView can not be removed by setting it to Null by @Dhivya-SF4094 in #29487
-
[iOS] Support for IsSwipeEnabled on CarouselView2 by @kubaflo in #29996
-
[iOS, MacOS] Fixed FlowDirection not working on Header/Footer in CollectionView by @Dhivya-SF4094 in #32775
-
[iOS] CollectionView: Fix drag-and-drop reordering into empty groups by @SuthiYuvaraj in #34151
-
[Android] CollectionView: Fix drag-and-drop reordering into empty groups by @SuthiYuvaraj in #31867
-
[iOS] Fix vertical CarouselView MandatorySingle snapping on iOS by @Vignesh-SF3580 in #34700
-
[iOS26] Fix CarouselView scrolling to wrong item when navigating to last item by @Vignesh-SF3580 in #34013
-
Fixed the OnPlatform does not work for header pr...
11.0.0-preview.4.26230.3
Workloads
Workload Set: Microsoft.NET.Workloads.11.0.100-preview.4 @ 11.0.100-preview.4.26254.1
Installation
dotnet workload update --version 11.0.100-preview.4.26254.1
# Or install specific workloads
dotnet workload install maui ios maccatalyst android --version 11.0.100-preview.4.26254.1Recommended Tools:
- Xcode: 26.4
- Java JDK: 21.0.8
- Android API-36
Workload Versions
| Workload | Full ID | Version | SDK Band | Links |
|---|---|---|---|---|
| MAUI | Microsoft.NET.Sdk.Maui | 11.0.0-preview.4.26230.3 | 11.0.100-preview.4 | NuGet · Release |
| iOS | Microsoft.NET.Sdk.iOS | 26.4.11514-net11-p4 | 11.0.100-preview.4 | NuGet · Release |
| Mac Catalyst | Microsoft.NET.Sdk.MacCatalyst | 26.4.11514-net11-p4 | 11.0.100-preview.4 | NuGet · Release |
| Android | Microsoft.NET.Sdk.Android | 36.99.0-preview.4.137 | 11.0.100-preview.4 | NuGet · Release |
| tvOS | Microsoft.NET.Sdk.tvOS | 26.4.11514-net11-p4 | 11.0.100-preview.4 | NuGet · Release |
| macOS | Microsoft.NET.Sdk.macOS | 26.4.11514-net11-p4 | 11.0.100-preview.4 | NuGet · Release |
MAUI NuGet Packages
The following NuGet packages are the core .NET MAUI libraries. The Implicit Version is bundled with the workload, while Latest Version may be newer due to out-of-band releases.
| Package | Implicit Version | Latest Version |
|---|---|---|
| Microsoft.Maui.Controls | 11.0.0-preview.4.26230.3 | 11.0.0-preview.4.26230.3 |
| Microsoft.Maui.Controls.Compatibility | 11.0.0-preview.4.26230.3 | 11.0.0-preview.4.26230.3 |
| Microsoft.Maui.Essentials | 11.0.0-preview.4.26230.3 | 11.0.0-preview.4.26230.3 |
| Microsoft.Maui.Graphics | 11.0.0-preview.4.26230.3 | 11.0.0-preview.4.26230.3 |
| Microsoft.Maui.Maps | 11.0.0-preview.4.26230.3 | 11.0.0-preview.4.26230.3 |
Native Tool & SDK Compatibility
Apple (iOS, Mac Catalyst, tvOS, macOS)
| Tool | Min Version | Recommended Version |
|---|---|---|
| Xcode | ≥ 26.4 | 26.4 |
Java JDK (Android)
| Tool | Min / Required Version | Recommended Version |
|---|---|---|
| Java JDK | ≥ 21.0 and < 22.0 | 21.0.8 |
Android SDK Packages (Required)
| SDK Package | Description |
|---|---|
build-tools;36.0.0 |
Android SDK Build-Tools 36 |
cmdline-tools;19.0 |
Android SDK Command-line Tools (latest) |
platforms;android-36 |
Android SDK Platform 36 |
platform-tools |
Android SDK Platform-Tools 36.0.0 |
Android SDK Packages (Optional)
| Package | Description |
|---|---|
emulator |
Android Emulator (recommended 36.2.12) |
ndk-bundle |
NDK (recommended 27.2.12479018) |
platforms;android-37.0 |
Android SDK Platform 37.0 (Preview) |
| System Images | Google APIs ARM 64 v8a / x86_64 (system-images;android-36.1;google_apis;...) |
MAUI Windows Dependencies
| Dependency | Minimum Version | Recommended |
|---|---|---|
| Windows App SDK | ≥ 1.8.251106002 | 1.8.251106002 |
| Windows SDK Build Tools | ≥ 10.0.26100.4654 | 10.0.26100.4654 |
| Win2D | ≥ 1.3.2 | 1.3.2 |
| WebView2 | ≥ 1.0.3179.45 | 1.0.3179.45 |
✨ New in .NET 11
The following 19 features and changes are unique to .NET 11 and not yet in the main branch:
Blazor
-
Refresh Blazor Hybrid templates to align with .NET 11 Blazor Web App template updates by @ilonatommy in #34945
Docs
- Fix XML doc build suggestions for enum remarks and unresolved inheritdoc by @jfversluis in #34895
Editor
-
[NET11.0][Editor] Implemented Completed command by @NirmalKumarYuvaraj in #32167
🔧 Fixes
Map
-
Fix NullReferenceException when tapping Map with no overlays on iOS by @jfversluis in #34969
Shell
-
Add Shell badge support (BadgeText, BadgeColor, BadgeTextColor) by @jfversluis in #34659
🔧 Fixes
-
Add BadgeText, BadgeColor, and BadgeTextColor support to ToolbarItem by @jfversluis in #34669
🔧 Fixes
Single Project
-
Add MonochromeFile support for Android adaptive icons by @jfversluis in #34569
Toolbar
WebView
-
Fix HybridWebView NativeAOT warning path by @simonrozsival in #34958
-
Move HybridWebView AOT helper from local function to private static method by @PureWeen in #34986
🔧 Infrastructure (4)
- [net11.0] Update dependencies to preview.3 build 26202.110 by @PureWeen in #34852
- [release/11.0.1xx-preview4] Use Azure Artifacts Maven feed for CFSClean network isolation compliance by @PureWeen in #35170
- [release/11.0.1xx-preview4] Update dependencies from dotnet/android, dotnet/dotnet by @dotnet-maestro[bot] in #35171
- [release/11.0.1xx-preview4] Update dependencies from dotnet/dotnet, dotnet/macios by @dotnet-maestro[bot] in #35271
📦 Other (5)
- Fix duplicate issue number crash breaking all Windows UI tests by @jfversluis in #34991
- Pin iOS simulator version to match selected Xcode in provisioning by @PureWeen in #34978
- Update PreReleaseVersionIteration to 4 by @PureWeen in #35014
- [automated] Merge branch 'main' => 'net11.0' by @github-actions[bot] in #35091
- [net11.0][NativeAOT] Hook _PrepareTrimConfiguration to fix IL3050 on Android by @sbomer in #35094
Additional Changes
The following changes are also present in the main branch:
Ai Agents
-
Add eval.yaml for verify-tests-fail-without-fix skill by @PureWeen in #34815
-
[CI] Extend gate to all test types and decouple from PR review by @kubaflo in https://github.com/dotnet/maui...
.NET 10 SR6 10.0.60
What's Changed
.NET MAUI 10.0.60 introduces significant improvements across all platforms with focus on quality, performance, and developer experience. This release includes 242 commits with various improvements, bug fixes, and enhancements.
Ai Agents
Blazor
- [blazorwebview] align
SupportedOSPlatformattribute with templates by @jonathanpeppers in #25073
Border
-
[Testing] Refactoring Feature Matrix UITest Cases for Border Control by @HarishKumarSF4517 in #34349
-
Fix LayoutCycleException from nested Borders on Windows by @Oxymoron290 in #34337
Button
-
[iOS] Button RTL text and image overlap - fix by @kubaflo in #29041
-
[Android] Button with corner radius shadow broken on Android device - fix by @kubaflo in #29339
-
[iOS] Preserve AlwaysTemplate rendering mode in Button.ResizeImageIfNecessary by @kubaflo in #25107
-
[Android] Implemented Material3 support for ImageButton by @Dhivya-SF4094 in #33649
-
Fixed CI failure : Restore BackButtonBehavior IsEnabled after CanExecute changes by @Shalini-Ashokan in #34668
Checkbox
-
[iOS/MacCatalyst] Fix CheckBox foreground color not resetting when set to null by @Ahamed-Ali in #34284
CollectionView
-
[Android] Fix CollectionView selection crash with HeaderTemplate by @NirmalKumarYuvaraj in #34275
-
[Windows] Fixed CollectionView with grouping fails to add items when a footer template is present or crashes when removing data. by @NirmalKumarYuvaraj in #24867
🔧 Fixes
- [Windows] CollectionView with grouping fails to add items when a footer template is present or crashes when removing data.
- [Windows] CollectionView Not Updating Correctly When Adding Items or Groups
- Using CollectionView IsGrouped="True" bound to ObservableCollection causes crash
- .net 8 CollectionView Group Add method issue
-
[iOS] Label LinebreakMode (TailTruncation) for FormattedText does't work in CollectionView after scroll - fix by @kubaflo in #28151
-
[iOS] Fix CollectionView excessive height when ObservableCollection source loads with delay by @Vignesh-SF3580 in #34424
-
[Android] Fix CollectionView sizing when wrapped in RefreshView by @Dhivya-SF4094 in #34387
-
[iOS] Fix CollectionView horizontal scroll when empty inside RefreshView by @praveenkumarkarunanithi in #34382
-
[iOS/Mac] CollectionView: Fix incorrect ItemsViewScrolledEventArgs indices with grouped items by @SyedAbdulAzeemSF4852 in #34240
-
[iOS] Fix for CollectionView.Measure() returning incorrect height when called before the view is mounted by @BagavathiPerumal in #34331
-
[Android] Fix for CollectionView EmptyView swaps reusing stale RecyclerView item holders by @BagavathiPerumal in #34452
-
[Android, iOS] Fix for ContentView not clearing its Background when set to null by @SyedAbdulAzeemSF4852 in #31340
-
[Android] Fix for Android TalkBack announcing CollectionView items as clickable when SelectionMode is None by @praveenkumarkarunanithi in #31516
-
[iOS] Fix indicator dots not rendering when using indicator size with shadow by @Shalini-Ashokan in #31463
-
[Android] Fix for ArgumentOutOfRangeException thrown by ScrollTo when an invalid group index is specified by @SyedAbdulAzeemSF4852 in #31553
-
[Android] - Fix Inconsistent Footer Scrolling Behaviour in CollectionView with EmptyView by @prakashKannanSf3972 in #28107
-
[Android] CollectionView: Defer RemainingItemsThresholdReached to avoid RecyclerView scroll callback warnings by @NirmalKumarYuvaraj in #30907
-
[iOS] Fix incorrect FirstVisibleItemIndex reported by CollectionView.Scrolled after programmatic scroll by @Shalini-Ashokan in #33719
-
[Android] CarouselView incorrectly reads out "double tap to activate" - fix by @kubaflo in #31418
-
IndicatorView: Fix MaximumVisible not respected when using custom IndicatorTemplate by @SyedAbdulAzeemSF4852 in #31469
-
[iOS] Fix for CarouselView remains interactive when disabled by @SyedAbdulAzeemSF4852 in #32794
11.0.0-preview.3.26203.7
What's Changed
.NET MAUI 11.0.0-preview.3 introduces significant improvements across all platforms with focus on quality, performance, and developer experience. This release includes 226 commits with various improvements, bug fixes, and enhancements.
Workloads
Workload Set: Microsoft.NET.Workloads.11.0.100-preview.3 @ 11.0.100-preview.3.26213.1
Installation
dotnet workload update \
--version 11.0.100-preview.3.26213.1 \
--source https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet-workloads/nuget/v3/index.json
# Or install specific workloads
dotnet workload install maui ios maccatalyst android \
--version 11.0.100-preview.3.26213.1 \
--source https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet-workloads/nuget/v3/index.jsonRecommended Tools:
- Xcode: 26.3
- Java JDK: 21.0.8
- Android API-36
Workload Versions
| Workload | Full ID | Version | SDK Band | Links |
|---|---|---|---|---|
| MAUI | Microsoft.NET.Sdk.Maui | 11.0.0-preview.3.26203.7 | 11.0.100-preview.3 | NuGet · Release |
| iOS | Microsoft.NET.Sdk.iOS | 26.2.11588-net11-p3 | 11.0.100-preview.3 | NuGet · Release |
| Mac Catalyst | Microsoft.NET.Sdk.MacCatalyst | 26.2.11588-net11-p3 | 11.0.100-preview.3 | NuGet · Release |
| Android | Microsoft.NET.Sdk.Android | 36.99.0-preview.3.10 | 11.0.100-preview.3 | NuGet · Release |
| tvOS | Microsoft.NET.Sdk.tvOS | 26.2.11588-net11-p3 | 11.0.100-preview.3 | NuGet · Release |
| macOS | Microsoft.NET.Sdk.macOS | 26.2.11588-net11-p3 | 11.0.100-preview.3 | NuGet · Release |
MAUI NuGet Packages
The following NuGet packages are the core .NET MAUI libraries. The Implicit Version is bundled with the workload, while Latest Version may be newer due to out-of-band releases.
| Package | Implicit Version | Latest Version |
|---|---|---|
| Microsoft.Maui.Controls | 11.0.0-preview.3.26203.7 | 11.0.0-preview.3.26203.7 |
| Microsoft.Maui.Controls.Compatibility | 11.0.0-preview.3.26203.7 | 11.0.0-preview.3.26203.7 |
| Microsoft.Maui.Essentials | 11.0.0-preview.3.26203.7 | 11.0.0-preview.3.26203.7 |
| Microsoft.Maui.Graphics | 11.0.0-preview.3.26203.7 | 11.0.0-preview.3.26203.7 |
| Microsoft.Maui.Maps | 11.0.0-preview.3.26203.7 | 11.0.0-preview.3.26203.7 |
Native Tool & SDK Compatibility
Apple (iOS, Mac Catalyst, tvOS, macOS)
| Tool | Min Version | Recommended Version |
|---|---|---|
| Xcode | ≥ 26.3 | 26.3 |
Java JDK (Android)
| Tool | Min / Required Version | Recommended Version |
|---|---|---|
| Java JDK | ≥ 21.0 and < 22.0 | 21.0.8 |
Android SDK Packages (Required)
| SDK Package | Description |
|---|---|
build-tools;36.0.0 |
Android SDK Build-Tools 36 |
cmdline-tools;19.0 |
Android SDK Command-line Tools |
platforms;android-36 |
Android SDK Platform 36 |
platform-tools |
Android SDK Platform-Tools 36.0.0 |
Android SDK Packages (Optional)
| Package | Description |
|---|---|
emulator |
Android Emulator |
ndk-bundle |
NDK |
platforms;android-37 |
Android SDK Platform (Preview) |
| System Images | Google APIs ARM 64 v8a / x86_64 |
MAUI Windows Dependencies
| Dependency | Minimum Version | Recommended |
|---|---|---|
| Windows App SDK | ≥ 1.8.251106002 | 1.8.251106002 |
| Windows SDK Build Tools | ≥ 10.0.26100.4654 | 10.0.26100.4654 |
| Win2D | ≥ 1.3.2 | 1.3.2 |
| WebView2 | ≥ 1.0.3179.45 | 1.0.3179.45 |
✨ New in .NET 11
The following 76 features and changes are unique to .NET 11 and not yet in the main branch:
Animation
-
[Android] Fixed TransformProperties issue when a wrapper view is present by @Ahamed-Ali in #29228
API
-
Fix misplaced #nullable enable in Maps PublicAPI.Unshipped.txt files by @StephaneDelcroix in #34320
-
Add android-36.1 and android-37 to SDK provisioning API levels by @PureWeen in #34806
BlazorWebView
-
[net11] Templates: Fix duplicate Empty/empty parameter crash in maui-blazor templates by @mattleibow via @Copilot in #34609
-
[release/11.0.1xx-preview3] [net11] Templates: Fix duplicate Empty/empty parameter crash in maui-blazor templates by @github-actions[bot] in #34646
Button
-
Fix ImageButton not rendering correctly based on its bounds by @Shalini-Ashokan in #28309
CollectionView
-
[Android] Fixed issue where group Header/Footer template was applied to all items when IsGrouped was true for an ObservableCollection by @Tamilarasan-Paranthaman in #28886
-
[Android] CollectionView: Fix reordering when using DataTemplateSelector by @NanthiniMahalingam in #32349
-
[Android] Fix for incorrect scroll position when using ScrollTo with a header in CollectionView by @SyedAbdulAzeemSF4852 in #30966
-
Fix Incorrect Scrolling Behavior in CollectionView ScrollTo Method Using Index Value by @Shalini-Ashokan in #27246
-
[Android] Fix System.IndexOutOfRangeException when scrolling CollectionView with image CarouselView by @devanathan-vaithiyanathan in #31722
-
[Android] Fix VerticalOffset Update When Modifying CollectionView.ItemsSource While Scrolled by @devanathan-vaithiyanathan in #26782
Docs
- Remove build status badges from README by @jfversluis in #34282
Editor
-
Fixed Editor vertical text alignment not working after toggling IsVisible by @NanthiniMahalingam in #26194
🔧 Fixes
- [Editor vertical text alignment not working after togglin...
10.0.51 SR5.1
What's Changed
- Increment patch version from 50 to 51 by @PureWeen in #34458
- [release/10.0.1xx-sr5] [Regression] Fix TypedBinding nested property re-subscription (#34428) by @github-actions[bot] in #34450
- [backport 10.0.1xx-sr5] Fix MAUIG2045 false positive with x:Reference source in DataTemplate by @StephaneDelcroix in #34525
Full Changelog: 10.0.50...10.0.51
10.0.50 S5
What's Changed
.NET MAUI 10.0.50 introduces significant improvements across all platforms with focus on quality, performance, and developer experience. This release includes 78 commits with various improvements, bug fixes, and enhancements.
AI
-
Enable packing and independent preview versioning for Essentials.AI by @mattleibow in #33976
-
Move Essentials.AI preview iteration to eng/Versions.props by @mattleibow in #34025
-
[Feature] Add Microsoft.Maui.Essentials.AI - Apple Intelligence by @mattleibow in #33519
-
[AI] Fix multi-turn tool calling, add chat overlay, upgrade Agent Framework to rc2, and add CI pipelines by @mattleibow in #34124
Ai Agents
-
Copilot agent infrastructure, emulator reliability, and try-fix workflow improvements by @PureWeen via @Copilot in #33937
-
Update PR agent models to claude-sonnet-4.6 and gpt-5.3-codex by @kubaflo in #34109
-
ci-copilot: set pipeline run title early using build.updatebuildnumber by @jfversluis via @Copilot in #34156
-
Revamp find-reviewable-pr skill: priorities, defaults, and doc fixes by @PureWeen in #34160
-
Add correct CI pipeline names to Copilot instructions by @jfversluis in #34255
-
Add resilience to UI tests for frozen/unresponsive apps by @PureWeen in #34023
-
Copilot CI: Structured phase outputs, autonomous execution, iOS support, and CI pipeline by @kubaflo in #34040
-
Agent Workflow Metrics via GitHub Labels by @kubaflo in #33986
Animation
-
[Android] Fixed TransformProperties issue when a wrapper view is present by @Ahamed-Ali in #29228
API
- Add PublicAPI.Unshipped.txt BOM sort warning to Copilot instructions by @jfversluis in #34327
Button
-
Fix ImageButton not rendering correctly based on its bounds by @Shalini-Ashokan in #28309
CollectionView
-
[Android] Fixed issue where group Header/Footer template was applied to all items when IsGrouped was true for an ObservableCollection by @Tamilarasan-Paranthaman in #28886
-
[Android] CollectionView: Fix reordering when using DataTemplateSelector by @NanthiniMahalingam in #32349
-
[Android] Fix for incorrect scroll position when using ScrollTo with a header in CollectionView by @SyedAbdulAzeemSF4852 in #30966
-
Fix Incorrect Scrolling Behavior in CollectionView ScrollTo Method Using Index Value by @Shalini-Ashokan in #27246
-
[Android] Fix System.IndexOutOfRangeException when scrolling CollectionView with image CarouselView by @devanathan-vaithiyanathan in #31722
-
[Android] Fix VerticalOffset Update When Modifying CollectionView.ItemsSource While Scrolled by @devanathan-vaithiyanathan in #26782
Docs
-
Minor API docs improvements by @jfversluis in #34091
-
Fix phase numbering in pr-agent post-gate docs by @PureWeen in #34116
-
[docs] Add concise maui CLI command reference by @rmarinho in #34217
-
Remove build status badges from README by @jfversluis in #34282
Drawing
-
[Android] Fix crash in GraphicsView when using TapGestureRecognizer by @jpd21122012 in #34301
Editor
-
Fixed Editor vertical text alignment not working after toggling IsVisible by @NanthiniMahalingam in #26194
Entry
-
[Android, iOS, Mac] Fixed Entry ClearButton not visible on dark theme Change by @TamilarasanSF4853 in #32889
-
[Android] Fix Numeric Entry not accepting the appropriate Decimal Separator by @devanathan-vaithiyanathan in #27376
-
[Android & iOS] Entry/Editor: Dismiss keyboard when control becomes invisible by @prakashKannanSf3972 in #27340
Gestures
-
[Android] Fixed PointerGestureRecognizer not triggering PointerMoved event by @KarthikRajaKalaimani in #33889
-
[Android] Fix PointerMoved and PointerReleased not firing in PointerGestureRecognizer by @KarthikRajaKalaimani in #34209
Label
-
[Android] Fix Label with MaxLines truncating text in horizontal ScrollView by @Vignesh-SF3580 in #34279
-
Update PreReleaseVersionLabel and StabilizePackageVersion by @PureWeen in #34371
Navigation
-
[Android] Shell: Fix OnBackButtonPressed not firing for navigation bar back button by @kubaflo in #33531
Packaging
Performance
- Improve TypedBinding performance by ~29% by @StephaneDelcroix in #33656
ProgressBar
- Fix dogfood scripts: workflow trigger, build detection, and in-progress handling by @jfversluis in #34259
SafeArea
-
[iOS] Fix SafeArea infinite layout cycle with parent hierarchy walk and pixel-level comparison by @PureWeen in #34024
🔧 Fixes
- Layout issue using TranslateToAsync causes infinite property changed cycle on iOS
- [iOS] TranslateToAsync causes spurious SizeChanged events after animation completion, triggering infinite layout loops
- [net10] iOS 18.6 crashing on navigating to a ContentPage with Padding set and Content set to a with ScrollView on row 0
- Infinite Measure Looping on iOS
Shapes
- [ci] Fix simulator install failures and artifact publishing for all pipeline types by @mattleibow in #33999
Shell
- [iOS] Fixed Shell Navigating event showing same current and target value...
11.0.0-preview.2.26152.10
✨ New in .NET 11
The following 70 features and changes are unique to .NET 11 and not yet in the main branch:
AI
-
[Sample] Add Microsoft.Maui.Essentials.AI sample app with multi-agent workflow by @mattleibow in #33610
-
Enable packing and independent preview versioning for Essentials.AI by @mattleibow in #33976
-
Move Essentials.AI preview iteration to eng/Versions.props by @mattleibow in #34025
Ai Agents
-
Remove Phase 2 (Tests) from PR agent workflow by @kubaflo in #33905
-
Copilot agent infrastructure, emulator reliability, and try-fix workflow improvements by @PureWeen via @Copilot in #33937
Blazor
-
Fix for BlazorWebView Back Navigation Issues on Android 13+ After Predictive Back Gesture Changes by @SuthiYuvaraj in #33213
CollectionView
-
[Android] Fix for CollectionView.EmptyView does not remeasure its height when the parent layout changes dynamically, causing incorrect sizing. by @BagavathiPerumal in #33559
-
[Android] Fixed CollectionView reordering last item by @vitalii-vov in #17825
Core Lifecycle
-
[Android] Skip DisposeWindowScope on Destroying to prevent ObjectDisposedException by @praveenkumarkarunanithi in #33765
DateTimePicker
Dialogalert
-
[iOS 26] Fix DisplayPromptAsync maxLength not enforced due to new multi-range delegate by @Shalini-Ashokan in #33616
Flyout
Fonts
- Hide obsolete FontSize values from IDE autocomplete by @noiseonwires in #33694
Gestures
-
Fix CustomSwipeControl sample - add missing event handler by @StephaneDelcroix in #33880
-
Android pan fixes by @BurningLights in #21547
Map
-
Add XAML TypeConverters for Map coordinates (Location, MapSpan, Map.Region) by @jfversluis in #33995
-
Add Circle, Polygon, and Polyline click events for Map control by @kubaflo in #29101
Navigation
-
Shell: Add duplicate route validation for sibling elements by @SubhikshaSf4851 in #32296
Performance
- Improve TypedBinding performance by ~29% by @StephaneDelcroix in #33656
Picker
SafeArea
-
[iOS] SafeArea: Return Empty for non-ISafeAreaView views (opt-in model) by @praveenkumarkarunanithi in #33526
Shapes
-
[XSG] Fix inline StyleSheet CSS content with quotes by @StephaneDelcroix in #33874
Shell
-
[iOS] Fix ObjectDisposedException in TraitCollectionDidChange on window disposal by @jeremy-visionaid in #33353
-
[Issue-Resolver] Explicit fallback for BackButtonBehavior lookup by @kubaflo in #33204
Templates
Theme
-
[Windows] Fix runtime theme update for controls and TitleBar by @Tamilarasan-Paranthaman in #31714
🔧 Fixes
- [Windows][MacOS?] Change title bar color when switching light/dark theme at runtime
- OS system components ignore app theme
- [Mac Catalyst][Windows] TitleBar not reacting on UserAppTheme changes
- In dark theme "Back" and "hamburger" button icon color contrast with background color is less than 3:1: A11y_.NET maui_User can get all the insights of Dashboard_Non text Contrast
Switchis invisible onPointOverwhen theme has changed
Theming
- [XSG] Fix Style Setters referencing source-generated bindable properties by @simonrozsival in #33562
Titlebar
-
[Windows] Fix TitleBar.IsVisible = false the caption buttons become unresponsive by @devanathan-vaithiyanathan in #33256
WebView
-
Fix WebView JavaScript string escaping for backslashes and quotes by @StephaneDelcroix in #33726
-
Skip HybridWebView interception test on iOS/MacCatalyst by @rmarinho via @Copilot in #33981
Xaml
-
[XSG] Fix NaN value in XAML generating invalid code by @StephaneDelcroix in #33533
-
Enable XAML Source Generator on ManualTests project by @StephaneDelcroix in #33036
-
[XSG] Fix expression binding TProperty type resolution for mismatched source/target types by @StephaneDelcroix in #33994
🔧 Fixes
- [[XSG] Expression bindings use wrong TProperty type when source and target types differ](https://github.co...
10.0.41 SR4.1
What's Changed
- [release/10.0.1xx-sr4] Revert "Remove InternalsVisibleTo attributes for .NET MAUI Community … by @github-actions[bot] in #34052
- Increment patch version from 40 to 41 by @PureWeen in #34059
Full Changelog: 10.0.40...10.0.41