Udostępnij za pośrednictwem

dotnet list package

  • Artykuł

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

Nazwa

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 polecenia dotnet list package 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.

Kolumna Requested odnosi 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świetlające (A) bezpośrednio obok ich nazw reprezentują niejawne odwołania do pakietów, które są wnioskowane z ustawień projektu ( typSdk lub <TargetFramework> lub właściwość <TargetFrameworks>).

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

Poniższy przykład przedstawia dane wyjściowe polecenia dotnet list package --outdated --include-prerelease 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 zależności przechodnie, użyj opcji --include-transitive. 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 polecenia dotnet list package --include-transitive dla projektu HelloPlugin, w którym są wyświetlane 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. Wymaga opcji --outdated.

  • --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. Wymaga opcji --outdated lub --deprecated.

  • --highest-patch

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

  • --include-prerelease

    Uwzględnia pakiety z wersjami wstępnymi podczas wyszukiwania nowszych pakietów. Wymaga opcji --outdated 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. Wymaga opcji --outdated lub --deprecated.

  • -v|--verbosity <LEVEL>

    Ustawia poziom szczegółowości polecenia. Dozwolone wartości to q[uiet], m[inimal], n[ormal], 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. Użyj właściwości <AuditSources> w pliku konfiguracji, aby określić źródło danych luk w zabezpieczeniach, które są uzyskiwane z zasobu VulnerabilityInfo. Jeśli <AuditSources> nie zostanie określony, określone <PackageSources> są używane do ładowania danych luk w zabezpieczeniach. Aby uzyskać więcej informacji, zobacz Źródła inspekcji 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. Wymaga opcji --format json. 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