Compartilhar via

Gerenciar dependências de pacote em aplicativos .NET

Este artigo explica como adicionar e remover dependências de pacote editando o arquivo de projeto ou usando a CLI.

O elemento <PackageReference>

O <PackageReference> elemento de arquivo de projeto tem a seguinte estrutura:

<PackageReference Include="PACKAGE_ID" Version="PACKAGE_VERSION" />

O Include atributo especifica a ID do pacote a ser adicionado ao projeto. O Version atributo especifica a versão a ser obtido. As versões são especificadas de acordo com as regras de versão do NuGet.

Use condições para adicionar uma dependência disponível apenas em um destino específico, conforme mostrado no exemplo a seguir:

<PackageReference Include="PACKAGE_ID" Version="PACKAGE_VERSION" Condition="'$(TargetFramework)' == 'netcoreapp2.1'" />

A dependência no exemplo anterior só será válida se o build estiver acontecendo para esse destino determinado. A condição $(TargetFramework) é uma propriedade do MSBuild que está sendo definida no projeto. Para a maioria dos aplicativos .NET comuns, você não precisa fazer isso.

Adicionar e remover dependências

Você pode adicionar e remover dependências editando seu arquivo de projeto ou por meio de comandos da CLI do .NET .

Editar o arquivo de projeto

Para adicionar uma dependência, adicione um <PackageReference> item dentro de um <ItemGroup> elemento. Você pode adicionar a um existente <ItemGroup> ou criar um novo.

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

  <PropertyGroup>
    ...
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.EntityFrameworkCore" Version="3.1.2" />
  </ItemGroup>

</Project>

Para remover uma dependência, remova seu <PackageReference> item do arquivo de projeto.

Utilizar a CLI

Para adicionar uma dependência, execute o dotnet package add comando, conforme mostrado no exemplo a seguir. (Se você estiver usando uma versão SDK do .NET 9 ou anterior, use o formulário dotnet add package.)

dotnet package add Microsoft.EntityFrameworkCore

Para remover uma dependência, execute o dotnet package remove comando, conforme mostrado no exemplo a seguir. (Se você estiver usando uma versão SDK do .NET 9 ou anterior, use o formulário dotnet remove package.)

dotnet package remove Microsoft.EntityFrameworkCore

Dicas

  • Não inclua entradas para a operação de restauração no arquivo .targets ou .props de um pacote referenciado. Essas entradas podem incluir PackageReference itens, ExcludeAssets atributos, feeds do NuGet a serem usados ou outra configuração do NuGet. Os arquivos .targets e .props dos pacotes não são usados até que a restauração do NuGet seja concluída. Tudo o que for necessário para restauração precisa estar no arquivo de projeto ou no arquivo .targets do projeto em si, não em uma dependência de pacote.

  • Se você quiser usar ASP.NET APIs em um aplicativo de console ou biblioteca de classes, adicione um item FrameworkReference ao arquivo de projeto:

    <FrameworkReference Include="Microsoft.AspNetCore.App" />

    Para obter mais informações, consulte Usar a estrutura compartilhada do ASP.NET Core.

Consulte também

  • Last updated on