dotnet-listpaket

Artikel
04/06/2024

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

Name

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

Sammanfattning

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

beskrivning

Kommandot dotnet list package ger ett praktiskt alternativ för att visa alla NuGet-paketreferenser för ett specifikt projekt eller en lösning. Du måste först skapa projektet för att de tillgångar som behövs för det här kommandot ska bearbetas. I följande exempel visas utdata från dotnet list package kommandot för SentimentAnalysis-projektet :

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 Begärd 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) höger bredvid deras namn representerar implicita paketreferenser som härleds från dina projektinställningar (Sdk typ eller <TargetFramework><TargetFrameworks> egenskap).

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 --outdated visas de senaste stabila paketen om inte den lösta versionen också är en förhandsversion. Om du vill inkludera 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-tilläggspaketet.

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

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örning av dotnet list package --include-transitive kommandot för HelloPlugin-projektet , som visar paket på den översta nivån och de paket som de är beroende av:

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

Argument

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. 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. --outdated Kräver alternativet eller--deprecated.
--highest-patch

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

Tar hänsyn till paket med förhandsversioner när du söker efter nyare paket. --outdated Kräver alternativet 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.

--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. --outdated Kräver alternativet 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. Nuget.org är källan till information om sårbarheter. Mer information finns i Sårbarheter 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. Standardvärdet är console. Tillgänglig från .NET SDK 7.0.200.
--output-version <VERSION>

Anger rapportens utdataversion. Det tillåtna värdet är 1. Standardvärdet ä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 list SentimentAnalysis.csproj package

Lista paketreferenser som har nyare versioner tillgängliga, inklusive förhandsversioner:
```
dotnet list package --outdated --include-prerelease
```
Lista paketreferenser för ett specifikt målramverk:
```
dotnet list package --framework netcoreapp3.0
```
Lista paketreferenser i maskinläsbart json-utdataformat:
```
dotnet list package --format json
```
Lista paketreferenser för ett specifikt målramverk i maskinläsbart json-utdataformat:
```
dotnet list package --framework netcoreapp3.0 --format json
```
Spara maskinläsbara json-utdata från paketreferenser, inklusive transitiv beroende- och sårbarhetsinformation i en fil:
```
dotnet list package --include-transitive --vulnerable --format json >> dependencyReport.json
```
Lista paketreferenser i datorläsbart json-utdataformat med utdataversion 1:
```
dotnet list package --format json --output-version 1
```

Dela via