O Que É Versionamento Semântico (SemVer)?
O versionamento semântico (SemVer) é uma convenção para números de versão no formato MAJOR.MINOR.PATCH, onde mudanças incompatíveis de API incrementam o MAJOR, funcionalidades retrocompatíveis incrementam o MINOR, e correções retrocompatíveis incrementam o PATCH. Ele permite que os consumidores raciocinem sobre o risco de atualização apenas a partir da versão. É a base de como os gerenciadores de pacotes resolvem faixas de versão compatíveis.
Por que isso importa
SemVer é um contrato compartilhado: uma atualização de patch deve ser segura, uma atualização major pode quebrar você. Respeitá-lo permite que ferramentas atualizem automaticamente dentro de faixas seguras e permite que humanos planejem atualizações que quebram compatibilidade, enquanto violá-lo corrói a confiança em todo o ecossistema de dependências.
Conceitos relacionados
- Faixas de versão e lockfiles dependem das regras do SemVer
- Tags de pré-release marcam release candidates
- Um incremento major sinaliza mudanças que quebram compatibilidade