Installation

Install .NET 9 and the .NET MAUI workload to get started with this release.

Known issues

• Due to a late-breaking change in the debugger tooling within Visual Studio, XAML Hot Reload will not load with .NET 9 Preview 1 projects targetting iOS and Android and should result in a yellow error bar. It should not break the deployment or debugging of the app, and you can enable ignoring future errors from appearing from the bar. This should be addressed in a future release of Visual Studio.
• building net8.0-* target frameworks from .NET 9 does not work in preview 1.

MAUI Product Fixes

Fix for button cornerradius 0 on android by @WdeBruin in #18959 Fix for #11991 - CollectionView SelectedItem BackgroundColor is always Gray on iOS by @Axemasta in #17464 [Android] Correctly clear text tapping the clear button on Entry by @jsuarezruiz in #17543 [iOS] Fix wrong gray color using transparent in iOS gradients by @jsuarezruiz in #17696 Fix Clear Button size calculation by @PureWeen in #19482 Fix attribute typo by @PureWeen in #19567 Fix disappearing cell issue for TableView on Android by @hartez in #19723 Fix SetProgressViewOffset on SwipeRefreshLayout by @PureWeen in #19767 Fix incorrect defaults when adding non-BindableObject as AbsoluteLayout child by @hartez in #19839 [iOS] Fix Flyout layout by @emaf in #19125 Schedule Android layout requests received during layout on the UI thread by @hartez in #19349 [macOS] Fix GesturePlatformManager.CalculatePosition when asked for a relative position by @MartyIX in #19371 Fix Label Multilinetruncation (MaxLines / LineBreakMode) by @jsuarezruiz in #14918 [Windows] Fix Tabbar Visibility Tests by @Foda in #19662 Fix has color to use maui context on passed in view by @PureWeen in #19682 Correct nullable annotations on IMediaPicker by @jfversluis in #19157 [Windows] Show the Raw HTML for Html Label in case of error by @drasticactions in #17470 [Catalyst] Allow setting of CancelButtonColor on SearchBar when using Mac Idiom by @mikeparker104 in #19838 iOS Keyboard Scrolling Improvements and UITests (not from fork) by @tj-devel709 in #17670 [Android] FlyoutIsPresented property opens the Flyout by @jsuarezruiz in #19807 Fix Developer Tools option setting for Blazor Hybrid Mac Catalyst view by @drasticactions in #19909 Process the hardware enter key as "Done" by @PureWeen in #16386 [Android] Fix gif animation initial state by @jsuarezruiz in #14295 Translucent and Transparent NavigationBar on iOS by @tj-devel709 in #19204 Allow GesturePlatformManager to be created for views with null window by @artemvalieiev in #18938 Handle Semantics flags more explicitly on iOS by @hartez in #19370 XamlC WarnAsErrors by @StephaneDelcroix in #19337 Improves performance on BindableProperty by @albyrock87 in #17756 [Android] Fix gif animation initial state by @jsuarezruiz in #14295 [Catalyst] Allow setting of CancelButtonColor on SearchBar when using Mac Idiom by @mikeparker104 in #19838 [Windows] Fix Tabbar Visibility Tests by @Foda in #19662 Handle setting of DesiredSize in Measure implementations, rather than MeasureOverride by @hartez in #19794 Fix disappearing cell issue for TableView on Android by @hartez in #19723 Fix SetProgressViewOffset on SwipeRefreshLayout by @PureWeen in #19767 Fix has color to use maui context on passed in view by @PureWeen in #19682 [Windows] Show the Raw HTML for Html Label in case of error by @drasticactions in #17470 Fix incorrect defaults when adding non-BindableObject as AbsoluteLayout child by @hartez in #19839 [iOS] Fix Flyout layout by @emaf in #19125 [macOS] Fix GesturePlatformManager.CalculatePosition when asked for a relative position by @MartyIX in #19371 Fix Label Multilinetruncation (MaxLines / LineBreakMode) by @jsuarezruiz in #14918 Fix attribute typo by @PureWeen in #19567 Fix Clear Button size calculation by @PureWeen in #19482 [Android] Correctly clear text tapping the clear button on Entry by @jsuarezruiz in #17543 Fix for #11991 - CollectionView SelectedItem BackgroundColor is always Gray on iOS by @Axemasta in #17464 Fix for button cornerradius 0 on android by @WdeBruin in #18959 Change the default value for xaml-comp by @StephaneDelcroix in #19390 Add design time converters by @etvorun in #19301 [WinUI] Add workaround for Connectivity check on Win10 by @Foda in #19261 [Windows] Adjust recycle check in ItemContentControl by @Foda in #20079 Rectify the scopes in the builder by @mattleibow in #19932 Enable building WASDK Self-Contained packaged apps by @mattleibow in #20019 allow x:Type extension for BPConverter by @StephaneDelcroix in #18540 Source Generator Performance Improvements by @mgoertz-msft in #19990 Add better exception for missing Maps on Windows by @jfversluis in #19046 Adding Mobile tag to MAUI project templates by @MSLukeWest in #20191 [xamlg] improve error for Xamarin.Forms namespace by @jonathanpeppers in #19683 sealed some internal classes in Controls.Core that are not inherited from by @Lehonti in #17671 Avoid zero-length array allocations by @molesmoke in #19300 [Trimming] Fix several trimming warnings by @simonrozsival in #19402 Optimize IndexOf lookups by @symbiogenesis in #19963 Re-generate the template files by @mattleibow in #19993 Remove unused functions by @symbiogenesis in #20029 Revert "Remove unused functions (#20029)" by @drasticactions in #20050 Resizetizer Regex Fix by @Eden-Mor in #19600 Make sure we support keyed services in client apps by @mattleibow in #20014 Add Obsolete tag for old IndexOf by @drasticactions in #20068 Default to no item selected by @mattleibow in #20072 Remove Fuschia once again... by @jfversluis in #19434 Enable string search and comparison CA rules in Core by @hartez in #19796 Enable CA1822 in Core and convert eligible methods to static by @hartez in #19800 Do not use underscores in the ApplicationId by @mattleibow in #19377

Tests

[Testing] Add scroll methods to UITest by @jsuarezruiz in #19181 [Testing] Added DragCoordinates action to appium UITest by @jsuarezruiz in #19333 [Testing] Added lifecycle methods to UITest by @jsuarezruiz in #19102 [Testing] Added UI Test for manual test D9 by @jsuarezruiz in #18762 [Testing] Add Back method in the UITest lifecycle actions by @jsuarezruiz in #19442 [Testing] Added UI Test for manual test C3 by @jsuarezruiz in #18899 [Testing] Added UI Test for manual test C2 by @jsuarezruiz in #18794 Save device logs when UI Tests fail by @mattleibow in #19085 Move the device test for ShowsKeyboardOnFocus to Appium by @jsuarezruiz in #18747 Set Simulator UDID explicitly for CG UI tests by @jfversluis in #19540 Break ControlsHeadlessTestRunner.RunTestsAsync method when discovering tests by @jfversluis in #19559 Disable flaky compat test by @jfversluis in #19546 Grab device logs if app stops running by @PureWeen in #19562 Attach And Run iOS / catalyst semantic tests by @PureWeen in #19571 [Testing] Added appium UITest for FlyoutNavigationBetweenItemsWithNavigationStacks by @jsuarezruiz in #19444 Enable Windows Image device tests by @mattleibow in #20167 [testing] Enable a way to test on real devices by @rmarinho in #19492 Fix some UI Test timings by @PureWeen in #19462 Disable failing semantic tests on iOS by @mattleibow in #19344 NativeAOT: Add integration tests for testing MAUI compatibility with NativeAOT on iOS by @ivanpovazan in #19194 Move GroupListViewHeaderIndexOutOfRange to Appium by @PureWeen in #19799 passing test for 18976 by @StephaneDelcroix in #19785 Split the InputTransparency tests by @mattleibow in #19925 NativeAOT: Update NativeAOT integration tests to run with 9.0.1xx-preview1 by @ivanpovazan in #20268 [tests] Move integration tests to use MauiDotNetTfm by @rmarinho in #20060 Reduce the complexity of the AttachAndRun code by @mattleibow in #19352 Modify FlyoutHeaderAdaptsToMinimumHeight test to work better on CI by @Foda in #19685

Dependency Updates

[net9.0] Update dependencies from xamarin/xamarin-android by @dotnet-maestro in #19439 [net9.0] Update dependencies from dotnet/aspnetcore by @dotnet-maestro in #19512 [net9.0] Update dependencies from xamarin/xamarin-android by @dotnet-maestro in #19485 [net9.0] Update dependencies from dotnet/aspnetcore by @dotnet-maestro in #19440 [net9.0] Update dependencies from xamarin/xamarin-macios by @dotnet-maestro in #19491 [main] Update dependencies from dotnet/xharness by @dotnet-maestro in #19336 [main] Update dependencies from dotnet/xharness by @dotnet-maestro in #19474 [net9.0] Update dependencies from dotnet/aspnetcore by @dotnet-maestro in #19498 [net9.0] Update dependencies from xamarin/xamarin-android by @dotnet-maestro in #19604 [net9.0] Update dependencies from xamarin/xamarin-android by @dotnet-maestro in #19672 [net9.0] Update dependencies from xamarin/xamarin-android by @dotnet-maestro in #19677 [net9.0] Update dependencies from xamarin/xamarin-macios by @dotnet-maestro in #19531 [net9.0] Update dependencies from xamarin/xamarin-android by @dotnet-maestro in #19694 [net9.0] Update dependencies from xamarin/xamarin-android by @dotnet-maestro in #19791 [net9.0] Update dependencies from xamarin/xamarin-android by @dotnet-maestro in #19811 [net9.0] Update dependencies from xamarin/xamarin-macios by @dotnet-maestro in #20096 [net9.0] Update dependencies from xamarin/xamarin-android by @dotnet-maestro in #20085 [net9.0] Update dependencies from xamarin/xamarin-android by @dotnet-maestro in #20013 [net9.0] Update dependencies from xamarin/xamarin-android by @dotnet-maestro in #19850 [net9.0] Update dependencies from dotnet/aspnetcore by @dotnet-maestro in #19523 Bump to new stable versions of iOS and Android workloads by @rmarinho in #19393 Bump Xamarin.UITest from 4.1.4 to 4.3.3 by @jfversluis in #19394 Bump Xamarin.UITest to 4.3.4 by @jfversluis in #20067 [ci] Update System.Drawing.Common by @rmarinho in #20122 [main] Update dependencies from dotnet/xharness by @dotnet-maestro in #19901 [net9.0] Update dependencies from xamarin/xamarin-macios by @dotnet-maestro in #19911 [net9.0] Update dependencies from dotnet/aspnetcore by @dotnet-maestro in #19908 [main] Update version for nightly by @rmarinho in #19981

Housekeeping

[ci] Execute build.ps1 from bash on Mac to avoid STDIO streams hang by @mjbond-msft in #19257 [housekeeping] Automated PR to fix formatting errors by @github-actions in #19305 [housekeeping] Automated PR to fix formatting errors by @github-actions in #19316 Improve appium install on CI build agents by @jfversluis in #19248 [housekeeping] Automated PR to fix formatting errors by @github-actions in #19351 [housekeeping] Automated PR to fix formatting errors by @github-actions in #19413 Update version for CI/Nightlies by @Redth in #19425 [net9.0] Update net9.0 with new versions by @rmarinho in #19236 [housekeeping] Automated PR to fix formatting errors by @github-actions in #19454 [ci] Move to new compliance task by @rmarinho in #19475 [housekeeping] Automated PR to fix formatting errors by @github-actions in #19510 [housekeeping] Automated PR to fix formatting errors by @github-actions in #19533 [housekeeping] Automated PR to fix formatting errors by @github-actions in #19577 [housekeeping] Automated PR to fix formatting errors by @github-actions in #19769 [housekeeping] Automated PR to fix formatting errors by @github-actions in #19813 [ci] Don't skip default provision on iOS by @rmarinho in #19652 [net9.0] Enable trimming windows by @rmarinho in #19680 [Windows] Fix verification of test count in CI by @Foda in #19697 [net9.0] Merge main to net9 by @rmarinho in #19700 Update eng/README.md by @eltociear in #19735 Clean up async assertions by @hartez in #19385 Update bug-report.yml with 8.0.5 by @PureWeen in #19795 [net9.0] Enable tizen by @rmarinho in #19679 [net9.0] Merge main to net9.0 by @rmarinho in #20077 [ci] Restore dotnet tools in provisioned sdk by @rmarinho in #20106 Reset the xaml in the Sandbox MainPage.xaml by @tj-devel709 in #20082 [ci] Add missing demands by @rmarinho in #20183 Add comments to internal methods for XAML Hot Reload usage by @drasticactions in #20215 [net9.0] Merge main to net9.0 by @rmarinho in #20223 Revert "[net9.0] Merge main to net9.0" by @rmarinho in #20229 [net9.0] Merge main to net9.0 by @rmarinho in #20230 [release/9.0.1xx-preview1] Update with net9.0 by @rmarinho in #20254 [release/9.0.1xx-preview1] Update versions by @rmarinho in #20158 [ci] Push artifacts for the sample tests by @rmarinho in #20269 [release/9.0.1xx-preview1] Update versions by @rmarinho in #20279 [release/9.0.1xx-preview1] Revert "Dont build net8" by @rmarinho in #20286 [ci] Bump XCode to 15.2.0 by @rmarinho in #19836 [ci] Don't install xharness globally by @rmarinho in #19863 Update README.md by @jamesmontemagno in #19797 Merge branch 'release/8.0.1xx-sr1' into main by @PureWeen in #19936 Update bug-report.yml to 8.0.6 by @PureWeen in #19952 [net9.0] Merge main to net9 by @rmarinho in #19907 Enforce preference of braces for code blocks (IDE0011) in .editorconfig by @jfversluis in #20056 [net9.0] Merge main to net9.0 by @rmarinho in #20077 [ci] Restore dotnet tools in provisioned sdk by @rmarinho in #20106

New Contributors

@WdeBruin made their first contribution in https://github.com/dotnet/maui/pull/18959 @artemvalieiev made their first contribution in https://github.com/dotnet/maui/pull/18938 @Axemasta made their first contribution in https://github.com/dotnet/maui/pull/17464 @tarasverq made their first contribution in https://github.com/dotnet/maui/pull/19659 @simonrozsival made their first contribution in https://github.com/dotnet/maui/pull/19402 @JanKrivanek made their first contribution in https://github.com/dotnet/maui/pull/19824 @symbiogenesis made their first contribution in https://github.com/dotnet/maui/pull/19963 @Eden-Mor made their first contribution in https://github.com/dotnet/maui/pull/19600

Full Changelog: https://github.com/dotnet/maui/compare/8.0.6...9.0.100-preview.1.9973