¿Qué ocurre cuando se instala un paquete NuGet?

Simplemente dicho, las distintas herramientas de NuGet normalmente crean una referencia a un paquete en el archivo de proyecto o packages.config, luego realizan una restauración de paquetes, que instala el paquete de forma eficaz. La excepción es nuget install, que solo expande el paquete en una packages carpeta y no modifica ningún otro archivo.

El proceso general es el siguiente:

1. (Todas las herramientas excepto nuget.exe) Registre el identificador y la versión del paquete en el archivo del proyecto o packages.config.

   Si la herramienta de instalación es Visual Studio o la CLI de dotnet, la herramienta intenta instalar primero el paquete. Si no es compatible, el paquete no se agrega al archivo del proyecto o packages.config.

2. Adquiera el paquete:

   • Compruebe si el paquete (por identificador exacto y número de versión) ya está instalado en la carpeta global-packages , como se describe en Administración de los paquetes globales y las carpetas de caché.

   • Si el paquete no está en la carpeta global-packages , intente recuperarlo de los orígenes enumerados en los archivos de configuración. Las configuraciones de asignación de origen de paquete se aplican en este momento. En el caso de los orígenes en línea, intente primero recuperar el paquete de la caché HTTP a menos -NoHttpCache que se especifique con nuget.exe comandos o --no-http-cache se especifique con dotnet restore. (Visual Studio y dotnet add package use siempre la memoria caché). Si se usa un paquete de la memoria caché, aparece "CACHE" en la salida. La memoria caché tiene un tiempo de expiración de 30 minutos.

   • Si el paquete se ha especificado mediante una versión flotante o sin una versión mínima, NuGet se pondrá en contacto con todos los orígenes para averiguar la mejor coincidencia. Ejemplo: 1.*, (, 2.0.0].

   • Si el paquete no está en la caché HTTP, intente descargarlo de los orígenes enumerados en la configuración. Si se descarga un paquete, aparecerá "GET" y "Ok" en la salida. NuGet registra el tráfico HTTP con un nivel de detalle normal.

   • Si el paquete no se puede adquirir correctamente desde ningún origen, se produce un error en la instalación en este momento con un error como NU1103. Tenga en cuenta que los errores de los comandos nuget.exe muestran solo la última fuente comprobada, pero sugieren que el paquete no estaba disponible desde ningún origen.

   Al adquirir el paquete, el orden de los orígenes de la configuración de NuGet puede aplicarse:

   • NuGet comprueba la carpeta de orígenes locales y los recursos compartidos de red antes de comprobar los orígenes HTTP.

3. Guarde una copia del paquete y otra información en la carpeta http-cache como se describe en Administración de los paquetes globales y las carpetas de caché.

4. Si se descarga, instale el paquete en la carpeta global-packages por usuario. NuGet crea una subcarpeta para cada identificador de paquete y, a continuación, crea subcarpetas para cada versión instalada del paquete.

5. NuGet instala las dependencias del paquete según sea necesario. Este proceso puede actualizar las versiones del paquete en el proceso, como se describe en Resolución de dependencias.

6. Actualice otros archivos y carpetas del proyecto:

   • En el caso de los proyectos que usan PackageReference, actualice el gráfico de dependencias del paquete almacenado en obj/project.assets.json. El contenido del paquete no se copia en ninguna carpeta del proyecto.
   • Actualice app.config o web.config si el paquete usa transformaciones de archivos de origen y configuración.

7. (Solo Visual Studio), si está disponible, muestra el archivo léame del paquete en una ventana de Visual Studio.

Disfrute de su codificación productiva con paquetes NuGet.