Versionamento semântico 2.0.0

Versionamento semântico 2.0.0 (ou Semantic Versioning 2.0.0) propõe regras e requerimentos para atribuição de versão de programas. Se trata de uma tentativa de resolução do problema de versionamento de software denominado “inferno de dependências”, que ocorre quando uma version lock impede que o projeto prossiga com segurança e integridade. Versionamento semântico implica diretamente no controle por numeração, na garantia de compatibilidade do pull request ao considerar os tipos de modificação que os softwares sofrem durante seu desenvolvimento e eventuais atualizações.

Version lock

Ocorre quando a restrição de atualização de uma dependência (um pacote de terceiros) impede que o projeto prossiga com segurança e integridade.

Controle por numeração

versionamento-semantico-2

MAJOR MINOR PATCH PRE-RELEASE
[+Evolução de API] [+Nova funcionalidade] [+Coreção de BUG] [+Aviso de Incompatibilidade]
por mudanças incompatíveis com a versão anterior por funcionalidades implementadas compatíveis com a versão atual MAJOR por resolução de bugs compatível com a MINOR ativa sinalização de não cumprimento do padrão de compatibilidade (ex: prefixos -alpha, -beta)

Exemplos

Determinado software interpreta cliques em tela por piscar de olhos, através de um óculos de realidade virtual (VR). O programa do óculos VR é suportado em sistema operacional Android v. 6.0.0, e necessita de um navegador Chrome na versão igual ou superior a v. 48.0.0, o que sinaliza que qualquer versão do chrome acima de v. 48.0.0 garante suporte ao programa do óculos.

Em um segundo caso, surgiu uma atualização do navegador com 5 novas funcionalidades, e a versão mais atual passa a ser v. 48.5.0. Nesse caso, a atualização do navegador pode ser feita manualmente pela sobreposição direta dos arquivos.

Dependências de software (vendors)

A gestão de dependências é notável em Frameworks onde as dependências (vendors) são gerenciadas de forma automatizada. Uma ferramenta como NPM ou Composer realiza a leitura de um arquivo de configuração (json ou xml), e obtém as versões especificadas em tal arquivo de um repositório na web. Isso faz com que seja dispensável o transporte das vendors em migrações, uma vez que podem ser obtidos com um comando.

Especificação autorada por Tom Preston-Werner. Leia a versão original (em inglês).

Propósito do versionamento semântico

O desenvolvimento iterativo e incremental exige muito com relação à cooperação, organização e segurança no desenvolvimento de software. Adotar a regra de versionamento semântico significa etiquetar conjuntos de mudanças (pull-requests), de modo análogo a gavetas de um arquivo. É possível otimizar, hoje mesmo, o desenvolvimento de suas aplicações com semantic versioning 2.0:

  • Centralização de trabalhos;
  • Segurança para integrações;
  • Organização para trabalho em equipe;
  • Etiquetagem/backup dos trabalhos.
Você já passou por problemas com versionamento? Compartilhe com a gente nos comentários! Ainda sobre construção de software, vale a pena ler o post sobre RESTlike e RESTful.
4 anos trabalhando em projetos PHP são base sólida para assimilação de outras linguagens e busca de novos desafios. A criação de Sistemas Web e Websites responsivos são minha especialidade. Busco constantemente o aperfeiçoamento das técnicas utilizadas com foco em boas práticas através do conhecimento adquirido das metodologias. O conhecimento da língua norte-americana proporciona segurança para programar na língua e entender manuais técnicos. Já em posse dos conceitos, as metas perseguidas têm sido o aprofundamento em JavaScript serverside e aplicações mobile híbridas.