Incremente uma versão semântica: major, minor ou patch
Obtenha o próximo número de versão sem deslizes: um incremento minor transforma 2.7.4 em 2.8.0, zerando o patch, e qualquer sufixo de pré-lançamento ou de build é removido porque começa uma nova linha de versões. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Exemplo resolvido
- Versão
- 2.7.4
- Tipo de incremento
- Minor
- Versão original
- 2.7.4
- Versão incrementada
- 2.8.0
A ferramenta de incremento de versão semântica calcula o próximo número de lançamento a partir de uma string válida de Semantic Versioning 2.0.0 e do tipo escolhido. Selecione major, minor ou patch; o componente solicitado será incrementado e todos os componentes inferiores voltarão a zero. Rótulos de pré-lançamento e metadados de build são removidos porque o resultado representa uma nova linha de lançamento normal. A validação estrita identifica versões malformadas e nomes de incremento incompatíveis antes que cheguem a scripts, publicação de pacotes, changelogs ou pipelines de entrega contínua.
Escolha a mudança de lançamento que deseja comunicar
Semantic Versioning atribui um significado diferente a cada um dos três números centrais, portanto o incremento correto começa pelo tipo de mudança lançada. A calculadora incrementa major e redefine minor e patch como zero, transformando 4.8.6 em 5.0.0. Escolha minor quando uma funcionalidade for adicionada de modo retrocompatível.
Isso incrementa minor e zera patch, fazendo 4.8.6 virar 4.9.0. Escolha patch para correções retrocompatíveis e obtenha 4.8.7 com a mesma entrada. A operação é intencionalmente mecânica: ela não examina código-fonte, commits ou changelogs e não pode decidir se uma mudança quebra compatibilidade.
Essa classificação continua pertencendo à sua política de lançamentos. Depois da escolha, porém, a aritmética é consistente e repetível. A separação é útil quando uma pessoa, um rótulo de pull request ou um analisador de commits determina a categoria e precisa de um cálculo final confiável.
Entenda a validação estrita e a remoção de sufixos
A versão deve seguir exatamente Semantic Versioning 2.0.0, com os componentes major, minor e patch presentes. Exemplos válidos incluem 1.2.3, 2.0.0-rc.1 e 3.4.5+linux.x64. Formas flexíveis como v1.2.3, 1.2 ou números centrais com zeros à esquerda são rejeitadas, não corrigidas silenciosamente.
Identificadores de pré-lançamento e metadados de build são validados como parte da entrada, mas nenhum sufixo permanece no resultado incrementado. Um incremento inicia um novo número central: aplicar patch a 2.1.0-beta.3 produz 2.1.1, enquanto minor produz 2.2.0. Esse comportamento evita carregar um rótulo antigo para uma nova linha.
O tipo também é uma escolha finita e estrita: major, minor ou patch em minúsculas. Essa rigidez é valiosa na automação porque erros de digitação, atalhos de gerenciadores de pacotes e versões incompletas param de modo visível antes de criar uma tag incorreta que talvez seja difícil retirar após a publicação.
Use aritmética determinística na automação de lançamentos
A calculadora foi projetada como uma etapa pequena e determinística em um fluxo maior. O processamento não usa rede, relógio, valor aleatório, modelo externo nem estado armazenado; entradas idênticas sempre geram saídas idênticas. Os componentes numéricos são incrementados como strings de dígitos decimais, em vez de números JavaScript.
Isso preserva o comportamento exato mesmo para componentes válidos acima do intervalo inteiro seguro e elimina arredondamentos inesperados. Use o executor do navegador em verificações ocasionais.
Casos de uso
Prepare o lançamento de um pacote
Calcule a próxima versão do manifesto após a aprovação de um lançamento major, minor ou patch.
Conduza um pipeline de entrega contínua
Transforme uma classificação obtida de rótulos ou commits em uma versão determinística para as etapas seguintes.
Valide uma versão proposta
Compare o incremento calculado com a versão de uma solicitação antes de criar tags ou publicar artefatos.
Perguntas frequentes
O que cada tipo de incremento faz?
Major incrementa major e zera minor e patch. Minor incrementa minor e zera patch. Patch incrementa somente patch.
Os rótulos de pré-lançamento são mantidos?
Não. Um sufixo válido é aceito na entrada, mas removido da nova versão central.
Os metadados de build afetam o resultado?
Não. Metadados válidos são aceitos e depois removidos no cálculo da nova versão.
É possível usar v no início ou omitir patch?
Não. A entrada deve ser uma string Semantic Versioning 2.0.0 estrita com os três componentes centrais.
A ferramenta decide qual incremento minha mudança precisa?
Não. Ela não lê código, commits nem notas de versão e não sabe dizer se uma mudança quebra a compatibilidade. Você ou suas regras de publicação escolhem major, minor ou patch; depois a conta é feita sempre do mesmo jeito.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/dev2/semver-bump \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"version":"2.7.4","bump_type":"minor"}'const res = await fetch("https://api.kit.forhosting.com/dev2/semver-bump", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"version": "2.7.4",
"bump_type": "minor"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/dev2/semver-bump",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"version": "2.7.4",
"bump_type": "minor"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev2/semver-bump", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"version":"2.7.4","bump_type":"minor"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"version":"2.7.4","bump_type":"minor"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev2/semver-bump", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"version": "2.7.4",
"bump_type": "minor"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "dev2.semver_bump",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Escolha a mudança de lançamento que deseja comunicar
Escolha major quando a nova versão contiver mudanças incompatíveis na API pública.
Entenda a validação estrita e a remoção de sufixos
Qualquer outro nome retorna invalid_input.
Use aritmética determinística na automação de lançamentos
Envie a versão atual e o tipo aprovado; depois use bumped_version para atualizar um manifesto, criar uma branch, rotular um artefato ou propor uma tag. A resposta também repete original_version e bump_type, facilitando a auditoria de logs e telas de aprovação sem reconstruir a solicitação. Quando um serviço de build, uma CLI ou a integração contínua precisar do cálculo programaticamente, chame a API por US$ 0,002 por item e trate invalid_input como um problema nos dados do lançamento que deve ser corrigido antes da publicação.
Perguntas técnicas
O que acontece com um tipo desconhecido?
A solicitação retorna invalid_input. Somente major, minor e patch são reconhecidos.
Quanto custa a API?
O preço da API é US$ 0,002 por item; o executor no navegador está disponível para verificações interativas.