Búsqueda y evaluación de paquetes NuGet para el proyecto

Al iniciar de cualquier proyecto de .NET, o cada vez que identifique una necesidad funcional para la aplicación o el servicio, puede ahorrar mucho tiempo y evitar problemas si usa paquetes NuGet existentes que satisfagan esa necesidad. Estos paquetes pueden proceder de la colección pública en nuget.org o de un origen privado proporcionado por su organización o por terceros.

Búsqueda de paquetes

Cuando visite nuget.org o abra la interfaz de usuario del administrador de paquetes en Visual Studio, verá una lista de paquetes ordenados por relevancia. Se muestran los paquetes más usados en todos los proyectos de .NET. Es muy posible que algunos de estos paquetes resulten útiles para sus propios proyectos.

En nuget.org, observe el botón Filtro situado en la parte superior derecha de la página. Al hacer clic en él, el panel de búsqueda avanzada se expande para presentar las opciones de ordenación y filtrado.

Puede usar el filtro Tipo de paquete para mostrar los paquetes de un tipo específico:

• All types : Éste es el comportamiento predeterminado. Muestra todos los paquetes independientemente de su tipo.
• Dependency : paquetes de NuGet normales que se pueden instalar en el proyecto.
• .NET tool : filtra las .NET tool, un paquete de NuGet que contiene una aplicación de consola.
• Template : filtra las Template, que se pueden usar para crear proyectos mediante el comando dotnet new.

Puede usar la opción Ordenar por para ordenar los resultados de la búsqueda:

• Relevance : Éste es el comportamiento predeterminado. Ordena los resultados de acuerdo con un algoritmo de puntuación interno.
• Downloads : ordena los resultados de la búsqueda según el número total de descargas, en orden descendente.
• Recently updated : ordena los resultados de la búsqueda según la fecha de creación de última versión, en orden cronológico descendente.

En la sección Opciones, podemos encontrar la casilla . Cuando se activa, nuget.org muestra todas las versiones de los paquetes, incluidas las versiones preliminares. Para mostrar solo las versiones estables, desactive la opción.

Para aplicar los filtros de búsqueda, haga clic en el botón Apply . Siempre puede volver al comportamiento predeterminado; para ello, haga clic en el botón Reset .

También puede usar la sintaxis de búsqueda para filtrar por etiquetas, propietarios e identificadores de paquete.

¿Admite el paquete la plataforma de destino del proyecto?

NuGet solo instala un paquete en un proyecto si las plataformas admitidas de ese paquete incluyen la plataforma de destino del proyecto. Si el paquete no es compatible, NuGet emite un error.

Algunos paquetes enumeran las plataformas que admiten directamente en la galería de nuget.org pero, como estos datos no son necesarios, muchos paquetes no incluyen esa lista. En la actualidad no hay ningún medio para buscar en nuget.org paquetes que admitan una plataforma de destino específica (la característica se está considerando, vea Problema 2936 de NuGet).

Afortunadamente, puede determinar las plataformas admitidas a través de otros dos medios:

1. Intentar instalar un paquete en un proyecto mediante el comando Install-Package en la consola del Administrador de paquetes NuGet. Si el paquete no es compatible, este comando muestra las plataformas admitidas del paquete.

2. Descargar el paquete desde su página en nuget.org mediante el vínculo Descarga manual bajo Información. Cambie la extensión de .nupkg a .zip y abra el archivo para examinar el contenido de su carpeta lib. Aquí se ven las subcarpetas de cada una de las plataformas admitidas, y cada subcarpeta se denomina con un moniker de la plataforma de destino (TFM; vea Plataformas de destino). Si no ve ninguna subcarpeta bajo lib y solo un archivo DLL, debe intentar instalar el paquete en el proyecto para descubrir su compatibilidad.

Paquetes de versión preliminar

Muchos autores de paquetes ofrecen versiones preliminares y beta mientras continúan realizando mejoras y buscan comentarios sobre las revisiones más recientes.

De forma predeterminada, en nuget.org se muestran los paquetes de versión preliminar en los resultados de la búsqueda. Para buscar solo las versiones estables, desactive la opción Incluir versión preliminar en el panel de búsqueda avanzada, al que se puede acceder con el botón Filtro situado en la parte superior derecha de la página.

En Visual Studio, cuando se usa la CLI de NuGet, NuGet no incluye las versiones preliminares de forma predeterminada. Para cambiar este comportamiento, siga estos pasos:

• Interfaz de usuario del Administrador de paquetes en Visual Studio: en la interfaz de usuario del Administrador de paquetes NuGet, active la casilla Incluir versión preliminar. Al activar o desactivar esta casilla se actualiza la interfaz de usuario del Administrador de paquetes y la lista de versiones disponibles que puede instalar.

  

• Administrador de paquetes Console:use el modificador con los comandos , , , y Find-PackageGet-PackageInstall-PackageSync-PackageUpdate-Package . Consulte la referencia de PowerShell.

• nuget.exe CLI:use el modificador con los comandos , , y installupdatedeletemirror . Consulte la referencia de la CLI de NuGet

• dotnet.exe CLI:especifique la versión exacta de la versión previa mediante el argumento . Consulte la Referencia de dotnet add package.

Paquetes nativos de C++

NuGet admite paquetes de C++ nativos que se pueden usar en proyectos de C++ en Visual Studio. Esto habilita el comando de menú contextual Administrar NuGet paquetes para proyectos, presenta una plataforma de destino y proporciona MSBuild integración.

Para buscar paquetes nativos en nuget.org, busque mediante . Estos paquetes suelen proporcionan archivos .targets y .props, que NuGet importa de forma automática cuando el paquete se agrega a un proyecto.

Evaluación de paquetes

La mejor forma de evaluar la utilidad de un paquete consiste en descargarlo y probarlo en el código (por cierto, todos los paquetes en nuget.org se analizan habitualmente en busca de virus). Después de todo, todos los paquetes muy conocidos empezaron siendo usados solo por unos pocos desarrolladores, y es posible que usted sea uno de los primeros usuarios.

Al mismo tiempo, usar un paquete NuGet significa tomar una dependencia en él, por lo que querrá asegurarse de que es eficaz y confiable. Como la instalación y las pruebas directas de un paquete llevan mucho tiempo, también puede obtener información sobre la calidad de un paquete con la información en la página de listado de un paquete:

• Estadísticas de descargas: en la página de paquetes en nuget.org, en la sección Estadísticas se muestra el total de descargas, las descargas de la versión más reciente y el promedio diario de descargas. Los números más altos indican que muchos otros desarrolladores han tomado una dependencia en el paquete, lo que significa que ha demostrado su valor.

  

• Usado por: en la página del paquete, en la sección Usado por se enumeran los cinco paquetes más populares de NuGet.org y los repositorios de GitHub conocidos que dependen de este paquete. Los paquetes y repositorios que dependen de este paquete se pueden denominar "dependientes" de este paquete. Los paquetes y los repositorios dependientes se pueden considerar "aprobaciones" de este paquete, ya que los creadores del paquete han elegido confiar y depender de él.

  • Un paquete dependiente debe depender de cualquier versión de este paquete en su versión estable más reciente que se indique. Esta definición garantiza que los paquetes dependientes mostrados son un reflejo actualizado de la decisión del creador del paquete de confiar en este paquete y depender de él. Los que dependen de versiones preliminares no se muestran, ya que todavía no se consideran aprobaciones de pleno derecho. Para ver ejemplos, consulte la tabla siguiente:

    Versiones del paquete A	¿El paquete A se muestra lista como dependiente del paquete B?
    v1.0.0 v1.1.0 (estable más reciente): > paquete B v1.2.0-preview	TRUE, la versión estable más reciente depende del paquete B
    v1.0.0-- > Paquete B v1.1.0 (última versión estable) v1.2.0-preview	FALSE, la última versión estable no depende del Paquete B
    v1.0.0-- > Paquete B v1.1.0 (última versión estable) v1.2.0-preview: > paquete B	FALSE, la última versión estable no depende del Paquete B

  • El número de estrellas de un repositorio GitHub generalmente indica la popularidad del repositorio entre los usuarios de GitHub (más estrellas por lo general significan mayor popularidad). Visite la página de Introducción de GitHub para obtener más información sobre el sistema de clasificación de estrellas y repositorios de GitHub.

    

    Nota

    La sección Usado por de un paquete se genera de forma automática, periódicamente, sin revisión humana de repositorios concretos y solo con fines informativos para mostrarle los paquetes de NuGet.org y los repositorios de GitHub conocidos que dependen del paquete.

• Historial de versiones: en la página del paquete, busque en Información la fecha de la última actualización y examine el Historial de versiones. Un paquete con un mantenimiento correcto tiene actualizaciones recientes y un historial de versiones completo. Los paquetes desatendidos tienen pocas actualizaciones y a menudo no se han actualizado desde hace tiempo.

  

• Instalaciones recientes: en la página del paquete, bajo Estadísticas, seleccione ver estadísticas completas. En la página de estadísticas completas se muestran las instalaciones del paquete en las últimas seis semanas por número de versión. Un paquete que otros desarrolladores usan de forma activa normalmente es una opción más indicada que uno que no lo sea.

• Soporte técnico: en la página del paquete bajo Información, seleccione Sitio del proyecto (si está disponible) para ver qué opciones de soporte técnico ofrece el autor. Un proyecto con un sitio dedicado generalmente tiene mejor soporte técnico.

• Historial del desarrollador: en la página del paquete bajo Propietarios, seleccione un propietario para ver qué otros paquetes ha publicado. Aquellos con varios paquetes tienen más probabilidades de seguir ofreciendo soporte técnico para su trabajo en el futuro.

• Contribuciones de código abierto: muchos paquetes se mantienen en repositorios de código abierto, lo que permite a los desarrolladores que dependen directamente de ellos contribuir con correcciones de errores y mejoras de características. El historial de contribuciones de cualquier paquete también es un buen indicador de cuántos desarrolladores están implicados de forma activa.

• Entrevistar a los propietarios: sin duda los nuevos desarrolladores pueden estar igual de comprometidos a crear paquetes excelentes para que los use, y es conveniente darles la oportunidad de aportar algo nuevo al ecosistema de NuGet. Con esto en mente, contacte directamente con los desarrolladores de paquetes a través de la opción Póngase en contacto con los propietarios bajo Información en la página de listado. Lo más probable es que estén encantados de trabajar con usted para satisfacer sus necesidades.

• Prefijos de identificador de paquete reservados: muchos propietarios de paquetes han solicitado y se les ha concedido un prefijo de identificador de paquete reservado. Cuando vea la marca de verificación visual junto a un identificador de paquete en nuget.org, o bien en Visual Studio, significa que el propietario del paquete ha cumplido nuestros criterios para la reserva del prefijo de identificador. Esto significa que el propietario del paquete está siendo claro en lo que respecta a su identificación y la del paquete.

Desuso de la dirección URL de licencia

A medida que hacemos la transición de URL de licencia a licencia, es posible que algunos clientes y fuentes de NuGet aún no puedan mostrar información de licencias en algunos casos. Para mantener la compatibilidad con versiones anteriores, la dirección URL de licencia apunta a este documento, que trata sobre cómo recuperar la información de licencia en estos casos.

Si al hacer clic en la dirección URL de licencia para un paquete llegó a esta página, el paquete contiene un archivo de licencia y

• Está conectado a una fuente que aún no sabe cómo interpretar y exponer la nueva información de licencia para el cliente O
• Usa un cliente que aún no sabe cómo interpretar y leer la nueva información de licencia que potencialmente proporciona la fuente O
• Una combinación de ambos

Aquí le mostramos cómo puede leer la información contenida en el archivo de licencia dentro del paquete:

1. Descargue el paquete NuGet y descomprima su contenido en una carpeta.
2. Abra el archivo .nuspec, que estaría en la raíz de esa carpeta.
3. Debe tener una etiqueta como <license type="file">license\license.txt</license>. Esto implica que el archivo de licencia se denomina license.txt y está dentro de una carpeta denominada license, que a su vez estaría en la raíz de esa carpeta.
4. Navegue hasta la carpeta license y abra el archivo license.txt.

Para obtener MSBuild equivalente a establecer la licencia en , vea Empaquetado de una expresión de .nuspec licencia o un archivo de .nuspec.

Sintaxis de búsqueda

Las consultas de búsqueda nuget.org, desde la CLI de NuGet y dentro de la extensión NuGet Administrador de paquetes de Visual Studio, usan la misma sintaxis. En general, la búsqueda se aplica a palabras clave, así como a descripciones de paquetes.

• Filtrado avanzado:puede aplicar un término de búsqueda a una propiedad específica mediante la sintaxis donde (sin mayúsculas y minúsculas) puede ser <property> , , , , , , , , id y packageidversiontitletagsauthordescriptionsummaryowner . Puede buscar varias propiedades al mismo tiempo. Las búsquedas en la propiedad id son coincidencias de subcadena, mientras que packageid y owner usan una coincidencia exacta sin distinción entre mayúsculas y minúsculas. Ejemplos:

PackageId:jquery             # Match the package ID in an exact, case-insensitive manner

owner:microsoft              # Match the owner in an exact, case-insensitive manner

id:NuGet.Core                # Match any part of the ID property
Id:"Nuget.Core"
ID:jQuery
id:jquery id:ui              # Search for multiple terms in the ID
id:jquery tags:validation    # Search multiple properties

invalid:jquery ui            # Unsupported properties are ignored, so this
                             # is the same as searching on ui