Flujo de trabajo de consumo de paquetesPackage consumption workflow

Entre la galería de nuget.org y las galerías de paquetes privadas que puede establecer su organización, puede encontrar decenas de miles de paquetes muy útiles para usarlos en sus aplicaciones y servicios.Between nuget.org and private package galleries that your organization might establish, you can find tens of thousands of highly useful packages to use in your apps and services. Pero, independientemente del origen, el consumo de un paquete sigue el mismo flujo de trabajo general.But regardless of the source, consuming a package follows the same general workflow.

Flujo para ir al origen de un paquete, buscar un paquete, instalarlo en un proyecto y agregar una instrucción Using y llamadas a la API del paquete

* Solo Visual Studio y dotnet.ex. El comando nuget install no modifica los archivos de proyecto ni packages.config; las entradas tienen que administrarse manualmente.* Visual Studio and dotnet.ex` only. The nuget install command does not modify project files or packages.config; entries must be managed manually.

Para más información, vea Búsqueda y selección de paquetes y Distintas formas de instalar un paquete NuGet.For further details, see Finding and Choosing Packages and Different ways to install a NuGet package.

NuGet recuerda la identidad y el número de versión de cada paquete instalado y, según el tipo de proyecto y la versión de NuGet, los registra en packages.config o en el archivo del proyecto (con PackageReference).NuGet remembers the identity and version number of each installed package, recording it in either packages.config or the project file (using PackageReference), depending on project type and your version of NuGet. Con NuGet 4.0 y versiones posteriores, es preferible usar PackageReference, aunque esto se puede configurar en Visual Studio mediante las opciones de la interfaz de usuario del Administrador de paquetes.With NuGet 4.0+, PackageReference is preferred, although this is configurable in Visual Studio through the Package Manager UI options. En cualquier caso, puede consultar el archivo adecuado en cualquier momento para ver la lista completa de dependencias del proyecto.In any case, you can look in the appropriate file at any time to see the full list of dependencies for your project.

Sugerencia

Es recomendable comprobar siempre la licencia de cada paquete que vaya a usar en el software.It's prudent to always check the license for each package you intend to use in your software. En nuget.org encontrará un vínculo de información de la licencia a la derecha de la página de descripción de cada paquete.On nuget.org, you find a License Info link on the right side of each package's description page. Si un paquete no especifica los términos de licencia, póngase en contacto directamente con el propietario del paquete mediante el vínculo de contacto con los propietarios de la página del paquete.If a package does not specify license terms, contact the package owner directly using the Contact owners link on the package page. Microsoft no le ofrece licencia para propiedad intelectual de proveedores de paquetes de terceros ni es responsable de la información proporcionada por terceros.Microsoft does not license any intellectual property to you from third party package providers and is not responsible for information provided by third parties.

Al instalar paquetes, NuGet suele comprobar si el paquete ya está disponible en su memoria caché.When installing packages, NuGet typically checks if the package is already available from its cache. Puede borrar manualmente esta memoria caché desde la línea de comandos, tal y como se describe en Administración de paquetes globales y carpetas de caché.You can manually clear this cache from the command line, as described on Managing the global packages and cache folders.

NuGet también garantiza que las plataformas de destino admitidas por el paquete son compatibles con el proyecto.NuGet also makes sure that the target frameworks supported by the package are compatible with your project. Si el paquete no contiene ensamblados compatibles, NuGet muestra un mensaje de error.If the package does not contain compatible assemblies, NuGet displays an error. Vea Resolución de errores de paquetes incompatibles.See Resolving incompatible package errors.

Al agregar el código del proyecto a un repositorio de origen, no se suelen incluir los paquetes de NuGet.When adding project code to a source repository, you typically don't include NuGet packages. Quienes más adelante clonen el repositorio o de alguna manera adquieran el proyecto (por ejemplo, agentes de compilación en sistemas como Visual Studio Team Services), tendrán que restaurar los paquetes necesarios antes de ejecutar una compilación:Those who later clone the repository or otherwise acquire the project, including build agents on systems like Visual Studio Team Services, must restore the necessary packages prior to running a build:

Flujo para restaurar paquetes de NuGet clonando un repositorio y usando un comando de restauración

La restauración de paquetes usa la información del archivo de proyecto o de packages.config para volver a instalar todas las dependencias.Package Restore uses the information in the project file or packages.config to reinstall all dependencies. Tenga en cuenta que existen diferencias en el proceso implicado, como se describe en Dependency Resolution (Resolución de dependencias).Note that there are differences in the process involved, as described in Dependency Resolution. Además, el diagrama anterior no muestra un comando de restauración para la consola del Administrador de paquetes porque se encuentra en la consola y ya está en el contexto de Visual Studio, que normalmente restaura paquetes automáticamente y proporciona el comando de nivel de la solución, tal y como se muestra.Also, the diagram above does not show a restore command for the Package Manager Console because you're with the Console you're already in the context of Visual Studio, which typically restores packages automatically and provides the solution-level command as shown.

A veces es necesario volver a instalar los paquetes que ya están incluidos en un proyecto, que también podrían volver a instalar las dependencias.Occasionally it's necessary to reinstall packages that are already included in a project, which may also reinstall dependencies. Esto resulta sencillo con el comando nuget reinstall o la consola del Administrador de paquetes NuGet.This is easy to do using the nuget reinstall command or the NuGet Package Manager Console. Para más información, vea Reinstalación y actualización de paquetes.For details, see Reinstalling and Updating Packages.

Por último, el comportamiento de NuGet se controla con los archivos Nuget.Config.Finally, NuGet's behavior is driven by Nuget.Config files. Se pueden usar varios archivos para centralizar determinados valores a niveles diferentes, como se explica en Configuración del comportamiento de NuGet.Multiple files can be used to centralize certain settings at different levels, as explained in Configuring NuGet Behavior.

¡Disfrute del proceso de codificación productiva con los paquetes de NuGet!Enjoy your productive coding with NuGet packages!