search

serenity-is / Serenity

Business Apps Made Simple with Asp.Net Core MVC / TypeScript
https://serenity.is
MIT License
2.57k stars 796 forks source link

.NET 8 Migration #7020

Open volkanceylan opened 7 months ago

volkanceylan commented 7 months ago

This update is a significant release tailored for .NET 8. Before migrating to this version (8.0+), ensure that your Visual Studio 2022 version is 17.8.0 or later. If not using Visual Studio, manually install .NET SDK 8 to proceed.

Configuration Changes

  1. Update your project file to target .NET 8.0 by modifying the following line:

    <TargetFramework>net8.0</TargetFramework>

  2. Update the packages listed below to at least the specified versions:

    <PackageReference Include="Microsoft.AspNetCore.Mvc.NewtonsoftJson" Version="8.0.0" />
<PackageReference Include="Microsoft.Data.Sqlite" Version="8.0.0" />
<PackageReference Include="Microsoft.Data.SqlClient" Version="5.1.2" />

  3. Additionally, update references to Serenity and any Pro packages to version 8.0.0 or later. These changes should facilitate a smooth transition to .NET 8, as there aren't many breaking changes affecting Serenity-based applications.

Please note that Serenity 8.0+ packages will no longer provide support for .NET 6/.NET 7. Ensure compatibility by making necessary updates to align with .NET 8.

Serene Transition to .NET 8

Although a .NET 8 version of Serene won't be released immediately, this decision is to avoid potential issues for users who might not have updated their Visual Studio to version 17.8.0. Serene users can manually implement the changes outlined in these release notes once they have updated their Visual Studio and are ready to switch to .NET 8.

This approach aims to prevent issues for newcomers downloading Serene without the required Visual Studio update.

volkanceylan commented 2 months ago

Update: Serene 8.4.7.0 with .NET8 support is released on 2024-04-28