Partilhar via

dotnet adicionar pacote

  • Artigo

Este artigo aplica-se a: ✔️ SDK do .NET Core 3.1 e versões posteriores

Nome

dotnet add package - Adiciona ou atualiza uma referência de pacote em um arquivo de projeto.

Sinopse

dotnet add [<PROJECT>] package <PACKAGE_NAME>
    [-f|--framework <FRAMEWORK>] [--interactive]
    [-n|--no-restore] [--package-directory <PACKAGE_DIRECTORY>]
    [--prerelease] [-s|--source <SOURCE>] [-v|--version <VERSION>]

dotnet add package -h|--help

Description

O dotnet add package comando fornece uma opção conveniente para adicionar ou atualizar uma referência de pacote em um arquivo de projeto. Quando você executa o comando, há uma verificação de compatibilidade para garantir que o pacote seja compatível com as estruturas no projeto. Se a verificação for aprovada e o pacote não for referenciado no arquivo de projeto, um <PackageReference> elemento será adicionado ao arquivo de projeto. Se a verificação for aprovada e o pacote já estiver referenciado no arquivo de projeto, o <PackageReference> elemento será atualizado para a versão compatível mais recente. Depois que o arquivo de projeto é atualizado, a restauração dotnet é executada.

Por exemplo, adicionar Microsoft.EntityFrameworkCore a ToDo.csproj produz uma saída semelhante ao exemplo a seguir:

  Determining projects to restore...
  Writing C:\Users\username\AppData\Local\Temp\tmp24A8.tmp
info : Adding PackageReference for package 'Microsoft.EntityFrameworkCore' into project 'C:\ToDo\ToDo.csproj'.
info :   CACHE https://api.nuget.org/v3/registration5-gz-semver2/microsoft.entityframeworkcore/index.json
info :   GET https://pkgs.dev.azure.com/dnceng/9ee6d478-d288-47f7-aacc-f6e6d082ae6d/_packaging/516521bf-6417-457e-9a9c-0a4bdfde03e7/nuget/v3/registrations2-semver2/microsoft.entityframeworkcore/index.json
info :   CACHE https://api.nuget.org/v3/registration5-gz-semver2/microsoft.entityframeworkcore/page/0.0.1-alpha/3.1.3.json
info :   CACHE https://api.nuget.org/v3/registration5-gz-semver2/microsoft.entityframeworkcore/page/3.1.4/7.0.0-preview.2.22153.1.json
info :   CACHE https://api.nuget.org/v3/registration5-gz-semver2/microsoft.entityframeworkcore/page/7.0.0-preview.3.22175.1/7.0.0-preview.3.22175.1.json
info :   NotFound https://pkgs.dev.azure.com/dnceng/9ee6d478-d288-47f7-aacc-f6e6d082ae6d/_packaging/516521bf-6417-457e-9a9c-0a4bdfde03e7/nuget/v3/registrations2-semver2/microsoft.entityframeworkcore/index.json 257ms
info : Restoring packages for C:\ToDo\ToDo.csproj...
info : Package 'Microsoft.EntityFrameworkCore' is compatible with all the specified frameworks in project 'C:\ToDo\ToDo.csproj'.
info : PackageReference for package 'Microsoft.EntityFrameworkCore' version '6.0.4' added to file 'C:\ToDo\ToDo.csproj'.
info : Writing assets file to disk. Path: C:\ToDo\obj\project.assets.json
log  : Restored C:\ToDo\ToDo.csproj (in 171 ms).

O arquivo ToDo.csproj agora contém um <PackageReference> elemento para o pacote referenciado.

<PackageReference Include="Microsoft.EntityFrameworkCore" Version="6.0.4" />

Se o projeto estiver integrado ao Central Package Management (CPM), o <PackageVersion> elemento no Directory.Packages.props file será adicionado/atualizado e o <PackageReference> elemento será adicionado ao arquivo do projeto.

Os cenários a seguir são suportados atualmente. Estes exemplos pressupõem que a versão mais recente do Microsoft.EntityFrameworkCore é 6.0.4. Cenários adicionais relacionados ao CPM estão documentados nesta especificação de design.

Cenário 1: <PackageReference> não existe no arquivo de projeto, <PackageVersion> o elemento não existe no , e o Directory.Packages.props fileargumento version não é passado da linha de comando.

Comando da CLI que é executado: dotnet add ToDo.csproj package Microsoft.EntityFrameworkCore

O <PackageVersion> elemento é adicionado ao Directory.Packages.props file.

<PackageVersion Include="Microsoft.EntityFrameworkCore" Version="6.0.4" />

O <PackageReference> elemento é adicionado ao arquivo de projeto.

<PackageReference Include="Microsoft.EntityFrameworkCore" />

Cenário 2: <PackageReference> não existe no arquivo de projeto, <PackageVersion> o Directory.Packages.props fileelemento não existe no , e o argumento version é passado da linha de comando.

Comando da CLI que é executado: dotnet add ToDo.csproj package Microsoft.EntityFrameworkCore --version 5.0.4

O <PackageVersion> elemento é adicionado ao Directory.Packages.props file.

<PackageVersion Include="Microsoft.EntityFrameworkCore" Version="5.0.4" />

O <PackageReference> elemento é adicionado ao arquivo de projeto.

<PackageReference Include="Microsoft.EntityFrameworkCore" />

Cenário 3: <PackageReference> não existe no arquivo de projeto, <PackageVersion> o Directory.Packages.props fileelemento existe no , e o argumento version não é passado da linha de comando.

Comando da CLI que é executado: dotnet add ToDo.csproj package Microsoft.EntityFrameworkCore

O <PackageVersion> elemento é adicionado ao Directory.Packages.props file.

<PackageVersion Include="Microsoft.EntityFrameworkCore" Version="6.0.4" />

O <PackageReference> elemento é adicionado ao arquivo de projeto.

<PackageReference Include="Microsoft.EntityFrameworkCore" />

Cenário 4: <PackageReference> não existe no arquivo de projeto, <PackageVersion> o Directory.Packages.props fileelemento existe no , e o argumento version é passado da linha de comando.

Comando da CLI que é executado: dotnet add ToDo.csproj package Microsoft.EntityFrameworkCore --version 5.0.4

O <PackageVersion> elemento é adicionado ao Directory.Packages.props file.

<PackageVersion Include="Microsoft.EntityFrameworkCore" Version="5.0.4" />

O <PackageReference> elemento é adicionado ao arquivo de projeto.

<PackageReference Include="Microsoft.EntityFrameworkCore" />

Restauração implícita

Você não precisa executar dotnet restore porque ele é executado implicitamente por todos os comandos que exigem uma restauração para ocorrer, como dotnet new, dotnet build, dotnet run, dotnet test, dotnet publishe dotnet pack. Para desativar a restauração implícita, use a --no-restore opção.

O dotnet restore comando ainda é útil em determinados cenários em que a restauração explícita faz sentido, como compilações de integração contínua nos Serviços de DevOps do Azure ou em sistemas de compilação que precisam controlar explicitamente quando a restauração ocorre.

Para obter informações sobre como gerenciar feeds NuGet, consulte a dotnet restore documentação.

Argumentos

  • PROJECT

    Especifica o arquivo de projeto. Se não for especificado, o comando procura um no diretório atual.

  • PACKAGE_NAME

    A referência do pacote a ser adicionada.

Opções

  • -f|--framework <FRAMEWORK>

    Adiciona uma referência de pacote somente ao direcionar uma estrutura específica.

  • -?|-h|--help

    Imprime uma descrição de como usar o comando.

  • --interactive

    Permite que o comando pare e aguarde a entrada ou ação do usuário. Por exemplo, para concluir a autenticação.

  • -n|--no-restore

    Adiciona uma referência de pacote sem executar uma visualização de restauração e verificação de compatibilidade.

  • --package-directory <PACKAGE_DIRECTORY>

    O diretório onde restaurar os pacotes. O local de restauração do pacote padrão está %userprofile%\.nuget\packages no Windows e ~/.nuget/packages no macOS e Linux. Para obter mais informações, consulte Gerenciando os pacotes globais, cache e pastas temporárias no NuGet.

  • --prerelease

    Permite a instalação de pacotes de pré-lançamento. Disponível desde o SDK do .NET Core 5

  • -s|--source <SOURCE>

    O URI da origem do pacote NuGet a ser usado durante a operação de restauração.

  • -v|--version <VERSION>

    Versão do pacote. Consulte Controle de versão do pacote NuGet.

Exemplos

  • Adicionar Microsoft.EntityFrameworkCore pacote NuGet a um projeto:

    dotnet add package Microsoft.EntityFrameworkCore

  • Adicione uma versão específica de um pacote a um projeto:

    dotnet add ToDo.csproj package Microsoft.Azure.DocumentDB.Core -v 1.0.0

  • Adicione um pacote usando uma fonte NuGet específica:

    dotnet add package Microsoft.AspNetCore.StaticFiles -s https://dotnet.myget.org/F/dotnet-core/api/v3/index.json

Consulte também