Formattatore di note di rilascio
Incolla le tue note, una modifica per riga. Vengono sistemate proprio qui, in questa pagina, e nulla viene inviato da nessuna parte.
Prova un esempio:
Che cosa fa
Ogni aggiornamento ha bisogno di qualche riga che dica cosa è cambiato, e la maggior parte delle app per Mac le richiede in più di un posto: il testo What's New in App Store Connect, le note di rilascio che Sparkle mostra nella finestra di aggiornamento, e una release su GitHub o una pagina di changelog. Questo strumento prende quello che hai, come note grezze, un elenco o le righe stampate da git log --oneline, e mette ogni riga in Novità, Miglioramenti o Correzioni. Toglie gli hash dei commit, i prefissi come feat: e fix: e i numeri delle pull request, scarta le righe che interessano solo a te, come i commit chore, ci, docs, test e merge, e scrive tre copie da incollare. Poi legge il risultato come potrebbe farlo App Review.
Dove va ogni copia
| Copia | Dove va |
|---|---|
| App Store | What's New in This Version, in App Store Connect. Testo semplice, fino a 4000 caratteri. Obbligatorio per ogni versione dopo la prima. |
| Sparkle | Dentro la description della release nel tuo appcast, racchiusa in CDATA, oppure in una pagina a cui punta sparkle:releaseNotesLink. |
| Markdown | Una release su GitHub, un CHANGELOG.md o Sparkle 2.9 e successivi su macOS 12 e successivi, con sparkle:format="markdown". |
Comandi da eseguire
git log --oneline v2.0..HEAD git log --pretty=format:"%s" v2.0..HEAD
Entrambi elencano i commit dall'ultimo tag di rilascio, qui v2.0, uno per riga. Il secondo omette gli hash. Incolla l'uno o l'altro qui, poi riscrivi ogni riga che suona ancora come un appunto per te stesso.
Cosa significa ogni risultato
| Voto | Che cosa significa |
|---|---|
| Correggi | App Store Connect non lo accetta, per esempio What's New oltre 4000 caratteri. |
| Aspetto | Si incolla, ma una riga può confondere le persone o attirare una domanda in revisione, come un numero di ticket, un nome di file o il nome di un'altra piattaforma. |
| OK | Ci sta e dice cosa è cambiato. |
| Nota | Cosa è stato tenuto, cosa è stato escluso e dove va ogni copia. |
Fonti: App Store Connect Help, Platform version information, App Review Guidelines (2.2, 2.3.10 e 2.3.12) e Sparkle, Publishing an update, tutte lette il 13 novembre 2026.
Come funziona
Sono poche semplici regole di testo che girano su questa pagina. Mette una riga in una sezione in base alla prima parola o al prefisso, quindi "Add" e feat: vanno sotto Novità, "Fix" e fix: sotto Correzioni, e tutto ciò che non sa collocare sotto Miglioramenti. Un titolo nelle tue note, come "Fixed:", ordina le righe che lo seguono. Non riscrive le tue frasi e non può dire se una riga è vera o chiara: quella parte resta tua. Nulla di ciò che incolli viene salvato o inviato.
Domande
Quanto possono essere lunghe le note di rilascio dell'App Store?
What's New in This Version in App Store Connect accetta fino a 4000 caratteri di testo semplice. È obbligatorio per ogni versione dopo la prima.
Posso scrivere semplicemente “correzioni di bug e miglioramenti delle prestazioni”?
Per una semplice correzione di bug, un aggiornamento di sicurezza o di prestazioni, sì. La Guideline 2.3.12 di App Review dice che le modifiche più grandi e le nuove funzioni vanno elencate nelle note.
Come aggiungo le note di rilascio a un appcast Sparkle?
Metti l'HTML dentro l'elemento description della release, racchiuso in CDATA, oppure ospita una pagina e punta sparkle:releaseNotesLink a essa. Sparkle 2.9 e successivi possono leggere anche Markdown con sparkle:format impostato su markdown.
Posso incollare l'output di git log?
Sì. Gli hash dei commit, i prefissi come feat: e fix: e i numeri delle pull request vengono rimossi, e le righe chore, ci, docs, test e merge vengono escluse.
Le mie note vengono inviate da qualche parte?
No. Vengono sistemate in questa pagina e nulla viene inviato o salvato.