dotnet list package

Článek
03/05/2025

Tento článek se vztahuje na: ✔️ .NET Core 3.1 SDK a novější verze

Jméno

dotnet list package – Zobrazí odkazy na balíčky pro projekt nebo řešení.

Přehled

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

Popis

Příkaz dotnet list package nabízí pohodlnou možnost vypsat všechny odkazy na balíčky NuGet pro konkrétní projekt nebo řešení. Nejprve je potřeba sestavit projekt, aby bylo možné zpracovat prostředky potřebné pro tento příkaz. Následující příklad ukazuje výstup příkazu dotnet list package pro projekt 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.

Sloupec Požadovaný odkazuje na verzi balíčku zadanou v souboru projektu a může to být rozsah. Sloupec Vyřešeno uvádí verzi, kterou projekt aktuálně používá, a je vždy jednou hodnotou. Balíčky zobrazující (A) přímo vedle jejich názvů představují implicitní odkazy na balíčky odvozené z nastavení projektu (Sdk typ nebo <TargetFramework> nebo <TargetFrameworks> vlastnost).

Pomocí možnosti --outdated zjistíte, jestli jsou v projektech k dispozici novější verze balíčků, které používáte. Ve výchozím nastavení --outdated vypíše nejnovější stabilní balíčky, pokud není vyřešená verze také předběžnou verzí. Pokud chcete zahrnout předběžné verze při výpisu novějších verzí, zadejte také možnost --include-prerelease. Chcete-li aktualizovat balíček na nejnovější verzi, použijte dotnet přidat balíček.

Následující příklad ukazuje výstup příkazu dotnet list package --outdated --include-prerelease pro stejný projekt jako v předchozím příkladu:

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

Pokud potřebujete zjistit, jestli má váš projekt přechodné závislosti, použijte možnost --include-transitive. Přechodné závislosti nastanou, když do projektu přidáte balíček, který zase spoléhá na jiný balíček. Následující příklad ukazuje výstup spuštění příkazu dotnet list package --include-transitive pro projekt HelloPlugin, který zobrazuje balíčky nejvyšší úrovně a balíčky, na kterých závisí:

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

Argumenty

PROJECT | SOLUTION

Soubor projektu nebo řešení, na kterém se má pracovat. Pokud není zadaný, příkaz vyhledá aktuální adresář. Pokud se najde více řešení nebo projektů, vyvolá se chyba.

Volby

--config <SOURCE>

Zdroje NuGet, které se mají použít při hledání novějších balíčků. Vyžaduje možnost --outdated.
--deprecated

Zobrazí balíčky, které jsou zastaralé.
-f|--framework <FRAMEWORK>

Zobrazí pouze balíčky platné pro zadanou cílovou architekturu . Pokud chcete zadat více architektur, opakujte možnost několikrát. Příklad: --framework net6.0 --framework netstandard2.0. Krátká forma možnosti (-f) je dostupná od sady .NET 9 SDK.

-?|-h|--help

Vytiskne popis použití příkazu.

--highest-minor

Při hledání novějších balíčků bere v úvahu pouze balíčky s odpovídajícím číslem hlavní verze. Vyžaduje možnost --outdated nebo --deprecated.
--highest-patch

Při hledání novějších balíčků bere v úvahu pouze balíčky s odpovídajícími čísly hlavních a podverze. Vyžaduje možnost --outdated nebo --deprecated.
--include-prerelease

Při hledání novějších balíčků považuje balíčky s předběžnými verzemi. Vyžaduje možnost --outdated nebo --deprecated.
--include-transitive

Obsahuje seznam tranzitivních balíčků kromě balíčků nejvyšší úrovně. Při zadávání této možnosti získáte seznam balíčků, na které závisí balíčky nejvyšší úrovně.

--interactive

Umožňuje příkazu zastavit a čekat na uživatelský vstup nebo akci. Například k dokončení ověřování. K dispozici od sady .NET Core 3.0 SDK.

--outdated

Uvádí balíčky, které mají k dispozici novější verze.
-s|--source <SOURCE>

Zdroje NuGet, které se mají použít při hledání novějších balíčků. Vyžaduje možnost --outdated nebo --deprecated.

-v|--verbosity <LEVEL>

Nastaví úroveň podrobností příkazu. Povolené hodnoty jsou q[uiet], m[inimal], n[ormal], d[etailed]a diag[nostic]. Výchozí hodnota je minimal. Další informace najdete v tématu LoggerVerbosity.

--vulnerable

Obsahuje seznam balíčků se známými ohroženími zabezpečení. Nelze kombinovat s možnostmi --deprecated nebo --outdated. Pomocí vlastnosti <AuditSources> v konfiguračním souboru určete zdroj dat ohrožení zabezpečení, která se získávají z prostředku VulnerabilityInfo. Pokud <AuditSources> není zadán, zadaná <PackageSources> se použijí k načtení dat ohrožení zabezpečení. Další informace najdete v tématu Zdroje auditu a Postup kontroly balíčků NuGet z hlediska ohrožení zabezpečení.
--format <console|json>

Nastaví výstupní formát sestavy. Povolené hodnoty jsou console, json. Výchozí hodnota je console. K dispozici od sady .NET SDK 7.0.200.
--output-version <VERSION>

Nastaví výstupní verzi sestavy. Povolená hodnota je 1. Výchozí hodnota je 1. Vyžaduje možnost --format json. Pokud je k dispozici nová verze JSON, příkaz ve výchozím nastavení vytvoří nový formát. Tato možnost vám umožní určit, že příkaz by měl vytvořit starší formát. K dispozici od sady .NET SDK 7.0.200.

Příklady

Výpis odkazů na balíčky konkrétního projektu:
```
dotnet list SentimentAnalysis.csproj package
```
Výpis odkazů na balíčky, které mají k dispozici novější verze, včetně předběžných verzí:
```
dotnet list package --outdated --include-prerelease
```
Výpis odkazů na balíčky pro konkrétní cílovou architekturu:
```
dotnet list package --framework netcoreapp3.0
```
Výpis odkazů na balíčky ve výstupním formátu JSON s možností čtení počítače:
```
dotnet list package --format json
```
Výpis odkazů na balíčky pro konkrétní cílovou architekturu v strojově čitelném výstupním formátu JSON:
```
dotnet list package --framework netcoreapp3.0 --format json
```
Uložte strojově čitelný výstup odkazů na balíčky, včetně přechodných závislostí a podrobností o ohrožení zabezpečení, do souboru:
```
dotnet list package --include-transitive --vulnerable --format json >> dependencyReport.json
```
Výpis odkazů na balíčky ve výstupním formátu JSON s čitelným formátem JSON s výstupem verze 1:
```
dotnet list package --format json --output-version 1
```

Sdílet prostřednictvím