Blog de Eduardo Sojo

Usando NuGet serie:

• Parte I: ¿Qué es NuGet?
• Parte II: Crear paquetes personalizados
• Parte III: Consumir paquetes
• Parte IV: Crear repositorios personalizado

Podemos crear repositorios personalizados para hospedar nuestros paquetes de NuGet, tanto local como remoto, de tal forma de poder compartir los paquetes en un entorno más allá de nuestras máquinas.

Repositorios locales

1. Seleccionar la carpeta local a utilizar y vaciar los paquetes en ella

2. En Visual Studio, ir a menú Tools – Library Package Manager – Package Manager Settings y agregar el nuevo repositorio

3. Al momento de usar algún paquete presente en nuestro repositorio local no olvidemos seleccionar el repositorio al momento de consultar los paquetes disponibles, tanto en el Package Manager Console como en el Manage NuGet Package

Repositorios remotos

1. Creamos un proyecto de tipo ASP.NET Web Application y borramos todos los archivos y carpetas que se crean por defecto, dejando solo el archivo web.config

2. Una vez creado, agregaremos el paquete NuGet.Server a nuestro proyecto. Si no tienes muy claro cómo hacer esto, puedes consultar esta pequeña referencia haciendo clic AQUÍ

3. Una vez instalado este paquete, nos creará una estructura de archivos y carpetas dentro de nuestro proyecto que contiene el contenido de un sitio web listo para hospedar los paquetes de NuGet .nupkg

4. Finalmente hospedamos todo nuestro proyecto, lo cual nos dará acceso a la ruta http://<mirutaweb>/nuget , la cual será la ruta a compartir y registrar en el Package Manager Settings

Nos leemos,

Usando NuGet serie:

• Parte I: ¿Qué es NuGet?
• Parte II: Crear paquetes personalizados
• Parte III: Consumir paquetes
• Parte IV: Crear repositorios personalizado

Para consumir paquetes de NuGet podemos hacerlo mediante el Manage Nuget Packages o usando el Package Manager Console.

Primero, en caso de querer utilizar repositorios de paquetes diferentes al oficial, debemos configurar los repositorios a consultar por paquetes. Para esto una vez abierto Visual Studio vamos al menú inicio -> Tools -> Package Manager Settings y en la opción Package sources (encontrada en el panel izquierdo) editamos los repositorios a usar.

En caso de usar Package explorer:

1. Creamos un proyecto o abrimos un proyecto existente donde se va a colocar el paquete a usar

2. Podemos abrir el package explorer a través de menú de inicio -> Tools -> Libary Package Manager -> Manage Nuget Packages o ir al Solution Explorer -> Clic derecho en la carpeta de referencias (references) de nuestro proyecto -> Manage Nuget Packages

3. Ya en esta etapa, en la interfaz de Manage Nuget Packages podemos administrar paquetes previamente instalados o instalar nuevos paquetes, seleccionando el deseado y haciendo clic en el botón de instalar. El instalador se encargará de bajar todas las referencias y archivos correspondientes al paquete y colocarlos en la estructura de nuestro proyecto

En caso de usar el Package Manager Console:

1. Creamos un proyecto o abrimos un proyecto existente donde se va a colocar el paquete a usar

2. Podemos abrir la consola a través de menú de inicio -> Tools -> Libary Package Manager -> Package Manager Console

3. Seleccionamos la fuente en la cual buscaremos los paquetes, puede ser en una o en todas las configuradas

4. Con los siguientes comando podemos buscar e instalar un paquete

Get-Package -ListAllAvailable # Lista todos los paquetes disponibles en las fuentes seleccionadas
Get-Package -listAvailable -filter JQuery # Busca los paquetes disponibles en las fuentes seleccionadas filtrando por la condición dada, en este caso JQuery
Install-Package -id jquery # Instala el paquete JQuery en el proyecto seleccionado

Espero sus comentarios y experiencias.

Nos leemos,

Usando NuGet serie:

• Parte I: ¿Qué es NuGet?
• Parte II: Crear paquetes personalizados
• Parte III: Consumir paquetes
• Parte IV: Crear repositorios personalizado

Creación de paquetes

Para crear un paquete podemos realizarlo de 2 formas, usando la linea de comando o un utilitario gráfico como NuGet Package Explorer. Pero antes de comenzar es importante comentar acerca de los 2 archivos principales en el proceso de creación de paquetes:

• .nuspec: Este archivo es una estructura XML que contiene datos importantes del paquete como el nombre del paquete, versión, autor, descripción, entre otros
• .nupkg: Es el paquete resultante y a colocar en el repositorio de NuGet a utilizar para que esté disponible

Podemos crear los paquetes a partir de un ensamblado (assembly) o un proyecto. En lo personal, recomiendo construirlo a partir de un proyecto ya que en el caso de que nuestro proyecto tenga componentes instalados, éstos serán agregados como dependencias al momento de crear el paquete de NuGet.

Usando la linea de comando

Para crear paquetes desde la línea de comando debemos descargar el NuGet.exe Command Line, el cual es el utilitario que nos permitirá crear los paquetes.

Descargamos el NuGet.exe Command Line y lo guardamos en un directorio y esta ruta la debemos agregar a la variable de ambiente de Windows, esto nos permitirá llamar el ejecutable desde cualquier directorio en la consola.

En el caso de generar el paquete a partir de un ensamblado (assembly), ejecutamos los siguientes comandos:

nuget spec MiEnsamblado.dll #Genera el archivo de especificación (.nuspec)
nuget pack MiEnsamblado.nuspec #Genera el paquete a usar (.nupkg)

En caso de generar el paquete a partir de un proyecto, navegamos con la consola hasta el directorio del proyecto, donde se encuentra el archivo .csproj/.vbproj . En este punto ejecutamos los siguientes comandos para crear el archivo de especificaciones y el paquete:

nuget spec #Genera el archivo de especificación (.nuspec)
nuget pack MiProyecto.csproj #Genera el paquete a usar (.nupkg)

Podemos editar el archivo de especificaciones con la información que necesitemos y luego ejecutar el comando para que genere el paquete. Por defecto NuGet usará la configuración por defecto de compilación de la solución, por lo que si necesitamos crear el paquete de otra configuración de compilación, podemos usar el siguiente comando:

nuget pack MiProyecto.csproj -Prop Configuration=Release

Para más información de comandos para la creación de paquetes, se puede consultar el Command Line Reference y Creating and Publishing a Package.

Utilizando un utilitario gráfico (Nuget Package Explorer)

El Nuget Package Explorer es una herramienta desktop que podemos utilizar para crear nuestros paquetes, al presentarse en una interfaz gráfica nos da una vita más rápida de la estructura que va a llevar nuestro paquete así como las dependencias del mismo.

La interfaz que nos muestra esta herramienta se divide en 2, la del lado izquierdo donde ingresaremos los datos iniciales del paquete a crear (título, versión, autor, descripción, dependencias, entre otros) y el lado derecho donde podemos ir armando una estructura de directorio que será la forma en cómo se desplegará el contenido de nuestro paquete en el proyecto donde se incluya.

Una vez suministrada toda la información y creada la estructura, podemos guardar la información, creando el archivo de especificaciones .nuspec (que de igual forma podemos editarlo usando cualquier editor de texto). al momento de estar completo nuestro paquete, podemos darle a la opción exportar en el menú File -> Export para generar el .nupkg o Publish en caso de que quererlo subir al repositorio oficial de NuGet, para lo cual previamente debemos estar registrados y contar con un API key de seguridad (Puedes conseguir mayor información del registro AQUÍ)

Para más información acerca de esta herramienta gráfica para la creación de paquetes, puedes consultar la página del proyecto en http://npe.codeplex.com/

Nos leemos.

Usando NuGet serie:

• Parte I: ¿Qué es NuGet?
• Parte II: Crear paquetes personalizados
• Parte III: Consumir paquetes
• Parte IV: Crear repositorios personalizado

Es un manejador de paquetes que permite instalar y actualizar librerías y herramientas en Visual Studio 2010. Está basado en una extensión la cual se acopla a Visual Studio y es instalada desde el Extension Gallery, agregando funcionalidades de línea de comando (en powershell) e interfaz gráfica para realizar la búsqueda, instalación y actualización de paquetes.

Tiene dos formas principales de navegación:

• Package Manager Console: Es una consola que se habilita dentro de Visual Studio 2010, basado en Powershell, permite consultar, instalar, actualizar y remover paquetes de los proyectos. Para llegar esta consola podemos navegar por el menú Herramientas -> Library package manager -> Package manager console. Algunos comando esenciales:
• Get-Package: Trae todos los paquetes presentes en una solución, si no está abierta una solución, se combina con el parametro -ListAllAvailable para mostrar todos los paquetes presentes en la fuente consultada*.
• Install-Package: Instala un paquete en un proyecto. Si el proyecto está abierto, solo se debe indicar el nombre del paquete a instalar.
• Para conocer más acerca de los comando disponibles, puedes ejecutar en la consola el comando Get-Command *-Package .

• Library Package Reference: Es una interfaz gráfica la cual nos permite realizar las mismas operaciones que en la consola. Se divide en tres paneles. Comenzando por el de la izquierda, donde existen varios tab para navegar el contenido (extensiones instaldas, galería en línea y actualizaciones); un panel central donde visualizamos los paquetes disponibles/instalados/buscados; y un tercer panel donde está las especificiones del paquete seleccionado . Para llegar a esta funcionalidad podemos navegar por el menú Herramientas -> Extension Manager .

Hoy en día existen librerías conocidas ya disponibles en NuGet, algunas de ellas: JQuery, NUnit,NHibernate, Elmah, LinqToTwitter, entre otras. Pueden consultar las librerías disponibles hoy día en http://www.nuget.org/List/Packages .

En las siguientes entregas estaré comentando un poco casos de usos con NuGet como por ejemplo:

• Consumo de paquetes y creación de paquetes personalizados
• Creando repositorios y servidores de NuGet personalizados

Hasta la próxima.