Formatador de notas de versão
Cole suas notas, uma mudança por linha. Elas são organizadas aqui mesmo, nesta página, e nada é enviado para lugar nenhum.
Teste um exemplo:
O que faz
Toda atualização precisa de algumas linhas dizendo o que mudou, e a maioria dos apps de Mac precisa delas em mais de um lugar: o texto de What's New no App Store Connect, as notas de versão que o Sparkle mostra na janela de atualização, e um release no GitHub ou uma página de changelog. Esta ferramenta pega o que você tiver, como notas soltas, uma lista ou as linhas que o git log --oneline imprime, e coloca cada linha em Novidades, Melhorias ou Correções. Ela remove hashes de commits, prefixos como feat: e fix: e números de pull requests, deixa de fora as linhas que só importam para você, como commits de chore, ci, docs, test e merge, e escreve três cópias para colar. Depois lê o resultado como o App Review poderia ler.
Para onde vai cada cópia
| Copiar | Para onde vai |
|---|---|
| App Store | What's New in This Version, no App Store Connect. Texto simples, até 4.000 caracteres. Obrigatório em toda versão depois da primeira. |
| Sparkle | Dentro da description da versão no seu appcast, envolvida em CDATA, ou em uma página para a qual sparkle:releaseNotesLink aponte. |
| Markdown | Um release no GitHub, um CHANGELOG.md ou o Sparkle 2.9 e posteriores no macOS 12 e posteriores, com sparkle:format="markdown". |
Comandos para rodar
git log --oneline v2.0..HEAD git log --pretty=format:"%s" v2.0..HEAD
Os dois listam os commits desde a sua última tag de versão, aqui v2.0, um por linha. O segundo omite os hashes. Cole qualquer um aqui e depois reescreva as linhas que ainda parecem um recado para você mesmo.
O que cada resultado significa
| Marca | O que significa |
|---|---|
| Corrigir | O App Store Connect não aceita, como um What's New com mais de 4.000 caracteres. |
| Aparência | Dá para colar, mas uma linha pode confundir as pessoas ou gerar uma pergunta na revisão, como um número de ticket, um nome de arquivo ou o nome de outra plataforma. |
| OK | Cabe e diz o que mudou. |
| Nota | O que foi mantido, o que ficou de fora e para onde vai cada cópia. |
Fontes: App Store Connect Help, Platform version information, App Review Guidelines (2.2, 2.3.10 e 2.3.12) e Sparkle, Publishing an update, todas lidas em 13 de novembro de 2026.
Como funciona
São algumas regras simples de texto rodando nesta página. Ela coloca uma linha em uma seção pela primeira palavra ou pelo prefixo, então "Add" e feat: vão para Novidades, "Fix" e fix: para Correções, e tudo que ela não consegue encaixar vai para Melhorias. Um título nas suas notas, como "Fixed:", organiza as linhas que vêm depois. Ela não reescreve as suas frases e não sabe dizer se uma linha é verdadeira ou clara: essa parte continua sendo sua. Nada do que você cola é salvo ou enviado.
Perguntas
Qual o tamanho máximo das notas de versão da App Store?
O What's New in This Version no App Store Connect aceita até 4.000 caracteres de texto simples. É obrigatório em toda versão depois da primeira.
Posso escrever só “correções de bugs e melhorias de desempenho”?
Para uma correção simples de bug, atualização de segurança ou de desempenho, sim. A Guideline 2.3.12 do App Review diz que mudanças maiores e novos recursos devem ser listados nas notas.
Como adiciono notas de versão a um appcast do Sparkle?
Coloque o HTML dentro do elemento description da versão, envolvido em CDATA, ou hospede uma página e aponte sparkle:releaseNotesLink para ela. O Sparkle 2.9 e posteriores também consegue ler Markdown com sparkle:format definido como markdown.
Posso colar a saída do git log?
Sim. Hashes de commits, prefixos como feat: e fix: e números de pull requests são removidos, e as linhas de chore, ci, docs, test e merge ficam de fora.
Minhas notas são enviadas para algum lugar?
Não. Elas são organizadas nesta página e nada é enviado ou guardado.