Central Package Management (CPM) no .NET: Simplificando o Gerenciamento de Pacotes em Grandes Projetos

O gerenciamento de pacotes em projetos .NET evoluiu significativamente ao longo dos anos. Com o advento do Central Package Management (CPM) no .NET, os desenvolvedores ganharam uma ferramenta poderosa para simplificar e padronizar as dependências em projetos complexos e multi-repositórios. Neste artigo, vamos explorar como o CPM funciona, seus benefícios e como configurá-lo em suas aplicações.

O que é o Central Package Management (CPM)?

O Central Package Management foi introduzido como uma funcionalidade opcional no SDK do .NET. Ele permite que você defina todas as versões de pacotes NuGet usados em uma solução ou organização em um único arquivo central, eliminando a necessidade de especificar versões individualmente em cada projeto.

Sem CPM, cada projeto é responsável por especificar suas dependências, o que pode levar a:

• Desalinhamento de versões entre projetos.
• Dificuldade de atualizações devido à falta de visão centralizada.
• Complexidade na revisão de código, especialmente em projetos com dezenas ou centenas de pacotes.

Com CPM, todos esses problemas são mitigados ao centralizar as versões no arquivo Directory.Packages.props.

Benefícios do CPM

1. Consistência: garante que todos os projetos usem as mesmas versões dos pacotes.
2. Facilidade de atualização: atualize versões de pacotes em um único lugar.
3. Simplificação de arquivos de projeto: os arquivos .csproj ficam mais limpos, pois as informações das versões dos pacotes são removidas.
4. Melhoria na produtividade: menos conflitos de versão e menos tempo gasto na resolução de problemas de dependência.

Configurando o CPM

1. Habilitando o CPM

Certifique-se de que você está usando uma versão recente do SDK do .NET (7.0 ou superior). Para ativar o CPM, crie um arquivo chamado Directory.Packages.props na raiz da sua solução e adicione nele a propriedade do MSBuild chamada ManagePackageVersionsCentrally com o valor true conforme exemplo abaixo:

<Project>

    <PropertyGroup>
        <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
    </PropertyGroup>

    <ItemGroup>
        <PackageVersion Include="MediatR" Version="12.0.0" />
    </ItemGroup>

</Project>

2. Referenciando pacotes nos projetos

Com o CPM habilitado, os arquivos .csproj não precisam mais especificar a versão dos pacotes:

<Project Sdk="Microsoft.NET.Sdk">

  <PropertyGroup>
    <TargetFramework>net9.0</TargetFramework>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="MediatR" />
  </ItemGroup>

</Project>

3. Atualizando dependências

Para atualizar um pacote, basta alterar sua versão no arquivo Directory.Packages.props:

<Project>

    <PropertyGroup>
        <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
    </PropertyGroup>

    <ItemGroup>
        <PackageVersion Include="MediatR" Version="12.4.1" />
    </ItemGroup>

</Project>

Todos os projetos que dependem desse pacote serão atualizados automaticamente quando o arquivo for salvo.

Cenários Avançados

CPM com múltiplas soluções

Em ambientes corporativos, é comum que múltiplas soluções compartilhem dependências. Nesse caso, é possível criar um Directory.Packages.props compartilhado em um diretório pai.

Análise de Impacto

Ao atualizar pacotes, você pode usar ferramentas de build, como o dotnet build, para validar se as alterações introduziram problemas.

Integração com DevOps

CPM facilita a automação de verificações de segurança e atualização de pacotes no pipeline CI/CD.

Considerações Finais

O Central Package Management é um recurso indispensável para equipes que trabalham em soluções .NET grandes ou distribuidas. Sua simplicidade e eficácia ajudam a evitar dores de cabeça comuns no gerenciamento de pacotes, aumentando a produtividade e a confiabilidade do sistema.

Se você ainda não experimentou o CPM, este é o momento de adotá-lo e simplificar o gerenciamento de dependências em seus projetos .NET!

Gostou do artigo?

Se você utiliza CPM ou está considerando implementá-lo, compartilhe suas experiências nos comentários! E não se esqueça de seguir para mais dicas sobre .NET e boas práticas de desenvolvimento.

Referências

Central Package Management