Compatibilidade na numeração
O SemVer é uma convenção para indicar, no número de uma versão, como as alterações afetam a API pública (interface de programação de aplicações). Essa interface é o conjunto de funções e comportamentos que o projeto declara disponíveis para outros programas usarem. A compatibilidade depende desse contrato declarado.
O formato MAJOR.MINOR.PATCH separa a versão em três números. A partir de 1.0.0, o terceiro aumenta com correções compatíveis, enquanto a inclusão de uma função pública compatível aumenta o segundo e zera o terceiro. Alterações incompatíveis exigem aumentar o primeiro número e zerar os outros dois.
Quando uma função exige outro argumento
Neste exemplo didático, uma biblioteca na versão 2.4.1 oferece enviarEmail(destinatario). A próxima versão exige também o assunto, sem aceitar as chamadas antigas. Como o argumento adicional é obrigatório, os programas que usam a função precisam de adaptação. Essa alteração corresponde a 3.0.0.
Uma correção interna compatível corresponderia a 2.4.2. Já uma função pública adicional que preservasse o uso existente corresponderia a 2.5.0. Você classifica a alteração pelo efeito no contrato, mesmo quando a mudança ocupa poucas linhas.
Pré-lançamentos e versões iniciais
A série 0.y.z indica desenvolvimento inicial e não pressupõe uma API estável. O identificador 3.0.0-rc.1 marca um pré-lançamento com precedência inferior a 3.0.0. Já os metadados após +, como em 3.0.0+build.7, não alteram a precedência.
Uma versão publicada deve conservar seu conteúdo. O número informa o compromisso de compatibilidade assumido pelo projeto, mas você ainda precisa consultar as notas da versão para identificar as adaptações exigidas na aplicação.
Dúvidas frequentes
Perguntas frequentes sobre SemVer
- O que define a API pública de um projeto?
- O projeto declara, no código ou na documentação, as funções e os comportamentos disponíveis para outros programas usarem. O SemVer classifica a compatibilidade em relação a essa interface.
- A série 0.x tem o mesmo compromisso de compatibilidade?
- A especificação reserva 0.y.z ao desenvolvimento inicial e permite mudanças na API pública. Você precisa consultar a documentação do projeto para avaliar uma atualização nessa série.
- É permitido corrigir o conteúdo de uma versão já publicada?
- Uma versão publicada deve permanecer inalterada. Até uma correção pequena precisa receber outro número de versão, para que a mesma identificação continue apontando para o mesmo conteúdo.
Para continuar
Recursos relacionados
Documentação
SemVer: especificação 2.0.0
Especificação dos incrementos de versão, da compatibilidade da API pública e dos identificadores de pré-lançamento e build.
Abrir recursoSite de referência
DevSide: desenvolvimento colaborativo
Orientação técnica ao vivo para revisar uma alteração de código e seu efeito no uso existente do projeto.
Abrir recursoAplicação na formação
Vibe Coding: Do Zero ao MVP
O desenvolvimento com agentes exige compreender o comportamento da aplicação e conferir o resultado das alterações.
Conhecer a formação
Fontes consultadas
Referências deste verbete
Este verbete ajudou você?
Obrigado pela resposta. Ela fica salva apenas neste navegador.