dotnet-paketlista

Den här artikeln gäller för: ✔️ .NET 6 SDK och senare versioner

Namn

dotnet package list – visar paketreferenserna för ett projekt eller en lösning.

Sammanfattning

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

Beskrivning

Kommandot dotnet package list är ett praktiskt alternativ för att visa alla NuGet-paketreferenser för ett visst projekt eller en lösning. Från och med .NET 10 utför kommandot automatiskt återställning om det behövs innan resultatet genereras. I tidigare versioner måste du först skapa/återställa projektet för att de tillgångar som behövs för att det här kommandot ska kunna bearbetas. I följande exempel visas utdata från kommandot dotnet package list för projektet 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.

Kolumnen Requested refererar till den paketversion som anges i projektfilen och kan vara ett intervall. Kolumnen Löst visar den version som projektet använder för närvarande och är alltid ett enda värde. Paketen som visar en (A) bredvid deras namn representerar implicita paketreferenser som härleds från dina projektinställningar (Sdk typ eller <TargetFramework> eller <TargetFrameworks> egenskap).

Om du vill hoppa över den automatiska återställningen kan du använda alternativet --no-restore . Exempel 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.

Använd alternativet --outdated för att ta reda på om det finns nyare versioner av de paket som du använder i dina projekt. Som standard visar --outdated de senaste stabila paketen såvida inte den lösta versionen också är en förhandsversion. Om du vill ta med förhandsversioner när du listar nyare versioner anger du även alternativet --include-prerelease. Om du vill uppdatera ett paket till den senaste versionen använder du dotnet-pakettillägget.

I följande exempel visas utdata från kommandot dotnet package list --outdated --include-prerelease för samma projekt som i föregående exempel:

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

Om du behöver ta reda på om projektet har transitiva beroenden använder du alternativet --include-transitive. Transitiva beroenden uppstår när du lägger till ett paket i projektet som i sin tur förlitar sig på ett annat paket. I följande exempel visas utdata från körningen av kommandot dotnet package list --include-transitive för projektet HelloPlugin, som visar toppnivåpaket och de paket som de är beroende av:

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

Argumentpunkter

PROJECT | SOLUTION

Projektet eller lösningsfilen som ska användas. Om det inte anges söker kommandot i den aktuella katalogen efter en. Om mer än en lösning eller ett projekt hittas utlöses ett fel.

Alternativ

• --config <SOURCE>

  NuGet-källorna som ska användas när du söker efter nyare paket. Kräver alternativet --outdated.

• --deprecated

  Visar paket som har blivit inaktuella.

• -f|--framework <FRAMEWORK>

  Visar endast de paket som gäller för det angivna målramverket. Om du vill ange flera ramverk upprepar du alternativet flera gånger. Till exempel: --framework net6.0 --framework netstandard2.0. Den korta formen av alternativet (-f) är tillgängligt från och med .NET 9 SDK.

• -?|-h|--help

  Skriver ut en beskrivning av hur du använder kommandot.

• --highest-minor

  Tar endast hänsyn till paketen med ett matchande huvudversionsnummer när du söker efter nyare paket. Kräver alternativet --outdated eller --deprecated.

• --highest-patch

  Tar endast hänsyn till paketen med matchande huvud- och delversionsnummer när du söker efter nyare paket. Kräver alternativet --outdated eller --deprecated.

• --include-prerelease

  Tar hänsyn till paket med förhandsversioner när du söker efter nyare paket. Kräver alternativet --outdated eller --deprecated.

• --include-transitive

  Visar en lista över transitiva paket utöver de översta paketen. När du anger det här alternativet får du en lista över paket som de översta paketen är beroende av.

• --interactive

  Tillåter att kommandot stoppar och väntar på användarens indata eller åtgärd. Till exempel för att slutföra autentiseringen. Tillgänglig sedan .NET Core 3.0 SDK.

• --no-restore

  Återställ inte innan du kör kommandot.

• --outdated

  Visar en lista över paket som har nyare versioner tillgängliga.

• -s|--source <SOURCE>

  NuGet-källorna som ska användas när du söker efter nyare paket. Kräver alternativet --outdated eller --deprecated.

• -v|--verbosity <LEVEL>

  Anger kommandots verbositetsnivå. Tillåtna värden är q[uiet], m[inimal], n[ormal], d[etailed]och diag[nostic]. Standardvärdet är minimal. Mer information finns i LoggerVerbosity.

• --vulnerable

  Visar en lista över paket som har kända säkerhetsrisker. Det går inte att kombinera med --deprecated eller --outdated alternativ. Det här alternativet är tillgängligt från och med .NET SDK 9.0.300 och använder <AuditSources> egenskapen i konfigurationsfilen för att ange källan till sårbarhetsdata som hämtas från VulnerabilityInfo-resursen . Om <AuditSources> inte anges används de angivna <PackageSources> för att läsa in sårbarhetsdata. Mer information finns i Granskningskällor och Så här söker du igenom NuGet-paket efter säkerhetsrisker.

• --format <console|json>

  Anger rapportens utdataformat. Tillåtna värden är console, json. Standardinställningen är console. Tillgänglig från .NET SDK 7.0.200.

• --output-version <VERSION>

  Anger rapportens utdataversion. Det tillåtna värdet är 1. Standardinställningen är 1. Kräver alternativet --format json. När en ny JSON-version är tillgänglig skapar kommandot det nya formatet som standard. Med det här alternativet kan du ange att kommandot ska skapa ett tidigare format. Tillgänglig från .NET SDK 7.0.200.

Exempel

• Lista paketreferenser för ett visst projekt:

  dotnet package list --project SentimentAnalysis.csproj
  

• Lista paketreferenser som har nyare versioner tillgängliga, inklusive förhandsversioner:

  dotnet package list --outdated --include-prerelease
  

• Lista paketreferenser för ett specifikt målramverk:

  dotnet package list --framework netcoreapp3.0
  

• Lista paketreferenser i maskinläsbart json-utdataformat:

  dotnet package list --format json
  

• Lista paketreferenser för ett specifikt målramverk i maskinläsbart json-utdataformat:

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

• Spara maskinläsbara json-utdata från paketreferenser, inklusive transitiv beroende- och sårbarhetsinformation i en fil:

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

• Lista paketreferenser i datorläsbart json-utdataformat med utdataversion 1:

  dotnet package list --format json --output-version 1