Incremente una versión semántica: major, minor o patch
Obtenga el siguiente número de versión sin despistes: un incremento minor convierte 2.7.4 en 2.8.0, con el patch a cero, y cualquier sufijo preliminar o de compilación desaparece porque empieza una nueva línea de versiones. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Versión
- 2.7.4
- Tipo de incremento
- Minor
- Versión original
- 2.7.4
- Versión incrementada
- 2.8.0
La herramienta para incrementar versiones semánticas calcula el siguiente número de publicación a partir de una cadena válida de Semantic Versioning 2.0.0 y del tipo de incremento elegido. Seleccione major, minor o patch: se aumentará el componente solicitado y todos los componentes inferiores volverán a cero. Las etiquetas de versión preliminar y los metadatos de compilación se eliminan porque el resultado representa una nueva línea de publicación normal. La validación estricta detecta versiones mal formadas y nombres de incremento no admitidos antes de que entren en scripts, paquetes o canalizaciones de entrega.
Elija el cambio de publicación que desea comunicar
Semantic Versioning asigna un significado distinto a cada uno de los tres números principales, por lo que el incremento correcto depende del tipo de cambio que se publica. La calculadora aumenta el componente major y reinicia minor y patch a cero, de modo que 4.8.6 se convierte en 5.0.0. Elija minor cuando se añada funcionalidad de forma retrocompatible.
En ese caso se aumenta minor y se reinicia patch, por lo que 4.8.6 pasa a 4.9.0. Elija patch para correcciones de errores retrocompatibles y obtendrá 4.8.7 con la misma entrada. La operación es deliberadamente mecánica: no inspecciona código fuente, commits ni registros de cambios, y no puede decidir si un cambio rompe compatibilidad.
Esa clasificación sigue perteneciendo a su política de publicación. Una vez elegido el tipo, la aritmética es uniforme y repetible, ideal cuando una persona, una etiqueta o un analizador determina la categoría y necesita un cálculo fiable.
Comprenda la validación estricta y la eliminación de sufijos
La versión debe respetar exactamente Semantic Versioning 2.0.0 e incluir los componentes major, minor y patch. Son válidos ejemplos como 1.2.3, 2.0.0-rc.1 y 3.4.5+linux.x64. Las formas flexibles, como v1.2.3, 1.2 o los números principales con ceros iniciales, se rechazan en lugar de corregirse silenciosamente.
Los identificadores preliminares y los metadatos de compilación se validan como parte de la entrada, pero ningún sufijo se conserva en el resultado incrementado. Un incremento inicia un nuevo número principal: aplicar patch a 2.1.0-beta.3 produce 2.1.1, mientras que aplicar minor produce 2.2.0. Así se evita arrastrar una etiqueta antigua a otra línea de publicación.
El tipo también es una opción finita y estricta: major, minor o patch en minúsculas. Esta rigurosidad permite que errores ortográficos, abreviaturas de gestores de paquetes y versiones incompletas se detengan de forma visible antes de crear una etiqueta incorrecta y difícil de retirar.
Use aritmética determinista en la automatización de publicaciones
La calculadora funciona como un paso pequeño y determinista dentro de un flujo de publicación mayor. El proceso no usa red, reloj, valores aleatorios, modelos externos ni estado almacenado, por lo que entradas idénticas siempre producen resultados idénticos. Los componentes numéricos se incrementan como cadenas de dígitos decimales, no como números de JavaScript.
Esto conserva la exactitud incluso para componentes válidos que superen el intervalo entero seguro y evita redondeos inesperados. Use el ejecutor del navegador para planificación ocasional.
Qué puede hacer con ella
Prepare la publicación de un paquete
Calcule la siguiente versión del manifiesto después de aprobar una publicación major, minor o patch.
Controle una canalización de entrega continua
Convierta una clasificación obtenida de etiquetas o commits en una versión determinista para pasos posteriores.
Valide una versión propuesta
Compare el incremento calculado con la versión de una solicitud antes de crear etiquetas o publicar artefactos.
Preguntas frecuentes
¿Qué hace cada tipo de incremento?
Major aumenta major y reinicia minor y patch. Minor aumenta minor y reinicia patch. Patch solo aumenta patch.
¿Se conservan las etiquetas preliminares?
No. Se acepta un sufijo preliminar válido en la entrada, pero se elimina de la nueva versión principal.
¿Influyen los metadatos de compilación?
No. Los metadatos válidos se aceptan y después se eliminan al calcular la versión nueva.
¿Puede usar una v inicial u omitir patch?
No. La entrada debe ser una cadena Semantic Versioning 2.0.0 estricta con los tres componentes principales.
¿Decide qué incremento necesita mi cambio?
No. No lee código, commits ni notas de versión y no puede saber si un cambio rompe la compatibilidad. Usted o sus reglas de publicación eligen major, minor o patch; después hace la cuenta siempre de la misma manera.
Herramientas relacionadas
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su stack
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)Ejemplo de solicitud
{
"version": "2.7.4",
"bump_type": "minor"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "dev2.semver_bump",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
Notas técnicas
Elija el cambio de publicación que desea comunicar
Elija major cuando la nueva versión contenga cambios incompatibles en la API pública.
Comprenda la validación estricta y la eliminación de sufijos
Cualquier otro nombre devuelve un error invalid_input.
Use aritmética determinista en la automatización de publicaciones
Envíe la versión actual y el tipo aprobado; después use bumped_version para actualizar un manifiesto, crear una rama, etiquetar un artefacto o proponer una etiqueta de repositorio. La respuesta también repite original_version y bump_type, lo que facilita auditar registros y pantallas de aprobación sin reconstruir la solicitud. Cuando un servicio de compilación, una CLI o la integración continua necesiten el mismo cálculo, llame a la API por $0.002 por elemento y trate invalid_input como un problema de datos que debe corregirse antes de publicar.
Preguntas técnicas
¿Qué ocurre con un tipo desconocido?
La solicitud devuelve invalid_input. Solo se reconocen major, minor y patch.
¿Cuánto cuesta la API?
El precio de la API es $0.002 por elemento; el ejecutor del navegador permite comprobaciones interactivas.