dotnet list package

  • Článek

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

Název

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

Synopse

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 poskytuje pohodlnou možnost zobrazit seznam všech odkazů 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 dotnet list package příkazu 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.

Požadovaný sloupec 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><TargetFrameworks> vlastnost).

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

Následující příklad ukazuje výstup dotnet list package --outdated --include-prerelease příkazu 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 tuto --include-transitive možnost. 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í dotnet list package --include-transitive příkazu 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.

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 nebo --outdated--deprecated možnost.

  • --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 nebo --outdated--deprecated možnost.

  • --include-prerelease

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

  • --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 nebo --outdated--deprecated možnost.

  • -v|--verbosity <LEVEL>

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

  • --vulnerable

    Obsahuje seznam balíčků se známými ohroženími zabezpečení. Nelze kombinovat s možnostmi ani --outdated s možnostmi--deprecated. Nuget.org je zdrojem informací o ohrožení zabezpečení. Další informace najdete v tématu Ohrožení zabezpečení a jak zkontrolovat balíčky NuGet.

  • --format <console|json>

    Nastaví výstupní formát sestavy. Povolené hodnoty jsou console, json. Výchozí hodnota consoleje . K dispozici od sady .NET SDK 7.0.200.

  • --output-version <VERSION>

    Nastaví výstupní verzi sestavy. Povolená hodnota je 1. Výchozí hodnota 1je . 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