Sdílet prostřednictvím

seznam balíčků dotnet

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

Název

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

Poznámka:

Pokud používáte sadu .NET 9 SDK nebo starší, použijte místo toho "sloveso first" (dotnet list package). Ve verzi .NET 10 byl zaveden formulář "první podstatné jméno". Další informace naleznete v tématu Konzistentnější pořadí příkazů.

Přehled

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

dotnet package list -h|--help

Popis

Příkaz dotnet package list nabízí pohodlnou možnost vypsat všechny odkazy na balíčky NuGet pro konkrétní projekt nebo řešení. Počínaje rozhraním .NET 10 příkaz před generováním výsledků automaticky provede obnovení v případě potřeby. Ve starších verzích musíte nejprve sestavit nebo obnovit 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 package list pro projekt SentimentAnalysis:

Restore complete (5.9s)

Build succeeded in 6.0s
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).

Pokud chcete automatické obnovení přeskočit, můžete použít tuto --no-restore možnost. Příklad dotnet package list --no-restore:

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.

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. Pokud chcete balíček aktualizovat na nejnovější verzi, použijte dotnet package add.

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

Restore complete (0.6s)

Build succeeded in 0.7s

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 package list --include-transitive pro projekt HelloPlugin, který zobrazuje balíčky nejvyšší úrovně a balíčky, na kterých závisí:

Restore complete (0.6s)

Build succeeded in 0.7s
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.

Možnosti

  • --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. Napří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í.

  • --no-restore

    Před spuštěním příkazu se neobnovujte.

  • --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. Tato možnost je dostupná od sady .NET SDK 9.0.300. Tato možnost používá <AuditSources> vlastnost v konfiguračním souboru k určení zdroje 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 package list --project SentimentAnalysis.csproj

  • Výpis odkazů na balíčky, které mají k dispozici novější verze, včetně předběžných verzí:

    dotnet package list --outdated --include-prerelease

  • Výpis odkazů na balíčky pro konkrétní cílovou architekturu:

    dotnet package list --framework netcoreapp3.0

  • Výpis odkazů na balíčky ve výstupním formátu JSON s možností čtení počítače:

    dotnet package list --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 package list --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 package list --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 package list --format json --output-version 1
  • Last updated on