Comandos do NuGet

No post anterior falei um pouco sobre o NuGet, agora vou listar alguns dos principais comandos para você utilizar no console do Visual Studio.

 

Para exibir o shell de comandos do NuGet, vá no menu View/Other Windows/Package Manage Console.

A seguinte janela irá ficar  visível:


 

No combo do lado esquerdo selecionamos qual será nosso repositório, por padrão ele busca da web mas podemos informar um repositório privado.

No combo do lado direito selecionamos o projeto no qual as referencias serão aplicadas.

Pesquisando um pacote pelo NuGet:

Para pesquisar um pacote, por exemplo o NHibernate basta digitar o seguinte comando:

PM> Get-Package nhibernate -remote

Esse comando trará todos os pacotes que possuem “NHibernate” no nome.

O parametro “- remote” indica que o pacote será pesquisado no repositório selecionado em vez de buscar os pacotes instalados no projeto.

Adicionando referência de um pacote ao Projeto:

Para adicionar a referencia de um pacote, por exemplo o FluentNhibernate:

PM> Install-Package fluentnhibernate

Esse comando instalará o fluent e todas suas  dependências, como por exemplo o NHibernate e Iesi.Collections, ele buscará sempre a versão mais atual.

Para não instalar as dependências basta adicionar o parâmetro  “-ignoreDependencies”

PM> Install-Package fluentnhibernate -IgnoreDependencies

Também podemos informar qual versão desejamos instalar com o parâmetro  -Version

Removendo um pacote do Projeto:

Para remover uma referencia basta usar o comando:

PM> Uninstall-Package FluentNHibernate

Atualizando um pacote adicionado:

Para atualizar um pacote para a versão mais recente:
PM> Update-Package FluentNHibernate

Para atualizar um pacote para uma versão especifica:
PM> Update-Package FluentNHibernate -version 1.0.0

Listando os pacotes Instalados:

Para listar os pacotes instalados a logica é a mesma de quando buscamos no repositorio, basta omitir o parâmetro “-remote”

Para listar todos instalados:
PM> Get-Package

Para buscar algum especifico:
PM> Get-Package nhibernate

 

A documentação completa em inglês pode ser encontrada aqui.

Dica:

O NuGet possui AutoComplete para auxiliar na digitação dos comandos e nomes de pacotes, basta pressionar a tecla Tab depois de digitar o inicio do comando.

NuGet

NuGet é um projeto open source para gerenciar pacotes na plataforma .NET.

Com o NuGet as tarefas de adicionar uma biblioteca,configurar e atualizar ficaram muito mais fáceis.  Basta buscar nele a biblioteca que deseja utilizar que fará o trabalho de configurar seu ambiente e instalar todas as dependências necessárias deixando tudo bem organizado e centralizado.

Por padrão o NuGet buscará as referências em um repositório publico na internet, mas você também pode montar um repositório local na sua empresa para suas bibliotecas, e apontar o nuget para buscar a partir dela.

Por exemplo, para adicionar o FluentNhibernate em nosso projeto da forma convencional precisaríamos seguir os seguintes passos:

  • Entrar no site do NHibernate e baixar a ultima versão.
  • Efetuar o download de todas as dlls dependentes, como por exemplo, o NHibernate.
  • Descompactar e copiar a dll para o nosso projeto.
  • Referenciar as dlls no projeto.
  • Em alguns casos efetuar alguma configuração no webconfig.
  • E torcer para não estar faltando nenhuma outra dependência.

Um pouco trabalhoso não acham? Mas como faríamos isso utilizando o NuGet?

No visual studio (com o plug-in do NuGet instalado) basta abrir o Console do NuGet e digitar a seguinte linha de comando:

Install-Package FluentNHinernate

Pronto! Já está funcionando!, Simples não é mesmo?

Ao executar esse comando, o NuGet vai até o seu repositório publico na internet e busca a versão mais recente do componente, todas suas dependências, efetua o download, joga em uma pasta chamada Packages dentro da sua solution e configura oque for necessário.

Também é possível especificar a versão do componente que será baixado, ignorar as dependências, remover pacotes, buscar por pacotes no repositório, atualizar referencias do projeto para uma versão mais recente, etc etc.

Para instalar o plug-in do NuGet, o projeto está hospedado no codeplex (http://nuget.codeplex.com/) , lá você vai encontrar o código fonte, documentação, exemplos e o plug-in para o visual studio 2010.

A instalação não foge do padrão next, next , finish. E para visualizar o shell após a instalação vá no menu do VisualStudio View/Other Windows/Package Manager Console.

Depois farei um novo post demonstrando os principais comandos.

Abraços,
Rafael Orion