dotnet list package

Artykuł
04/06/2024

Ten artykuł dotyczy: ✔️ zestaw .NET Core 3.1 SDK i nowsze wersje

Nazwisko

dotnet list package — Wyświetla listę odwołań do pakietu dla projektu lub rozwiązania.

Streszczenie

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

opis

Polecenie dotnet list package zapewnia wygodną opcję wyświetlania listy wszystkich odwołań pakietów NuGet dla określonego projektu lub rozwiązania. Najpierw należy skompilować projekt, aby zasoby potrzebne do przetworzenia tego polecenia. Poniższy przykład przedstawia dane wyjściowe dotnet list package polecenia dla projektu 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.

Żądana kolumna odwołuje się do wersji pakietu określonej w pliku projektu i może być zakresem. Kolumna Resolved zawiera wersję używaną obecnie projektu i jest zawsze pojedynczą wartością. Pakiety wyświetlane (A) bezpośrednio obok ich nazw reprezentują niejawne odwołania do pakietów, które są wnioskowane z ustawień projektu (Sdk typ lub <TargetFramework><TargetFrameworks> właściwość).

--outdated Użyj opcji , aby dowiedzieć się, czy w projektach są dostępne nowsze wersje pakietów, których używasz. Domyślnie wyświetla listę najnowszych stabilnych pakietów, --outdated chyba że rozpoznana wersja jest również wersją wstępną. Aby uwzględnić wersje wstępne podczas wyświetlania --include-prerelease listy nowszych wersji, określ również opcję. Aby zaktualizować pakiet do najnowszej wersji, użyj polecenia dotnet add package.

Poniższy przykład przedstawia dane wyjściowe dotnet list package --outdated --include-prerelease polecenia dla tego samego projektu co w poprzednim przykładzie:

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

Jeśli chcesz dowiedzieć się, czy projekt ma przejściowe zależności, użyj --include-transitive opcji . Przejściowe zależności występują podczas dodawania pakietu do projektu, który z kolei opiera się na innym pakiecie. Poniższy przykład przedstawia dane wyjściowe z uruchomienia dotnet list package --include-transitive polecenia dla projektu HelloPlugin , który wyświetla pakiety najwyższego poziomu i pakiety, od których zależą:

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

Argumenty

PROJECT | SOLUTION

Plik projektu lub rozwiązania do działania. Jeśli nie zostanie określony, polecenie przeszukuje bieżący katalog dla jednego. Jeśli zostanie znalezione więcej niż jedno rozwiązanie lub projekt, zostanie zgłoszony błąd.

Opcje

--config <SOURCE>

Źródła NuGet do użycia podczas wyszukiwania nowszych pakietów. --outdated Wymaga opcji .
--deprecated

Wyświetla pakiety, które zostały przestarzałe.
-f|--framework <FRAMEWORK>

Wyświetla tylko pakiety, które mają zastosowanie do określonej platformy docelowej. Aby określić wiele struktur, powtórz tę opcję wiele razy. Na przykład: --framework net6.0 --framework netstandard2.0. Krótka forma opcji (-f) jest dostępna od wersji zestawu .NET 9 SDK.

-?|-h|--help

Wyświetla opis sposobu używania polecenia .

--highest-minor

Uwzględnia tylko pakiety z zgodnym numerem wersji głównej podczas wyszukiwania nowszych pakietów. --outdated Wymaga opcji lub --deprecated .
--highest-patch

Uwzględnia tylko pakiety z zgodnymi numerami wersji głównych i pomocniczych podczas wyszukiwania nowszych pakietów. --outdated Wymaga opcji lub --deprecated .
--include-prerelease

Uwzględnia pakiety z wersjami wstępnymi podczas wyszukiwania nowszych pakietów. --outdated Wymaga opcji lub --deprecated .
--include-transitive

Wyświetla listę pakietów przechodnich oprócz pakietów najwyższego poziomu. Podczas określania tej opcji uzyskasz listę pakietów, od których zależą pakiety najwyższego poziomu.

--interactive

Umożliwia zatrzymanie polecenia i oczekiwanie na wprowadzenie lub działanie użytkownika. Na przykład w celu ukończenia uwierzytelniania. Dostępny od wersji .NET Core 3.0 SDK.

--outdated

Wyświetla listę pakietów, które mają dostępne nowsze wersje.
-s|--source <SOURCE>

Źródła NuGet do użycia podczas wyszukiwania nowszych pakietów. --outdated Wymaga opcji lub --deprecated .

-v|--verbosity <LEVEL>

Ustawia poziom szczegółowości polecenia. Dozwolone wartości to q[uiet], , n[ormal]m[inimal], d[etailed], i diag[nostic]. Wartość domyślna to minimal. Aby uzyskać więcej informacji, zobacz LoggerVerbosity.

--vulnerable

Wyświetla listę pakietów, które mają znane luki w zabezpieczeniach. Nie można połączyć z opcjami --deprecated lub --outdated . Nuget.org jest źródłem informacji o lukach w zabezpieczeniach. Aby uzyskać więcej informacji, zobacz Luki w zabezpieczeniach i Jak skanować pakiety NuGet pod kątem luk w zabezpieczeniach.
--format <console|json>

Ustawia format danych wyjściowych raportu. Dozwolone wartości to console, json. Wartość domyślna to console. Dostępne od wersji 7.0.200 zestawu .NET SDK.
--output-version <VERSION>

Ustawia wersję danych wyjściowych raportu. Dozwolona wartość to 1. Wartość domyślna to 1. --format json Wymaga opcji . Gdy jest dostępna nowa wersja JSON, polecenie domyślnie utworzy nowy format. Ta opcja umożliwia określenie, że polecenie powinno utworzyć wcześniejszy format. Dostępne od wersji 7.0.200 zestawu .NET SDK.

Przykłady

Wyświetlanie listy odwołań do pakietu dla określonego projektu:
```
dotnet list SentimentAnalysis.csproj package
```
Lista odwołań do pakietów, które mają dostępne nowsze wersje, w tym wersje wstępne:
```
dotnet list package --outdated --include-prerelease
```
Lista odwołań pakietów dla określonej platformy docelowej:
```
dotnet list package --framework netcoreapp3.0
```
Lista odwołań do pakietów w formacie wyjściowym json z możliwością odczytu maszyny:
```
dotnet list package --format json
```
Lista odwołań pakietów dla określonej platformy docelowej w formacie wyjściowym json czytelnym dla maszyny:
```
dotnet list package --framework netcoreapp3.0 --format json
```
Zapisz dane wyjściowe json z możliwością odczytu maszyny z odwołaniami do pakietu, w tym przejściowe zależności i szczegóły luk w zabezpieczeniach w pliku:
```
dotnet list package --include-transitive --vulnerable --format json >> dependencyReport.json
```
Wyświetl odwołania do pakietu w formacie wyjściowym json z możliwością odczytu maszyny z danymi wyjściowymi w wersji 1:
```
dotnet list package --format json --output-version 1
```

Udostępnij za pośrednictwem