dotnet list package

  • Article

Cet article s’applique à :✔️ SDK .NET Core 3.1 et versions ultérieures

Nom

dotnet list package - Liste toutes les références de package d’un projet ou d’une solution.

Synopsis

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

Description

La commande dotnet list package est pratique pour lister toutes les références de packages NuGet à un projet ou à une solution spécifique. Vous devez d’abord générer le projet afin d’obtenir les ressources nécessaires au traitement de cette commande. L’exemple suivant montre le résultat de la commande dotnet list package pour le projet 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.

La colonne Demandée fait référence à la version du package spécifiée dans le fichier projet et peut représenter une plage. La colonne Résolue répertorie la version utilisée par le projet aide et représente toujours une valeur unique. Les packages affichant un (A) en regard de leurs noms représentent des références de package implicites déduites de vos paramètres de projet (le type Sdk ou la propriété <TargetFramework> ou <TargetFrameworks>).

Utilisez l’option --outdated pour savoir s’il existe des versions plus récentes des packages que vous utilisez dans vos projets. Par défaut, --outdated répertorie les derniers packages stables, sauf si la version résolue est également une version préliminaire. Pour inclure des versions préliminaires lors de l’énumération des versions plus récentes, spécifiez également l’option --include-prerelease. Pour mettre à jour un package vers la dernière version, utilisez dotnet add package.

Les exemples suivants montrent le résultat de la commande dotnet list package --outdated --include-prerelease pour le même projet que l’exemple précédent :

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

Si vous avez besoin de savoir si votre projet comporte des dépendances transitives, utilisez l’option --include-transitive. Les dépendances transitives se produisent lorsque vous ajoutez un package à votre projet, qui à son tour s’appuie sur un autre package. L’exemple suivant montre le résultat de l’exécution de la commande dotnet list package --include-transitive pour le projet HelloPlugin, qui affiche les packages de niveau supérieur et ceux dont ils dépendent :

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

Arguments

PROJECT | SOLUTION

Le fichier projet ou solution à traiter. Si aucun fichier n’est spécifié, la commande en recherche un dans le répertoire actuel. Si la commande trouve plusieurs solutions ou projets, une erreur est générée.

Options

  • --config <SOURCE>

    Sources NuGet à utiliser dans la recherche de packages plus récents. Nécessite l’option --outdated.

  • --deprecated

    Liste les packages qui ont été déconseillés.

  • -f|--framework <FRAMEWORK>

    Affiche uniquement les packages applicables au framework cible spécifié. Pour spécifier plusieurs frameworks, exécutez l’option plusieurs fois. Par exemple : --framework net6.0 --framework netstandard2.0. La forme abrégée de l’option (-f) est disponible à partir du Kit de développement logiciel (SDK) .NET 9.

  • -?|-h|--help

    Imprime une description de l’utilisation de la commande.

  • --highest-minor

    Prend en compte uniquement les packages avec un numéro de version majeure correspondant quand vous recherchez des packages plus récents. Nécessite l’option --outdated ou --deprecated.

  • --highest-patch

    Prend en compte uniquement les packages avec des numéros de version majeure et mineure correspondants quand vous recherchez des packages plus récents. Nécessite l’option --outdated ou --deprecated.

  • --include-prerelease

    Prend en compte les packages avec des préversions quand vous recherchez des packages plus récents. Nécessite l’option --outdated ou --deprecated.

  • --include-transitive

    Liste les packages transitifs, en plus des packages de niveau supérieur. Si vous spécifiez cette option, vous obtenez une liste des packages dont dépendent les packages de niveau supérieur.

  • --interactive

    Permet à la commande de s’arrêter et d’attendre une action ou une entrée utilisateur. Par exemple, pour effectuer une authentification. Option disponible à partir du kit SDK .NET Core 3.0.

  • --outdated

    Répertorie les packages avec des versions plus récentes.

  • -s|--source <SOURCE>

    Sources NuGet à utiliser dans la recherche de packages plus récents. Nécessite l’option --outdated ou --deprecated.

  • -v|--verbosity <LEVEL>

    Définit le niveau de détail de la commande. Les valeurs autorisées sont q[uiet], m[inimal], n[ormal], d[etailed] et diag[nostic]. La valeur par défaut est minimal. Pour plus d'informations, consultez LoggerVerbosity.

  • --vulnerable

    Répertorie les packages qui ont des vulnérabilités connues. Ne peut pas être combiné avec les options --deprecated ou --outdated. Nuget.org est la source d’informations sur les vulnérabilités. Pour plus d’informations, consultez Vulnérabilités et Analyse des packages NuGet à la recherche de vulnérabilités de sécurité.

  • --format <console|json>

    Définit le format de sortie des rapports. Les valeurs autorisées sont console, json. La valeur par défaut est console. Disponible à compter du kit SDK .NET 7.0.200.

  • --output-version <VERSION>

    Définit la version de sortie du rapport. La valeur autorisée est 1. La valeur par défaut est 1. Nécessite l’option --format json. Lorsqu’une nouvelle version JSON est disponible, la commande génère le nouveau format par défaut. Cette option vous permet de spécifier que la commande doit générer un format plus ancien. Disponible à compter du kit SDK .NET 7.0.200.

Exemples

  • Répertorier les références de packages d’un projet spécifique :

    dotnet list SentimentAnalysis.csproj package

  • Répertorier les références de packages avec des versions plus récentes, y compris des versions préliminaires :

    dotnet list package --outdated --include-prerelease

  • Répertorier les références de packages pour un framework cible spécifique :

    dotnet list package --framework netcoreapp3.0

  • Répertoriez les références de package dans un format de sortie json lisible par une machine :

    dotnet list package --format json

  • Répertoriez les références de package pour une infrastructure cible spécifique dans un format de sortie json lisible par une machine :

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

  • Enregistrez la sortie json lisible par une machine des références de package, y compris les détails des dépendances et des vulnérabilités transitives dans un fichier :

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

  • Répertoriez les références de package dans un format de sortie json lisible par une machine avec la version de sortie 1 :

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