Oragon ArchitecturePatterns & Practices

Olá, como vai você?

a partir da seguintes demandas, criei um executável utilizável de linha de comando que ajuda na atualização de Nuspec files.

Premissas

  • Minha solution tem uns 25 projetos e são todas bibliotecas publicáveis no NuGet.
  • Se tentar gerar os pacotes com base no CSPROJ, faltam metadados (assemblyInfo) para preencher todos os campos de metadados do Nuspec
  • Além da falta de metadados no assemblyInfo, para alguns dos projetos, preciso de mais complexos (o csproj não contempla as informações que preciso) embora sejam poucos, eles existem.

 Nuget-600x300[1]

Problemas endereçados

  • Quando adiciono referências no meu projeto, isso não se reflete no nuspec do projeto, mesmo que estas sejam oriundas de pacotes nuget e atualizem o packages.config
  • Os utilitários de linha de comando do Nuspec sabem gerar um novo nuspec, mas não sabem que meus projetos serão dependências nuspec dos próprios projetos, pois na mesma solution, é preferimos adicionar referências por projetos.
  • Gosto de refactoring, e me proponho a cada funcionalidade revalidar o posicionamento e estratégia de empacotamento dos projetos, assim os projetos mudam. Funcionalidades são quebradas em novos projetos, e esse é o dia-a-dia. Ao começar a gerar pacotes nuget, percebi que perdi essa flexibilidade, por causa do esforço de atualização.

Oragon.BuildTools.NugetTools

Endereçando esses problemas, criei um projeto, bem simples. Não passam de 10 classes, está disponível em https://github.com/luizcarlosfaria/Oragon.BuildTools

Executando:

 1) /mergenuspec

Obrigatório

Hoje é a única operação conhecida pelo projeto. Determina que será feito um merge entre seu CSPROJ e seu NUSPEC respectivo.

2) /solution=“D:\Projetos\Oragon.Architecture\[Source]\OragonArchitecture.sln”

Obrigatório

Determina o path completo do arquivo de solução. É com base nele que seus projetos serão identificados.

3) /convertSolutionProjectsInNugetReferences

Opcional

Referências de projetos são consideradas referências nuget com a mesma versão do seu projeto.

4) /createNuspecIfNeed=”.nuget\NuGet.exe”

Se seu projeto ainda não contém um nuspec file, um será criado na pasta “PROPERTIES” de seu projeto.

O endereço do nuget.exe deve ser relativo ao endereço da solução.

Não se preocupe, O executável tanta achar seu arquivo nuspec do projeto dentro da pasta do projeto e dentro da pasta properties do projeto. Com qualquer nome. Se existir somente 1 arquivo, automaticamente assumo que esse é o nuspec do projeto, independente de suas configurações e nomes.

Quando um projeto não possui um arquivo nuspec e esse é criado (usando o parâmetro /createNuspecIfNeed), o arquivo nuspec será criado com o mesmo texto do AssemblieName definido no projeto (Project/PropertyGroup/AssemblyName). Esse mesmo nome será usado como ID e Title. E pode ser mudado a qualquer momento. Essas propriedades não são gerenciadas, apenas criadas quando não existe nuspec para o projeto.

4) /debug

Ao iniciar a execução, um prompt do visual studio será aberto para que você possa realizar o debug. Semelhante à janela de erro não gerenciado, quando executamos apps fora do ambiente de debug.

Informações adicionais

  • O merge será realizado com base nas referências de seu projeto e nas referências explícitas no packages.config.
  • Ao optar por usar o parâmetro “/convertSolutionProjectsInNugetReferences”, as referências de outros projetos da mesma solução serão marcados como nuget references (como exemplo, as linhas em vermelho do passo 2)
  • Ao optar por usar o parâmetro “/createNuspecIfNeed”, será criado um pacote padrão, com algumas automações como:
  • Seu arquivo NUSPEC antigo não é comprometido. Apenas as dependências são recriadas (com base no packages.config e dependendo do parâmetro /convertSolutionProjectsInNugetReferences também das referências do projeto). Demais atributos, valores e propriedades não são gerenciados.

Restrições

  • Testado com soluções baseadas no Visual Studio 2013 (acredito que funcione em soluções do VS2010 e VS2012 também).
  • Suporta apenas arquivo de projeto CSPROJ
  • Suporta NUSPEC 2011/08.

O projeto é bem simples, mas ajuda bastante. Principalmente porque senti muita falta dessas features nativas no nuget.

Depois eu falo de integração contínua com jenkins, gerando pacotes e publicando-os! Esse assunto também é muito interessante

Comente, compartilhe, curta!

Logo abaixo desse texto você encontra os Posts Relacionados, e botões de compartilhamento, em seguida a sessão de comentários!

Gostou? Então aproveite para curtir, compartilhar e enviar comentários, dúvidas ou sugestões.

Conheça o Grupo Arquitetura de Softwate | .NET: Facebook e Telegram
Luiz Carlos Faria: Site, Youtube, Facebook, Twitter, Telegram, Linkedin e Email