Compartir a través de

paquete de lista dotnet

  • Artículo

Este artículo se aplica a: ✔️ SDK de .NET Core 3.1 y versiones posteriores

Nombre

dotnet list package: enumera las referencias de paquete de un proyecto o solución.

Sinopsis

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

Descripción

El comando dotnet list package proporciona una opción cómoda para enumerar todas las referencias de paquete NuGet para un proyecto específico o una solución. En primer lugar, debe compilar el proyecto para tener los recursos necesarios para que este comando se procese. En el ejemplo siguiente se muestra la salida del comando dotnet list package del proyecto 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 columna Requested hace referencia a la versión del paquete especificada en el archivo del proyecto y puede ser un intervalo. La columna Resuelto enumera la versión que el proyecto está usando actualmente y siempre es un valor único. Los paquetes que muestran un (A) justo junto a sus nombres representan referencias de paquete implícitas que se deducen de la configuración del proyecto (tipo deSdk o propiedad <TargetFramework> o <TargetFrameworks>).

Use la opción --outdated para averiguar si hay versiones más recientes disponibles de los paquetes que usa en los proyectos. De forma predeterminada, --outdated enumera los paquetes estables más recientes a menos que la versión resuelta también sea una versión preliminar. Para incluir versiones preliminares al enumerar versiones más recientes, especifique también la opción --include-prerelease. Para actualizar un paquete a la versión más reciente, use dotnet add package.

En el ejemplo siguiente se muestra la salida del comando dotnet list package --outdated --include-prerelease para el mismo proyecto que el ejemplo anterior:

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 necesita averiguar si el proyecto tiene dependencias transitivas, use la opción --include-transitive. Las dependencias transitivas se producen cuando se agrega un paquete al proyecto que, a su vez, se basa en otro paquete. En el ejemplo siguiente se muestra la salida de ejecutar el comando dotnet list package --include-transitive para el proyecto de HelloPlugin, que muestra los paquetes de nivel superior y los paquetes de los que dependen:

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

Argumentos

PROJECT | SOLUTION

El archivo de proyecto o solución en el que se va a operar. Si no se especifica, el comando busca uno en el directorio actual. Si se encuentra más de una solución o proyecto, se produce un error.

Opciones

  • --config <SOURCE>

    Los orígenes de NuGet que se usarán al buscar paquetes más recientes. Requiere la opción --outdated.

  • --deprecated

    Muestra los paquetes que han quedado en desuso.

  • -f|--framework <FRAMEWORK>

    Muestra solo los paquetes aplicables al marco de de destino especificado. Para especificar varios marcos, repita la opción varias veces. Por ejemplo: --framework net6.0 --framework netstandard2.0. La forma abreviada de la opción (-f) está disponible a partir del SDK de .NET 9.

  • -?|-h|--help

    Imprime una descripción de cómo usar el comando .

  • --highest-minor

    Solo tiene en cuenta los paquetes con un número de versión principal coincidente al buscar paquetes más recientes. Requiere la opción --outdated o --deprecated.

  • --highest-patch

    Solo tiene en cuenta los paquetes con números de versión principal y secundaria coincidentes al buscar paquetes más recientes. Requiere la opción --outdated o --deprecated.

  • --include-prerelease

    Considera los paquetes con versiones preliminares al buscar paquetes más recientes. Requiere la opción --outdated o --deprecated.

  • --include-transitive

    Enumera los paquetes transitivos, además de los paquetes de nivel superior. Al especificar esta opción, obtendrá una lista de paquetes de los que dependen los paquetes de nivel superior.

  • --interactive

    Permite que el comando se detenga y espere a la entrada o acción del usuario. Por ejemplo, para completar la autenticación. Disponible desde el SDK de .NET Core 3.0.

  • --outdated

    Enumera los paquetes que tienen versiones más recientes disponibles.

  • -s|--source <SOURCE>

    Los orígenes de NuGet que se usarán al buscar paquetes más recientes. Requiere la opción --outdated o --deprecated.

  • -v|--verbosity <LEVEL>

    Establece el nivel de detalle del comando. Los valores permitidos son q[uiet], m[inimal], n[ormal], d[etailed]y diag[nostic]. El valor predeterminado es minimal. Para obtener más información, consulte LoggerVerbosity.

  • --vulnerable

    Enumera los paquetes que tienen vulnerabilidades conocidas. No se puede combinar con opciones de --deprecated o --outdated. Use la propiedad <AuditSources> del archivo de configuración para especificar el origen de datos de vulnerabilidad, que se adquiere del recurso VulnerabilityInfo. Si no se especifica <AuditSources>, el <PackageSources> especificado se usa para cargar datos de vulnerabilidad. Para obtener más información, consulte Audit sources and How to scan NuGet packages for security vulnerabilities.

  • --format <console|json>

    Establece el formato de salida del informe. Los valores permitidos son console, json. El valor predeterminado es console. Disponible a partir del SDK de .NET 7.0.200.

  • --output-version <VERSION>

    Establece la versión de salida del informe. El valor permitido es 1. El valor predeterminado es 1. Requiere la opción --format json. Cuando haya disponible una nueva versión JSON, el comando generará el nuevo formato de forma predeterminada. Esta opción le permitirá especificar que el comando debe generar un formato anterior. Disponible a partir del SDK de .NET 7.0.200.

Ejemplos

  • Enumerar las referencias de paquete de un proyecto específico:

    dotnet list SentimentAnalysis.csproj package

  • Enumerar las referencias de paquete que tienen versiones más recientes disponibles, incluidas las versiones preliminares:

    dotnet list package --outdated --include-prerelease

  • Enumerar referencias de paquete para un marco de destino específico:

    dotnet list package --framework netcoreapp3.0

  • Enumerar las referencias de paquete en formato de salida json legible por la máquina:

    dotnet list package --format json

  • Enumerar las referencias de paquete para un marco de destino específico en formato de salida json legible por la máquina:

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

  • Guarde la salida json legible de la máquina de las referencias de paquete, incluidos los detalles de dependencia transitiva y vulnerabilidad en un archivo:

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

  • Enumerar las referencias de paquete en formato de salida json legible por máquina con la versión 1 de salida:

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