Skip to content

Releases: dotnet/maui

8.0.6 SR1

17 Jan 21:22
@PureWeen PureWeen
8.0.6
87f59a8
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
8.0.6 SR1

How to Use

8.0.6 is now available in Visual Studio 17.8, 17.9, and 17.10 Preview 1 on Windows, and from the dotnet CLI on macOS and Linux.

Installed Workload Id      Manifest Version       Installation Source
---------------------------------------------------------------------
android                    34.0.79/8.0.100        SDK 8.0.100
ios                        17.2.8022/8.0.100      SDK 8.0.100
maccatalyst                17.2.8022/8.0.100      SDK 8.0.100
maui                       8.0.6/8.0.100          SDK 8.0.100

MAUI Product Fixes

Tests

Read more

Contributors

davidortinau, Eilon, and 32 other contributors
Assets 4

8.0.3

14 Nov 16:08
@Redth Redth
8.0.3
0d64894
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
8.0.3

Introducing the .NET 8 GA release of .NET MAUI

This release is compatible with all the latest versions:

  • Android 14.0 (API 34)
  • iOS 17.0
  • MacCatalyst 17.0
  • WinUI 1.3.

It is also supported with the latest development platforms and tools: Visual Studio 17.8 and Xcode 15.0+ for iOS/MacCatalyst.

.NET MAUI includes and extends the .NET platform SDKs for Android, iOS, iPadOS, macOS, Mac Catalyst, and tvOS.

Get Started

For development on Windows, install .NET 8 and the latest .NET MAUI workload from Visual Studio 17.8+.

For development on Windows or Mac, install the .NET MAUI extension in VS Code and install the latest workload from the standalone installer using the dotnet workload install maui command.

Highlights in .NET 8

  • Enhanced memory management and overall performance
  • Elevated accuracy in Visual States, Triggers, and XAML Hot Reload
  • Optimized keyboard user experience on both mobile and desktop, featuring the introduction of keyboard accelerators
  • Advanced support for gesture recognizers, incorporating new PointerGestureRecognizer events and access to platform-specific event args for Pointer and Drag and Drop gestures
  • Enhanced compatibility for "Unpackaged" Windows apps
  • Update of SkiaSharp to a more recent version of Skia

See more of what's new in https://learn.microsoft.com/en-us/dotnet/maui/whats-new/dotnet-8?view=net-maui-8.0

Breaking Changes

NuGet Package References

.NET MAUI Templates now include PackageReference items for the Microsoft.Maui.Controls and Microsoft.Maui.Controls.Compatibility packages.

<PackageReference Include="Microsoft.Maui.Controls" Version="$(MauiVersion)" />
<PackageReference Include="Microsoft.Maui.Controls.Compatibility" Version="$(MauiVersion)" />

The workload $(MauiVersion) is specified by default, but this can also be changed to allow for easier testing of upcoming Service Release previews, PR builds, or Nightly feed packages without requiring workload commands.

New validation for duplicate images

Following the update, you might encounter a message regarding duplicate files, particularly with image resources. This arises because, previously, we didn't actively check for duplicates, and the image selection was arbitrary. In RC 1, we implemented a check to ensure the absence of duplicates. It's crucial to review any globs, especially those encompassing images, and ensure that images are not inadvertently included multiple times. Instead, make the following update in your csproj file:

<ItemGroup>
    <MauiImage Include="Resources\Images\*" />
    <!-- This would trigger an alert: -->
    <MauiImage Include="Resources\Images\myimage.svg" Color="Red" />
    <!-- This, however, will not result in an error: -->
    <MauiImage Update="Resources\Images\myimage.svg" Color="Red" />
</ItemGroup>

What's Changed since .NET 7

  • [release/8.0.1xx] Update car image/size by @github-actions in #18577
  • Revert "Ensure that viewport calculations for iOS ScrollView account … by @PureWeen in #18579
  • Allow iOS Keyboard Scrolling to be turned off in Lifecycle Events by @tj-devel709 in #18266
  • Setup legacy mappers by @PureWeen in #18087
  • [Templates] Remove get-task-allow entitlement from Templates by @dustin-wojciechowski in #18272
  • Ensure that viewport calculations for iOS ScrollView account for content insets by @hartez in #18277
  • Ensure templates create a proper AppID by @jknaudt21 in #18322
  • [Templates] Fix template typo by @jknaudt21 in #18166
  • Support finding nearest TFM to collect assets from by @mattleibow in #18068
  • Partially revert "[Windows] Update CollectionView changing ItemsLayout (#14532) by @emaf in #18356
  • Make Android respect power saving/disabled animations by @hartez in #17287
  • .NET 8 template tweaks by @rachelkang in #18379
  • Fix project name substitution in Blazor template nav menu and "VS install" prompt by @Eilon in #18388
  • Fix Device Info Test API 33 by @PureWeen in #18390
  • [C] clear _targetObject by @StephaneDelcroix in #18398
  • Fixed Android's Border background to use a Transparent bg if not othe… by @jstedfast in #17555
  • Update Flyout when Shell.FlyoutContent changes by @spadapet in #17359
  • [XamlC] fix generic array by @StephaneDelcroix in #17301
  • Fix iOS/Win InputTransparent layouts and add several UI tests by @mattleibow in #17286
  • Fix accent color missing in title bar by @Foda in #17528
  • Remove obsolete MauiWinUIApplication properties by @PureWeen in #17667
  • Override CA1822 for Android interface implementation in MauiScrollView by @jfversluis in #17691
  • Don't run hide on tapped code if window is null by @PureWeen in #17758
  • Make sure to not call new APIs on old iOS by @mattleibow in #17907
  • Make Entitlements in Templates for MacCatalyst more consistent between debug and release configs. by @dustin-wojciechowski in #17833
  • Update Blazor Hybrid template to match ASP.NET Core Blazor Web template by @Eilon in #17946
  • [android] update AOT profile for .NET 8 GA by @jonathanpeppers in #18061
  • [Windows] Fix wrong Layout from hidden CollectionView by @jsuarezruiz in #17659
  • [ X] connect the right method to the event handler by @StephaneDelcroix in #18043
  • [iOS] Keep textcolor on characterspacing by @StephaneDelcroix in #17926
  • [WinUI] Fixes window blinking when resizing by @emaf in #18155
  • [net8.0] Add permission for high-speed sensors by @mattleibow in #18180
  • [ X] revert #5611 by @StephaneDelcroix in #17733
  • [iOS] Fix downscaled images not occupying correct space by @jknaudt21 in #17120
  • Rework the Label mappers for FormattedText by @mattleibow in #18105
  • Add a test for #17776 "Calling SetBinding after setting a constant value crashes" by @StephaneDelcroix in #17796
  • [net8.0] Add NuGet package information by @mattleibow in #18197
  • [net8.0] Correctly expand rows/columns when grid padding by @github-actions in #18276
  • [release/8.0.1xx-rc2.2] Allow iOS Keyboard Scrolling to be turned off in Lifecycle Events by @github-actions in #18308
  • [release/8.0.1xx-rc2.2] Setup legacy mappers by @github-actions in #18309
  • [release/8.0.1xx-rc2.2] Make sure to account for a null AppWindow by @github-actions in #18313
  • [release/8.0.1xx-rc2.2] Limit star expansion when measuring/arranging at constrained sizes by @github-actions in #18314
  • [release/8.0.1xx-rc2.2] [Templates] Remove get-task-allow entitlement from Templates by @github-actions in #18323
  • [release/8.0.1xx-rc2.2] Ensure that viewport calculations for iOS ScrollView account for content insets by @github-actions in #18321
  • [xaml] locate event handlers from base types by @jonathanpeppers in #17075
  • Updated the RoundRectangle BorderTest to check all 4 corners by @jstedfast in #17172
  • Fix CollectionView not displaying header or footers by @jknaudt21 in #16870
  • Compatibility should depend on Controls by @mattleibow in #17226
  • (Windows) Fix tabbar visibility test by @Foda in #17240
  • [msbuild] fix NuGet Central Package Management (CPM) by @jonathanpeppers in #17235
  • Copy Windows assets to the output folder for Unpackaged by @mattleibow in #17238
  • Remove null forgiveness operator and fix NRE from PlatformView in disconnect by @PureWeen in #17248
  • [iOS] Fix issues setting Shell TabBar appearance by @jsuarezruiz in #15748
  • [android] improve ToolbarExtensions.UpdateIconColor performance by @jonathanpeppers in #17241
  • [Windows] Fix collection default spacing by @Foda in #17261
  • Use strong type for PointerGest...
Read more

Contributors

jonpryor, Eilon, and 54 other contributors
Assets 2

8.0.100-rc.2.9530

07 Nov 15:56
@PureWeen PureWeen
8.0.100-rc.2.9530
454b40c
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
8.0.100-rc.2.9530 Pre-release
Pre-release

MAUI Product Fixes

What's Changed

Dependency Updates

Full Changelog: 8.0.0-rc.2.9511...8.0.0-rc.2.9530

Contributors

Eilon, dalexsoto, and 10 other contributors
Assets 23

7.0.101 SR10

07 Nov 16:03
@rmarinho rmarinho
7.0.101
f97a31d
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
7.0.101 SR10

Dependency Updates:

[net7.0] Update dependencies from xamarin/xamarin-macios by @dotnet-maestro-bot in #18361

Contributors

dotnet-maestro-bot
Assets 52

7.0.100 SR9

31 Oct 17:51
@rmarinho rmarinho
7.0.100
f97a31d
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
7.0.100 SR9

What's Changed

Tests

Docs

Dependency Updates

Full Changelog: 7.0.96...7.0.100

Contributors

jfversluis, mattleibow, and 3 other contributors
Assets 2

8.0.0-rc.2.9511

31 Oct 17:56
@mattleibow mattleibow
8.0.0-rc.2.9511
98777b5
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
8.0.0-rc.2.9511 Pre-release
Pre-release

MAUI Product Fixes

What's Changed

Tests

Docs

Dependency Updates

  • [release/8.0.1xx-rc2.1] Update dependencies from xamarin/xamarin-macios by @dalexsoto in #17985
  • [release/8.0.1xx-rc2.1] Update dependencies from xamarin/xamarin-macios by @dalexsoto in #18091
  • [release/8.0.1xx-rc2.1] Update with correct net7 version by @rmarinho in #18100
  • [release/8.0.1xx-rc2.1] Update dependencies from xamarin/xamarin-macios by @dalexsoto in #18170
  • [release/8.0.1xx-rc2.1] Update dependencies from xamarin/xamarin-macios by @dalexsoto in #18218
  • [release/8.0.1xx-rc2.1] Bump net7 by @rmarinho in #18244

Full Changelog: 8.0.0-rc.2.9373...8.0.0-rc.2.9511

Contributors

dalexsoto and rmarinho
Assets 2

8.0.0-rc.2.9373

10 Oct 15:07
@rmarinho rmarinho
8.0.0-rc.2.9373
19fc25a
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
8.0.0-rc.2.9373 Pre-release
Pre-release

What's Changed

MAUI Product Fixes

Tests

Docs

Dependency Updates

Housekeeping

  • Update NuGet.config for 7.0.11 by @mattleibow in #17170
  • [net8.0] [release/8.0.1xx-rc1]Revert net7 sr8 by @github-actions in #17174
  • [housekeeping] Automated PR to fix formatting errors by @github-actions in #17244
  • [housekeeping] Automated PR to fix formatting errors by @github-actions in #17262
  • [build] Move to rc2 packages by @rmarinho in #17278
  • [net8.0] Merge main to net8.0 by @rmarinho in #17284
  • [housekeeping] Automated PR to fix formatting errors by @github-actions in #17...
Read more

Contributors

rolfbjarne, StephaneDelcroix, and 20 other contributors
Assets 23

7.0.96

10 Oct 15:09
@rmarinho rmarinho
7.0.96
dd89dbd
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
7.0.96

What's Changed

MAUI Product Fixes

  • [net7.0] "Handle Grid * expansion when size is larger than minimum, but less than sufficient to display full size (#14902) (#15653)" by @PureWeen in #15915
  • [net7.0] Grid star expansion fixes by @hartez in #15938
  • [net7.0] Memory Leak: MAUI-Windows are not garbage-collected after destroy of MainActivity by @hartez in #16240
  • [net7.0] Set the SafeAreaInset Property with updated value (#15512) by @hartez in #16238
  • [net7.0] Resize internal content container when ScrollView content is resized by @hartez in #16651
  • [net7.0] Allow * rows/columns treated as Auto to expand during 2nd measure pass by @github-actions in #16641
  • [net7.0] Use same type converter for Brush as for Color to enable XAML completion by @github-actions in #16639
  • [net7.0] Make CollectionView on iOS measure to content size by @hartez in #15652
  • [net7.0] [iOS] Update CollectionView layout when reloading data by @github-actions in #16794
  • [net7.0] Use the correct WASDK property by @github-actions in #16793
  • [Backport net7.0] Add doc comments for common types used in templates by @jfversluis in
  • [net7.0] Fix Grid cells not honoring MaxWidth by @hartez in #16837
  • [net7.0] Revert default for UseSafeAreaProperty to value from .NET 6 for iOS by @PureWeen in #16379
  • [net7.0] [macOS] Fix crash using Shell SearchHandler on Catalyst by @hartez in #16902
  • Add properties to disable implicit things by @mattleibow in #17046
  • [net7.0] Windows - Fix default item min height in CollectionView (#12811) by @hartez in #17092
  • [net7.0] MauiEmbedding extensions should use specified TApp type by @github-actions in #17085
  • [net7.0] [Windows] Implement ItemsUpdatingScrollMode on CollectionView by @github-actions in #17086
  • [net7.0] [windows] Fixed CarouselView items rendering by @hartez in #17088
  • [net7.0] Update VisualElement docs (#16754) by @hartez in #17094
  • [net7.0] Improve VisualElement API Docs Follow-up by @github-actions in #17166
  • [net7.0] "Revert default for UseSafeAreaProperty to value from .NET 6 for iOS by @rmarinho in #17458
  • [net7.0] [iOS/Catalyst] Fix issue loading images from Stream (#16162) by @PureWeen in #17519
  • [net7.0] Null check everything in InvalidateMeasureIfContentSizeChanged by @github-actions in #17493
  • [net7.0] Fixed Android's StreamImageSourceService.LoadDrawableAsync() by @github-actions in #16640
  • [net7.0] [iOS] Fix ScrollTo method issues by @hartez in #17093

Dependency Updates

Housekeeping

  • [housekeeping] Automated PR to fix formatting errors by @github-actions in #15892
  • Backport WinUI DeviceTest Fixes by @PureWeen in #15840
  • [housekeeping] Automated PR to fix formatting errors by @github-actions in #15936
  • [housekeeping] Automated PR to fix formatting errors by @github-actions in #15955
  • [net7.0] Fix signing by @rmarinho in #16660
  • [housekeeping] Automated PR to fix formatting errors by @github-actions in #16688
  • [housekeeping] Automated PR to fix formatting errors by @github-actions in #16943
  • [housekeeping] Automated PR to fix formatting errors by @github-actions in #17119
  • [housekeeping] Automated PR to fix formatting errors by @github-actions in #17177
  • Backport uitests by @PureWeen in #17420
  • [housekeeping] Automated PR to fix formatting errors by @github-actions in #17467
  • [net7.0] Update cake files and XCode by @rmarinho in #17498
  • [net7.0] [tests] Fix image for device tests on Android by @rmarinho in #17459
  • [release/7.0.3xx-sr8] Update Version by @rmarinho in #17532
  • [release/7.0.3xx-sr8] [net7.0] Remove ScrollView Leak Test by @github-actions in #17534
  • [release/7.0.3xx-sr8] [net7.0] Backport UI Test fixes from main by @github-actions in #17535

Full Changelog: 7.0.92...7.0.96

Contributors

hartez, jfversluis, and 4 other contributors
Assets 52

8.0.0-rc.1.9171

12 Sep 16:15
@rmarinho rmarinho
8.0.0-rc.1.9171
269a8f0
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
8.0.0-rc.1.9171 Pre-release
Pre-release

Known Issues

  • Black splash screens on iOS 16.5+ simulators
    The splash screen on iOS simulators are sometimes black if you are not using a developer certificate. Splash screens will still appear on older simulators (such as iOS 15.5) or if you are doing a release build.
    See more xamarin/xamarin-macios#18469
  • Always-visible scrollbars on iOS
    The iOS scroll view does not always size correctly and you may always see a scrollbar.
    See more #17224
  • Installing .NET MAUI workload fails with signing errors
    Make sure you're using the latest RC1 SDK.

What's Changed

  • New duplicate image errors
    After updating to RC 1, you may see an error about duplicate files (such as with image resources) and this is because previously we did not check for duplicates and the image that was selected was arbitrary. From RC 1, we are now checking to ensure there are no duplicates. Make sure that if you have globs including images, you are not also including images again and instead Update: 
    <ItemGroup>
    <MauiImage Include="Resources\Images\*" />
    <!-- this will causes an error: -->
    <MauiImage Include="Resources\Images\myimage.svg" Color="Red" />
    <!-- this will NOT result in an error: -->
    <MauiImage Update="Resources\Images\myimage.svg" Color="Red" />
</ItemGroup>
  • Changes to the way RIDs work
    Although not directly affecting .NET MAUI apps/libraries right now, there was a change to the way the RIDs work in .NET 8 RC 1: https://learn.microsoft.com/en-us/dotnet/core/compatibility/sdk/8.0/rid-graph

MAUI Product Fixes

Read more

Contributors

jonpryor, Eilon, and 35 other contributors
Assets 2

8.0.0-preview.7.8842

08 Aug 13:11
@rmarinho rmarinho
8.0.0-preview.7.8842
fb23473
This commit was created on GitHub.com and signed with GitHub’s verified signature. The key has expired.
GPG key ID: 4AEE18F83AFDEB23
Expired
Learn about vigilant mode.
Compare
Choose a tag to compare
8.0.0-preview.7.8842 Pre-release
Pre-release

How to install?

This release is best with Visual Studio 2022 17.8 Preview 1 on Windows, Visual Studio for Mac latest release, or the .NET MAUI extension for VS Code (Preview).

Windows

Install Visual Studio 2022 17.8 Preview 1 and select the .NET Multi-platform App UI workload, and then check the optional component “.NET MAUI (.NET 8 Preview)”.

Mac

In order to enable the latest Visual Studio for Mac to work with .NET 8 previews, enable .NET 8 previews in the preferences "Preview Features" section.

To install .NET 8 Preview 7 follow the instructions below.

All

Follow these instructions unless you have installed on Windows with the Visual Studio version above.

Download the .NET 8 Preview 7 SDK, followed by:

> dotnet workload install maui
...
Successfully installed workload(s) maui.

To verify installation:

> dotnet workload list

Installed Workload Id      Manifest Version                            Installation Source
--------------------------------------------------------------------------------------------
maui                    8.0.0-preview.7.8842/8.0.100-preview.7      SDK 8.0.100-preview.7

What's Changed

Tests

Docs

  • Add note to Colors.xaml to make people aware of Android specific colors by @jfversluis in #15855

Dependency Updates

Read more

Contributors

Eilon, dalexsoto, and 23 other contributors
Assets 23