Flujo de trabajo de creación de paquetes

La creación de un paquete comienza con el código compilado (normalmente ensamblados de .NET) que desea empaquetar y compartir con otros usuarios, ya sea a través de la galería de nuget.org pública o una galería privada dentro de la organización. El paquete también puede incluir archivos adicionales, como un archivo Léame que se muestra cuando se instala el paquete, y puede incluir transformaciones en determinados archivos de proyecto.

Un paquete también puede servir para incorporar únicamente un número indefinido de otras dependencias, sin incluir ningún código propio. Este paquete es una manera cómoda de entregar un SDK compuesto por varios paquetes independientes. En otros casos, un paquete puede contener solo archivos de símbolos (.pdb) para ayudar a la depuración.

Nota:

Al crear un paquete para el uso de otros, es importante comprender que dependen de tu trabajo. Por lo tanto, la creación y publicación de un paquete también implica un compromiso de corregir errores y realizar otras actualizaciones, o al menos hacer que el paquete esté disponible como código abierto para que otros usuarios puedan ayudarle a mantenerlo.

Independientemente del caso, la creación de un paquete comienza por decidir su identificador, número de versión, licencia, información de copyright y cualquier otro contenido necesario. Una vez hecho esto, puede usar el comando "pack" para reunir todo en un .nupkg archivo. Este archivo se puede publicar en un repositorio NuGet, como nuget.org.

Sugerencia

Un paquete NuGet con la .nupkg extensión es simplemente un archivo ZIP. Para examinar fácilmente el contenido de cualquier paquete, cambie la extensión a .zip y expanda su contenido como de costumbre. Asegúrese de volver a cambiar la extensión a .nupkg antes de intentar cargarla en un host.

Para aprender y comprender el proceso de creación, comience con Creación de un paquete que le guía a través de los procesos principales comunes a todos los paquetes.

Desde allí, puede considerar una serie de otras opciones para el paquete:

• La compatibilidad con varias plataformas de destino describe cómo crear un paquete con varias variantes para diferentes .NET Framework.
• La creación de paquetes localizados describe cómo estructurar un paquete con varios recursos de idioma y cómo usar paquetes satélite localizados independientes.
• Paquetes de versión preliminar muestra cómo publicar paquetes alfa, beta y rc para aquellos clientes interesados.
• Transformaciones de archivos de origen y de configuración describe cómo puede realizar sustituciones de tokens unidireccionales en archivos que se agregan a un proyecto, y modificar web.config y app.config con configuraciones que también se revierten cuando se desinstala el paquete.
• Paquetes de símbolos ofrece instrucciones para proporcionar símbolos para tu biblioteca que permiten a los consumidores navegar por tu código durante la depuración.
• El versionado de paquetes describe cómo identificar las versiones exactas que se permiten para las dependencias (otros paquetes que se consumen desde su paquete).
• Paquetes nativos describe el proceso para crear un paquete para consumidores de C++.
• Paquetes de firma describe el proceso para agregar una firma digital a un paquete.

Cuando esté listo para publicar un paquete en nuget.org, siga el proceso sencillo de Publicación de un paquete.

Si desea usar una fuente privada en lugar de nuget.org, consulte la información general sobre paquetes de hospedaje.