Skip to content

8.0.3

Compare
Choose a tag to compare
@Redth Redth released this 14 Nov 16:08
0d64894

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