Gerenciar dependências em aplicativos .NET

Este artigo explica como adicionar e remover dependências de pacote, projeto e assembly.

Adicionar e remover dependências de pacote

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

Utilizar a CLI

Para adicionar uma dependência, execute o dotnet package comando para sua versão do SDK:

dotnet package add Microsoft.EntityFrameworkCore

Para remover uma dependência, execute o dotnet package comando para sua versão do SDK:

dotnet package remove Microsoft.EntityFrameworkCore

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>

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.

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

Para obter mais informações sobre o PackageReference item, consulte a referência do MSBuild para projetos do SDK .NET.

Adicionar e remover referências de projeto

Use uma referência projeto a projeto quando seu projeto depender de outro projeto. Para adicionar e remover referências de projeto, edite o arquivo de projeto ou use a CLI.

Utilizar a CLI

Para adicionar uma referência de projeto, execute o dotnet reference comando para sua versão do SDK.

dotnet reference add ../MyLibrary/MyLibrary.csproj

Para remover uma referência de projeto, execute o seguinte comando para sua versão do SDK:

dotnet reference remove ../MyLibrary/MyLibrary.csproj

Editar o arquivo de projeto

O <ProjectReference> elemento de arquivo de projeto identifica o caminho para o projeto referenciado. Para adicionar uma referência de projeto, adicione um <ProjectReference> item dentro de um <ItemGroup> elemento. Você pode adicionar a um existente <ItemGroup> ou criar um novo.

<ItemGroup>
  <ProjectReference Include="../MyLibrary/MyLibrary.csproj" />
</ItemGroup>

Para remover uma referência de projeto, remova o <ProjectReference> elemento do arquivo de projeto.

Para obter mais informações sobre o ProjectReference item, consulte os itens comuns de projeto do MSBuild.

Adicionar e remover referências de assemblies

Você pode adicionar e remover referências de assembly por meio do arquivo de projeto. A CLI do .NET não fornece comandos para adicionar ou remover referências de assembly.

Para fazer referência a um assembly .NET que não faz parte de um projeto ou pacote, adicione um <Reference> elemento ao arquivo de projeto. Use o elemento <HintPath> para especificar o caminho relativo ou absoluto do assembly:

<ItemGroup>
  <Reference Include="MyAssembly">
    <HintPath>lib/MyAssembly.dll</HintPath>
  </Reference>
</ItemGroup>

Para remover uma referência de assembly, remova seu <Reference> elemento do arquivo de projeto.

Para obter mais informações sobre o Reference item, consulte os itens comuns de projeto do MSBuild.

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

  • Última atualização em