Sådan migrerer du din applikation fra Dotnet 5 til Dotnet 6

.NET (Dotnet) rammeværket blev først udgivet i begyndelsen af ​​2000. Det er en gratis, open source udviklingsramme, som du kan bruge til at udvikle en bred vifte af applikationer.

Microsoft stoppede den officielle support af .NET 5 den 8. maj 2022. Hvis du tilfældigvis bruger .NET 5 i dine applikationer, betyder det, at dine applikationer er mere sårbare over for sikkerhedsbrud. Heldigvis kan du nemt opgradere eller migrere dine applikationer til den nye LTS-version af .NET, version 6.

Hvad er Dotnet 6?

.NET 6 er den aktuelle LTS-version af .NET frameworket og udgivet i november 2021.

Du kan udvikle applikationer ved hjælp af .NET 6 på Windows, Linux og macOS. Det er også indbygget understøttet på M1 Apple Silicon-chips og Arm-baserede Windows-operativsystemer.

.NET 6 frameworket understøtter også udvikling af applikationer på flere sprog, såsom C# (C-Sharp), Visual Basic og F# (F-Sharp).

En af de vigtigste fordele ved .NET frameworket er, at du kan udvikle en lang række applikationer med det. Disse omfatter

Web apps, spil, mobilapps og desktopapplikationer. Derudover er rammerne både gennemtestet og dokumenteret.

Installation af .NET 6 SDK

Du skal installere .NET SDK på din pc for at kunne udvikle .NET-applikationer.

Du skal blot downloade .NET 6 Software Development Kit (SDK), og derefter installere det på din pc. SDK'et indeholder alle de nødvendige værktøjer til at udvikle software i .NET 6.

Når installationen er fuldført, kan du liste de tilgængelige SDK'er på din pc ved hjælp af følgende .NET CLI-kommando:

dotnet --list-sdks

Hvis du blot vil tjekke den version, du er på, kan du køre følgende kommando:

dotnet --version

Hent: .NET 6 (Ledig)

Opdatering af Target Framework

Start opgraderingen ved at opdatere .NET-målrammerne. Din webapp indeholder en målramme-moniker, som fortæller din applikation, hvilken slags .NET-runtime, du skal bruge.

Målrammen for din webapp er placeret i dit applikationsprojekts XML-fil. Den har forlængelsen .csproj. Åbn applikationsprojektfilen, og opdater TargetFramework-monikeren placeret under PropertyGroup-tagget fra net5.0 til net6.0

<Ejendomsgruppe>
<!-- <TargetFramework>net5.0</TargetFramework> -->
<TargetFramework>net6.0</TargetFramework>
<UserSecretsId>xxx33795-1b05-xxxx-926f-dcc112c2xxxd</UserSecretsId>
<DockerDefaultTargetOS>Linux</DockerDefaultTargetOS>
</PropertyGroup>

Hvis din applikation bruger global.json fil, så sørg for at opdatere SDK-versionen til "version": "6.0.100".

Opdatering af pakkereferencer

Det næste trin er at opdatere dine applikationspakkereferencer eller NuGet-pakkeafhængigheder. .NET frameworket er meget modulært og arbejder på konceptet afhængighedsinjektion. Dine NuGet-pakkereferencer er placeret i .csproj projektfil, under tag.

Antallet af NuGet-pakker vil variere afhængigt af størrelsen af ​​din applikation og dens kompleksitet.

Det første tal i en NuGet-pakkeversion viser normalt, hvilket .NET-framework det er målrettet mod, 6, i dette tilfælde. Sørg for at opdatere alle NuGet-pakker, så de afspejler din målramme. Koden efter kodeliste viser den nye pakke med fed skrift. De gamle NuGet-pakker er kommenteret ud.

<Varegruppe>
<!-- <PackageReference Include="Microsoft. AspNetCore. Godkendelse. JwtBearer" Version="5.0.13" /> -->
<!-- <PackageReference Include="Microsoft. EntityFrameworkCore. Design" Version="5.0.9"> -->
<PackageReference Include="Microsoft. AspNetCore. Godkendelse. JwtBearer" Version="6.0.3" />
<PackageReference Include="Microsoft. EntityFrameworkCore. Design" Version="6.0.3">
<Inkluder aktiver>runtime; bygge; hjemmehørende; indholdsfiler; analysatorer; byggetransitiv</IncludeAssets>
<Private Assets>alle</PrivateAssets>
</PackageReference>
<!-- <PackageReference Include="Microsoft. EntityFrameworkCore. SQLServer" Version="5.0.9" /> -->
<!-- <PackageReference Include="Microsoft. VisualStudio. Web. Kodegenerering. Design" Version="5.0.2" /> -->
<!-- <PackageReference Include="Swashbuckle. AspNetCore" Version="5.6.3" /> -->
<PackageReference Include="Microsoft. EntityFrameworkCore. SQLServer" Version="6.0.3" />
<PackageReference Include="Microsoft. VisualStudio. Web. Kodegenerering. Design" Version="6.0.2" />
<PackageReference Include="Swashbuckle. AspNetCore" Version="6.3.0" />
</ItemGroup>

Opdatering af fejlretningsmappe

Hvis du bruger Visual Studio Code (VS Code) til din udvikling, er det vigtigt, at du opdaterer følgende linje i launch.json fil. VS-koden bruger program egenskabsværdi for at gemme debuggerens sti. Dit program vil stadig fungere fint, hvis du ikke opdaterer debugger-mappen, men du vil ikke være i stand til at køre VS Code debugger.

VS Code er en cross-platform editor med understøttelse af kodefejlfinding blandt andre kraftfulde funktioner. Du kan endda installer det på ARM-baserede chips som Raspberry Pi.

Minimal hostingmodel

En af de store opdateringer til det nye .NET 6-framework er en minimal hostingtilgang. Som standard indeholder nye .NET 6-applikationer ikke startup.cs fil. Tjenestekonfiguration og applikations-bootstrapping sker i program.cs fil. Gamle applikationer vil fortsætte med at fungere fint, men overvej at opdatere dem til minimal hosting i fremtiden.

Bemærk: Du behøver ikke bruge minimal hosting, når du migrerer til .NET 6.

Migrer til .NET 6

.NET 6 er den nyeste version af langtidssupport af .NET frameworket. Hvis du stadig bruger .NET 5 i din applikation, er det på høje tid, du opgraderer til .NET 6.

Udviklere har bygget mange nyttige rammer oven på .NET, såsom ASP.NET, webapplikationsrammerne. ASP.NET er en open source-platform, der giver dig mulighed for hurtigt at skabe kraftfulde applikationer. Det kan nu være over 20 år gammelt, men der er stadig stor efterspørgsel efter ASP.NET i dag.

Er ASP.NET værd at lære i 2021?

Læs Næste