Skip to content

v5.0.0: .NET 9 support has arrived!
Compare
Choose a tag to compare
@jfversluis jfversluis released this 22 Nov 09:27
· 23 commits to main since this release
5.0.0
b23c3b8

Breaking Changes

  • String-based bindings are no-longer trim safe
    • eg .Bind(Label.TextProperty, nameof(MyViewModel.LabelText) is not trim safe
    • Use .Bind(Label.TextProperty, static (MyViewModel vm) => vm.LabelText) instead
  • .BindClickGesture Removed
    • Use .BindTapGesture instead
  • .ClickGesture Removed
    • Use .TapGesture instead
  • NuGet package will not support Microsoft.Maui.Controls .NET 10 until .NET 10 GA

Requirements

The following tools are now required for CommunityToolkit.Maui.Markup:

  • Xcode 16.0.0
    • Read the latest .NET MAUI Release wiki to always find the latest-supported version) of Xcode for .NET MAUI
    • We HIGHLY recommend using the open-source tool Xcodes to easily manage your installed Xcode versions
  • Update to the latest stable version of Visual Studio (or Jet Brains Rider)
  • Download/install .NET SDK v9.0.100
  • After installing the latest stable .NET SDK, update to the latest stable version of the .NET MAUI workload:
    • On macOS, open the Terminal and enter the following command: sudo dotnet workload install maui
    • On Windows, open the command prompt (or Powershell) and enter the following command: dotnet workload install maui
  • Add a global.json file to your application with the following parameters to ensure you're not using a unsupported preview version of .NET (example below)
    • The .NET MAUI Community Toolkit does not support preview releases of .NET

global.json

{
  "sdk": {
    "version": "9.0.100", 
    "rollForward": "latestFeature",
    "allowPrerelease": false
  }
}

What's Changed

But wait, there's more!

  • Bump MauiPackageVersion from 8.0.91 to 8.0.92 in /samples by @dependabot in #325
  • Bump CommunityToolkit.Mvvm from 8.2.2 to 8.3.2 in /samples by @dependabot in #326
  • Bump Refit.HttpClientFactory from 7.1.2 to 7.2.1 in /samples by @dependabot in #328
  • Bump Microsoft.Extensions.Http.Resilience from 8.8.0 to 8.10.0 in /samples by @dependabot in #327
  • Bump CommunityToolkit.Mvvm from 8.3.0 to 8.3.2 in /samples by @dependabot in #330
  • Bump Refit.HttpClientFactory from 7.2.1 to 8.0.0 in /samples by @dependabot in #331
  • Bump MauiPackageVersion from 8.0.92 to 8.0.93 in /samples by @dependabot in #332
  • Bump CommunityToolkit.Maui from 9.1.0 to 9.1.1 in /samples by @dependabot in #333
  • [Housekeeping] Add SourceLink by @brminnick in #322
  • Bump NUnit.Analyzers from 4.3.0 to 4.4.0 in /samples by @dependabot in #335

Full Changelog: 4.2.0...5.0.0

Contributors

brminnick and dependabot
Assets 2
Loading