dotnet-csomaglista

Ez a cikk a következő verziókra vonatkozik: ✔️ .NET 6 SDK és újabb verziók

Név

dotnet package list – Egy projekt vagy megoldás csomaghivatkozásait sorolja fel.

Megjegyzés

Ha .NET 9 SDK-t vagy korábbi verziót használ, használja helyette az "első ige" űrlapot (dotnet list package). A "főnév első" űrlap a .NET 10-ben lett bevezetve. További információ: Konzisztensebb parancsrend.

Áttekintés

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

Leírás

A dotnet package list parancs kényelmes lehetőséget biztosít egy adott projekt vagy megoldás összes NuGet-csomaghivatkozásának listázására. A .NET 10-től kezdve a parancs szükség esetén automatikusan végrehajtja a visszaállítást az eredmények létrehozása előtt. A korábbi verziókban először létre kell készítenie/vissza kell állítania a projektet ahhoz, hogy a parancs feldolgozásához szükséges eszközök fel tudjanak készülni. Az alábbi példa a dotnet package list projekt parancsának kimenetét mutatja be:

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.

A Kért oszlop a projektfájlban megadott csomagverzióra hivatkozik, és tartomány lehet. A Megoldott oszlop felsorolja a projekt által jelenleg használt verziót, és mindig egyetlen érték. A nevük melletti (A) megjelenítő csomagok implicit csomaghivatkozásokat jelölnek, amelyek a projekt beállításaiból (Sdk típusból, <TargetFramework> vagy <TargetFrameworks> tulajdonságból) következtetnek.

Ha ki szeretné hagyni az automatikus visszaállítást, használhatja ezt a --no-restore lehetőséget. Példa 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.

A --outdated lehetőséggel megtudhatja, hogy vannak-e újabb verziók a projektekben használt csomagok közül. Alapértelmezés szerint --outdated felsorolja a legújabb stabil csomagokat, kivéve, ha a feloldott verzió szintén előzetes verzió. Ha az újabb verziók listázásakor előzetes verziókat szeretne felvenni, adja meg a --include-prerelease lehetőséget is. Ha frissíteni szeretne egy csomagot a legújabb verzióra, használja a dotnet-csomag hozzáadását.

Az alábbi példa az előző példával megegyező projekt dotnet package list --outdated --include-prerelease parancsának kimenetét mutatja be:

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

Ha tudnia kell, hogy a projekt tranzitív függőségekkel rendelkezik-e, használja a --include-transitive lehetőséget. Tranzitív függőségek akkor fordulnak elő, ha olyan csomagot vesz fel a projektbe, amely egy másik csomagra támaszkodik. Az alábbi példa a dotnet package list --include-transitive projekt parancsának futtatásából származó kimenetet mutatja be, amely a legfelső szintű csomagokat és az ezektől függő csomagokat jeleníti meg:

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

Érvek

PROJECT | SOLUTION

A működtetni kívánt projekt- vagy megoldásfájl. Ha nincs megadva, a parancs az aktuális könyvtárban keres egyet. Ha egynél több megoldás vagy projekt található, a rendszer hibát jelez.

Beállítások

  • --config <SOURCE>

    Az újabb csomagok keresésekor használandó NuGet-források. A --outdated beállítás szükséges.

  • --deprecated

    Az elavult csomagokat jeleníti meg.

  • -f|--framework <FRAMEWORK>

    Csak a megadott cél-keretrendszeralkalmazható csomagokat jeleníti meg. Több keretrendszer megadásához ismételje meg többször a beállítást. Például: --framework net6.0 --framework netstandard2.0. A lehetőség rövid formája (-f) a .NET 9 SDK-tól kezdve érhető el.

  • -?|-h|--help

    A parancs használatának leírását nyomtatja ki.

  • --highest-minor

    Csak azokat a csomagokat veszi figyelembe, amelyek főverziószáma megegyezik az újabb csomagok keresésekor. A --outdated vagy --deprecated beállítást igényli.

  • --highest-patch

    Az újabb csomagok keresésekor csak azokat a csomagokat veszi figyelembe, amelyek fő- és alverziószámainak megfelelőek. A --outdated vagy --deprecated beállítást igényli.

  • --include-prerelease

    Az újabb csomagok keresésekor az előzetes verziójú csomagokat veszi figyelembe. A --outdated vagy --deprecated beállítást igényli.

  • --include-transitive

    A felső szintű csomagok mellett az átvitt csomagokat is listázza. A beállítás megadásakor megjelenik azoknak a csomagoknak a listája, amelyektől a legfelső szintű csomagok függenek.

  • --interactive

    Lehetővé teszi, hogy a parancs leálljon, és várja meg a felhasználói bemenetet vagy műveletet. Például a hitelesítés befejezéséhez.

  • --no-restore

    A parancs futtatása előtt ne állítsa vissza a visszaállítást.

  • --outdated

    Azokat a csomagokat sorolja fel, amelyek újabb verziókkal rendelkeznek.

  • -s|--source <SOURCE>

    Az újabb csomagok keresésekor használandó NuGet-források. A --outdated vagy --deprecated beállítást igényli.

  • -v|--verbosity <LEVEL>

    A parancs részletességi szintjét állítja be. Az engedélyezett értékek a következőkq[uiet]: , m[inimal], n[ormal]d[etailed]és diag[nostic]. Az alapértelmezett érték a minimal. További információ: LoggerVerbosity.

  • --vulnerable

    Az ismert biztonsági résekkel rendelkező csomagok listája. Nem kombinálható --deprecated vagy --outdated beállításokkal. A .NET SDK 9.0.300-tól elérhető beállítás a <AuditSources> konfigurációs fájl tulajdonságával adja meg a sebezhetőségi adatok forrását, amelyet a VulnerabilityInfo erőforrástól szerez be. Ha <AuditSources> nincs megadva, a rendszer a megadott <PackageSources> használja a biztonságirés-adatok betöltésére. További információ: Naplózási források és A NuGet-csomagok biztonsági réseinek vizsgálata.

  • --format <console|json>

    A jelentés kimeneti formátumának beállítása. Az engedélyezett értékek console, json. Alapértelmezett érték: console. A .NET SDK 7.0.200-tól érhető el.

  • --output-version <VERSION>

    Beállítja a jelentés kimeneti verzióját. Az engedélyezett érték 1. Alapértelmezett érték: 1. A --format json beállítás szükséges. Ha új JSON-verzió érhető el, a parancs alapértelmezés szerint létrehozza az új formátumot. Ezzel a beállítással megadhatja, hogy a parancsnak egy korábbi formátumot kell létrehoznia. A .NET SDK 7.0.200-tól érhető el.

Példák

  • Adott projekt csomaghivatkozásainak listázása:

    dotnet package list --project SentimentAnalysis.csproj

  • Az újabb verziókkal rendelkező csomaghivatkozások listázása, beleértve az előzetes verziókat is:

    dotnet package list --outdated --include-prerelease

  • Adott cél keretrendszer csomaghivatkozásainak listázása:

    dotnet package list --framework netcoreapp3.0

  • Csomaghivatkozások listázása géppel olvasható json kimeneti formátumban:

    dotnet package list --format json

  • Egy adott cél keretrendszer csomaghivatkozásainak listázása géppel olvasható JSON-kimeneti formátumban:

    dotnet package list --framework netcoreapp3.0 --format json

  • A csomaghivatkozások gépi olvasható JSON-kimenetének mentése, beleértve a tranzitív függőséget és a biztonságirés részleteit egy fájlba:

    dotnet package list --include-transitive --vulnerable --format json >> dependencyReport.json

  • Csomaghivatkozások listázása géppel olvasható json kimeneti formátumban, 1- es kimeneti verzióval:

    dotnet package list --format json --output-version 1
  • Last updated on