Como migrar seu aplicativo do Dotnet 5 para o Dotnet 6

A estrutura .NET (Dotnet) foi lançada pela primeira vez no início de 2000. É uma estrutura de desenvolvimento gratuita e de código aberto que você pode usar para desenvolver uma ampla variedade de aplicativos.

A Microsoft interrompeu o suporte oficial do .NET 5 em 8 de maio de 2022. Se você estiver usando o .NET 5 em seus aplicativos, isso significa que seus aplicativos estão mais vulneráveis ​​a violações de segurança. Felizmente, você pode facilmente atualizar ou migrar seus aplicativos para a nova versão LTS do .NET, versão 6.

O que é Dotnet 6?

O .NET 6 é a versão LTS atual da estrutura .NET e lançada em novembro de 2021.

Você pode desenvolver aplicativos usando .NET 6 no Windows, Linux e macOS. Também é suportado nativamente em chips M1 Apple Silicon e sistemas operacionais Windows baseados em Arm.

A estrutura .NET 6 também oferece suporte ao desenvolvimento de aplicativos em várias linguagens, como C# (C-Sharp), Visual Basic e F# (F-Sharp).

Uma das principais vantagens da estrutura .NET é que você pode desenvolver uma ampla variedade de aplicativos com ela. Esses incluem

Aplicativos da Web, jogos, aplicativos móveis e aplicativos de desktop. Além disso, a estrutura é bem testada e documentada.

Instalando o SDK do .NET 6

Você precisará instalar o .NET SDK em seu PC para poder desenvolver aplicativos .NET.

Basta baixar o .NET 6 Software Development Kit (SDK) e instalá-lo em seu PC. O SDK contém todas as ferramentas necessárias para você desenvolver software em .NET 6.

Quando a instalação estiver concluída, você poderá listar os SDKs disponíveis em seu PC usando o seguinte comando .NET CLI:

dotnet --list-sdks

Se você simplesmente deseja verificar a versão em que está, pode executar o seguinte comando:

dotnet --versão

Download: .NET 6 (Livre)

Atualizando a estrutura de destino

Inicie a atualização atualizando a estrutura de destino .NET. Seu aplicativo Web contém um moniker de estrutura de destino, que informa ao seu aplicativo que tipo de tempo de execução .NET usar.

A estrutura de destino para seu aplicativo Web está localizada em seu arquivo XML de projeto de aplicativo. Tem a extensão .csproj. Abra o arquivo de projeto do aplicativo e atualize o moniker TargetFramework localizado na tag PropertyGroup de net5.0 para net6.0

<Grupo de propriedades>
<!-- <Estrutura de destino>net5.0</TargetFramework> -->
<Estrutura de destino>net6.0</TargetFramework>
<UserSecretsId>xxx33795-1b05-xxxx-926f-dcc112c2xxxd</UserSecretsId>
<DockerDefaultTargetOS>Linux</DockerDefaultTargetOS>
</PropertyGroup>

Se seu aplicativo usa o global.json arquivo e certifique-se de atualizar a versão do SDK para "versão": "6.0.100".

Atualizando Referências de Pacotes

A próxima etapa é atualizar as referências do pacote do aplicativo ou as dependências do pacote NuGet. O framework .NET é bastante modular e funciona no conceito de injeção de dependência. Suas referências de pacote NuGet estão localizadas no .csproj arquivo do projeto, sob o marcação.

O número de pacotes NuGet varia de acordo com o tamanho do seu aplicativo e sua complexidade.

O primeiro número em uma versão do pacote NuGet geralmente mostra qual estrutura .NET ele visa, 6, neste caso. Certifique-se de atualizar todos os pacotes NuGet para refletir sua estrutura de destino. O código a seguir à listagem de código mostra o novo pacote em negrito. Os pacotes NuGet antigos são comentados.

<Grupo de itens>
<!-- <PackageReference Include="Microsoft. AspNetCore. Autenticação. JwtBearerGenericName" Versão="5.0.13" /> -->
<!-- <PackageReference Include="Microsoft. EntityFrameworkCore. Projeto" Versão="5.0.9"> -->
<PackageReference Include="Microsoft. AspNetCore. Autenticação. JwtBearerGenericName" Versão="6.0.3" />
<PackageReference Include="Microsoft. EntityFrameworkCore. Projeto" Versão="6.0.3">
<Incluir recursos>tempo de execução; construir; nativo; arquivos de conteúdo; analisadores; construirtransitivo</IncludeAssets>
<Ativos Privados>tudo</PrivateAssets>
</PackageReference>
<!-- <PackageReference Include="Microsoft. EntityFrameworkCore. Servidor SQL" Versão="5.0.9" /> -->
<!-- <PackageReference Include="Microsoft. Estúdio visual. Rede. Geração de Código. Projeto" Versão="5.0.2" /> -->
<!-- <PackageReference Include="Coringa. AspNetCore" Versão="5.6.3" /> -->
<PackageReference Include="Microsoft. EntityFrameworkCore. Servidor SQL" Versão="6.0.3" />
<PackageReference Include="Microsoft. Estúdio visual. Rede. Geração de Código. Projeto" Versão="6.0.2" />
<PackageReference Include="Coringa. AspNetCore" Versão="6.3.0" />
</ItemGroup>

Atualizando o diretório de depuração

Se você estiver usando o Visual Studio Code (VS Code) para seu desenvolvimento, é importante atualizar a seguinte linha no launch.json Arquivo. O VS Code usa o programa valor da propriedade para armazenar o caminho do depurador. Seu aplicativo ainda funcionará bem se você não atualizar a pasta do depurador, mas não poderá executar o depurador do VS Code.

O VS Code é um editor multiplataforma com suporte para depuração de código entre outros recursos poderosos. Você também pode instale-o em chips baseados em ARM como o Raspberry Pi.

Modelo de hospedagem mínima

Uma das principais atualizações da nova estrutura .NET 6 é uma abordagem de hospedagem mínima. Por padrão, novos aplicativos .NET 6 não contêm o startup.cs Arquivo. A configuração do serviço e a inicialização do aplicativo acontecem no program.cs Arquivo. Os aplicativos antigos continuarão funcionando bem, mas considere atualizá-los para hospedagem mínima no futuro.

Observação: Você não precisa usar hospedagem mínima ao migrar para o .NET 6.

Migrar para .NET 6

O .NET 6 é a versão mais recente de Suporte de Longo Prazo da estrutura .NET. Se você ainda estiver usando o .NET 5 em seu aplicativo, é hora de atualizar para o .NET 6.

Os desenvolvedores construíram muitos frameworks úteis em cima do .NET, como ASP.NET, o framework de aplicações web. ASP.NET é uma plataforma de código aberto que permite criar aplicativos poderosos rapidamente. Agora pode ter mais de 20 anos, mas ainda há uma alta demanda por ASP.NET hoje.

Vale a pena aprender ASP.NET em 2021?

Leia a seguir