pacote de lista dotnet

Artigo
03/05/2025

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

Nome

dotnet list package – lista as referências de pacote para um projeto ou solução.

Sinopse

dotnet list [<PROJECT>|<SOLUTION>] package [--config <SOURCE>]
    [--deprecated]
    [-f|--framework <FRAMEWORK>] [--highest-minor] [--highest-patch]
    [--include-prerelease] [--include-transitive] [--interactive]
    [--outdated] [--source <SOURCE>] [-v|--verbosity <LEVEL>]
    [--vulnerable]
    [--format <console|json>]
    [--output-version <VERSION>]

dotnet list package -h|--help

Descrição

O comando dotnet list package fornece uma opção conveniente para listar todas as referências de pacote NuGet para um projeto específico ou uma solução. Primeiro, você precisa criar o projeto para ter os ativos necessários para que esse comando seja processado. O exemplo a seguir mostra a saída do comando dotnet list package para o projeto SentimentAnalysis:

Project 'SentimentAnalysis' has the following package references
   [netcoreapp2.1]:
   Top-level Package               Requested   Resolved
   > Microsoft.ML                  1.4.0       1.4.0
   > Microsoft.NETCore.App   (A)   [2.1.0, )   2.1.0

(A) : Auto-referenced package.

A coluna Solicitada refere-se à versão do pacote especificada no arquivo de projeto e pode ser um intervalo. A coluna Resolveu lista a versão que o projeto está usando no momento e é sempre um único valor. Os pacotes que exibem um (A) ao lado de seus nomes representam referências implícitas de pacote que são inferidas das configurações do projeto ( tipo deSdk ou <TargetFramework> ou propriedade <TargetFrameworks>).

Use a opção --outdated para descobrir se há versões mais recentes disponíveis dos pacotes que você está usando em seus projetos. Por padrão, --outdated lista os pacotes estáveis mais recentes, a menos que a versão resolvida também seja uma versão de pré-lançamento. Para incluir versões de pré-lançamento ao listar versões mais recentes, especifique também a opção --include-prerelease. Para atualizar um pacote para a versão mais recente, use dotnet add package.

O exemplo a seguir mostra a saída do comando dotnet list package --outdated --include-prerelease para o mesmo projeto do exemplo anterior:

The following sources were used:
   https://api.nuget.org/v3/index.json
   C:\Program Files (x86)\Microsoft SDKs\NuGetPackages\

Project `SentimentAnalysis` has the following updates to its packages
   [netcoreapp2.1]:
   Top-level Package      Requested   Resolved   Latest
   > Microsoft.ML         1.4.0       1.4.0      1.5.0-preview

Se você precisar descobrir se seu projeto tem dependências transitivas, use a opção --include-transitive. As dependências transitivas ocorrem quando você adiciona um pacote ao projeto que, por sua vez, depende de outro pacote. O exemplo a seguir mostra a saída da execução do comando dotnet list package --include-transitive do projeto HelloPlugin, que exibe pacotes de nível superior e os pacotes dos quais eles dependem:

Project 'HelloPlugin' has the following package references
   [netcoreapp3.0]:
   Transitive Package      Resolved
   > PluginBase            1.0.0

Argumentos

PROJECT | SOLUTION

O arquivo de projeto ou solução no qual operar. Se não for especificado, o comando pesquisará um no diretório atual. Se mais de uma solução ou projeto for encontrado, um erro será gerado.

Opções

--config <SOURCE>

As fontes do NuGet a serem usadas ao pesquisar pacotes mais recentes. Requer a opção --outdated.
--deprecated

Exibe pacotes que foram preteridos.
-f|--framework <FRAMEWORK>

Exibe apenas os pacotes aplicáveis à estrutura de destino especificada. Para especificar várias estruturas, repita a opção várias vezes. Por exemplo: --framework net6.0 --framework netstandard2.0. A forma curta da opção (-f) está disponível a partir do SDK do .NET 9.

-?|-h|--help

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

--highest-minor

Considera apenas os pacotes com um número de versão principal correspondente ao pesquisar pacotes mais recentes. Requer a opção --outdated ou --deprecated.
--highest-patch

Considera apenas os pacotes com números de versão principais e menores correspondentes ao pesquisar pacotes mais recentes. Requer a opção --outdated ou --deprecated.
--include-prerelease

Considera pacotes com versões de pré-lançamento ao pesquisar pacotes mais recentes. Requer a opção --outdated ou --deprecated.
--include-transitive

Lista pacotes transitivos, além dos pacotes de nível superior. Ao especificar essa opção, você obtém uma lista de pacotes dos quais os pacotes de nível superior dependem.

--interactive

Permite que o comando pare e aguarde a entrada ou ação do usuário. Por exemplo, para concluir a autenticação. Disponível desde o SDK do .NET Core 3.0.

--outdated

Lista os pacotes que têm versões mais recentes disponíveis.
-s|--source <SOURCE>

As fontes do NuGet a serem usadas ao pesquisar pacotes mais recentes. Requer a opção --outdated ou --deprecated.

-v|--verbosity <LEVEL>

Define o nível de verbosidade do comando. Os valores permitidos são q[uiet], m[inimal], n[ormal], d[etailed]e diag[nostic]. O padrão é minimal. Para obter mais informações, consulte LoggerVerbosity.

--vulnerable

Lista pacotes que têm vulnerabilidades conhecidas. Não é possível combinar com opções de --deprecated ou --outdated. Use a propriedade <AuditSources> no arquivo de configuração para especificar a fonte de dados de vulnerabilidade, que é adquirida do recurso VulnerabilityInfo. Se <AuditSources> não for especificado, os <PackageSources> especificados serão usados para carregar dados de vulnerabilidade. Para obter mais informações, consulte fontes de auditoria e Como verificar pacotes NuGet em busca de vulnerabilidades de segurança.
--format <console|json>

Define o formato de saída do relatório. Os valores permitidos são console, json. O padrão é console. Disponível a partir do SDK do .NET 7.0.200.
--output-version <VERSION>

Define a versão de saída do relatório. O valor permitido é 1. O padrão é 1. Requer a opção --format json. Quando uma nova versão JSON estiver disponível, o comando produzirá o novo formato por padrão. Essa opção permitirá que você especifique que o comando deve produzir um formato anterior. Disponível a partir do SDK do .NET 7.0.200.

Exemplos

Listar referências de pacote de um projeto específico:
```
dotnet list SentimentAnalysis.csproj package
```
Listar referências de pacote que têm versões mais recentes disponíveis, incluindo versões de pré-lançamento:
```
dotnet list package --outdated --include-prerelease
```
Listar referências de pacote para uma estrutura de destino específica:
```
dotnet list package --framework netcoreapp3.0
```
Listar referências de pacote no formato de saída json legível do computador:
```
dotnet list package --format json
```
Listar referências de pacote para uma estrutura de destino específica no formato de saída json legível do computador:
```
dotnet list package --framework netcoreapp3.0 --format json
```
Salve a saída json legível do computador de referências de pacote, incluindo detalhes de dependência transitiva e vulnerabilidade em um arquivo:
```
dotnet list package --include-transitive --vulnerable --format json >> dependencyReport.json
```
Listar referências de pacote no formato de saída json legível do computador com a versão de saída 1:
```
dotnet list package --format json --output-version 1
```

Compartilhar via