Formateador de notas de versión
Pega tus notas, un cambio por línea. Se ordenan aquí mismo, en esta página, y no se envía nada a ninguna parte.
Prueba un ejemplo:
Qué hace
Cada actualización necesita unas líneas que digan qué cambió, y la mayoría de las apps de Mac las necesitan en más de un sitio: el texto de What's New en App Store Connect, las notas de versión que Sparkle muestra en su ventana de actualización, y una release de GitHub o una página de changelog. Esta herramienta toma lo que tengas, como notas sin pulir, una lista o las líneas que imprime git log --oneline, y ordena cada línea en Nuevo, Mejorado o Corregido. Quita los hashes de commit, prefijos como feat: y fix: y números de pull request, descarta las líneas que solo te importan a ti, como chore, ci, docs, test y commits de merge, y escribe tres copias que puedes pegar. Después lee el resultado como podría hacerlo App Review.
Adónde va cada copia
| Copiar | Adónde va |
|---|---|
| App Store | What's New in This Version, en App Store Connect. Texto sin formato, hasta 4000 caracteres. Obligatorio en todas las versiones después de la primera. |
| Sparkle | Dentro de la descripción de la versión en tu appcast, envuelto en CDATA, o en una página a la que apunte sparkle:releaseNotesLink. |
| Markdown | Una release de GitHub, un CHANGELOG.md, o Sparkle 2.9 y posterior en macOS 12 y posterior, con sparkle:format="markdown". |
Comandos para ejecutar
git log --oneline v2.0..HEAD git log --pretty=format:"%s" v2.0..HEAD
Ambos listan los commits desde tu última etiqueta de versión, aquí v2.0, uno por línea. El segundo omite los hashes. Pega cualquiera de los dos aquí y luego reescribe las líneas que todavía suenen a nota para ti mismo.
Qué significa cada resultado
| Marca | Qué significa |
|---|---|
| Arreglar | App Store Connect no lo acepta, por ejemplo un What's New de más de 4000 caracteres. |
| Aspecto | Se puede pegar, pero una línea puede confundir a la gente o provocar una pregunta en la revisión, como un número de ticket, un nombre de archivo o el nombre de otra plataforma. |
| OK | Cabe y dice qué cambió. |
| Nota | Qué se conservó, qué se dejó fuera y adónde va cada copia. |
Fuentes: App Store Connect Help, Platform version information, App Review Guidelines (2.2, 2.3.10 y 2.3.12) y Sparkle, Publishing an update, todas leídas el 13 de noviembre de 2026.
Cómo funciona
Son unas pocas reglas de texto sencillas que se ejecutan en esta página. Ordena una línea por su primera palabra o su prefijo, así que “Add” y feat: van en Nuevo, “Fix” y fix: en Corregido, y lo que no sabe ubicar va en Mejorado. Un encabezado en tus notas, como “Fixed:”, ordena las líneas que tiene debajo. No reescribe tus frases y no puede saber si una línea es cierta o clara: esa parte sigue siendo tuya. Nada de lo que pegas se guarda ni se envía.
Preguntas
¿Qué longitud pueden tener las notas de versión del App Store?
What's New in This Version en App Store Connect admite hasta 4000 caracteres de texto sin formato. Es obligatorio en todas las versiones después de la primera.
¿Puedo escribir simplemente “correcciones de errores y mejoras de rendimiento”?
Para una corrección simple, una actualización de seguridad o de rendimiento, sí. La Guideline 2.3.12 de App Review dice que los cambios mayores y las funciones nuevas deben aparecer en las notas.
¿Cómo añado notas de versión a un appcast de Sparkle?
Pon HTML dentro del elemento description de la versión, envuelto en CDATA, o aloja una página y apunta sparkle:releaseNotesLink hacia ella. Sparkle 2.9 y posterior también puede leer Markdown con sparkle:format establecido en markdown.
¿Puedo pegar la salida de git log?
Sí. Se quitan los hashes de commit, los prefijos como feat: y fix: y los números de pull request, y se descartan las líneas de chore, ci, docs, test y merge.
¿Se envían mis notas a algún sitio?
No. Se ordenan en esta página y no se envía ni se guarda nada.