Release-Notes-Formatierer
Füg deine Notizen ein, eine Änderung pro Zeile. Sie werden gleich hier auf dieser Seite aufbereitet, und nichts wird irgendwohin gesendet.
Probiere ein Beispiel:
Was es macht
Jedes Update braucht ein paar Zeilen, die sagen, was sich geändert hat, und die meisten Mac-Apps brauchen sie an mehr als einem Ort: den What's-New-Text in App Store Connect, die Release Notes, die Sparkle in seinem Update-Fenster zeigt, und ein GitHub-Release oder eine Changelog-Seite. Dieses Tool nimmt, was du hast, etwa grobe Notizen, eine Liste oder die Zeilen, die git log --oneline ausgibt, und sortiert jede Zeile in Neu, Verbessert oder Behoben. Es entfernt Commit-Hashes, Präfixe wie feat: und fix: und Pull-Request-Nummern, lässt Zeilen weg, die nur für dich zählen, wie chore, ci, docs, test und Merge-Commits, und schreibt drei Kopien zum Einfügen. Danach liest es das Ergebnis so, wie App Review es lesen könnte.
Wohin jede Kopie kommt
| Kopieren | Wohin es kommt |
|---|---|
| App Store | What's New in This Version, in App Store Connect. Klartext, bis zu 4.000 Zeichen. Pflicht für jede Version nach der ersten. |
| Sparkle | In die Beschreibung des Releases in deinem Appcast, in CDATA eingeschlossen, oder auf eine Seite, auf die sparkle:releaseNotesLink zeigt. |
| Markdown | Ein GitHub-Release, eine CHANGELOG.md oder Sparkle 2.9 und neuer auf macOS 12 und neuer, mit sparkle:format="markdown". |
Auszuführende Befehle
git log --oneline v2.0..HEAD git log --pretty=format:"%s" v2.0..HEAD
Beide listen die Commits seit deinem letzten Release-Tag auf, hier v2.0, einen pro Zeile. Der zweite lässt die Hashes weg. Füg einen von beiden hier ein und schreib dann Zeilen um, die noch wie eine Notiz an dich selbst klingen.
Was jedes Ergebnis bedeutet
| Markierung | Was es bedeutet |
|---|---|
| Beheben | App Store Connect nimmt es nicht an, etwa ein What's New mit mehr als 4.000 Zeichen. |
| Aussehen | Es lässt sich einfügen, aber eine Zeile kann Leute verwirren oder in der Prüfung eine Rückfrage auslösen, etwa eine Ticketnummer, ein Dateiname oder der Name einer anderen Plattform. |
| OK | Es passt und sagt, was sich geändert hat. |
| Hinweis | Was behalten wurde, was weggelassen wurde und wohin jede Kopie kommt. |
Quellen: App Store Connect Help, Platform version information, App Review Guidelines (2.2, 2.3.10 und 2.3.12) und Sparkle, Publishing an update, alle gelesen am 13. November 2026.
So funktioniert's
Es sind ein paar einfache Textregeln, die auf dieser Seite laufen. Eine Zeile wird nach ihrem ersten Wort oder ihrem Präfix einsortiert: „Add“ und feat: landen unter Neu, „Fix“ und fix: unter Behoben, und alles, was es nicht zuordnen kann, unter Verbessert. Eine Überschrift in deinen Notizen, etwa „Fixed:“, sortiert die Zeilen darunter ein. Es schreibt deine Sätze nicht um und kann nicht sagen, ob eine Zeile stimmt oder klar ist: Das bleibt deine Sache. Nichts, was du einfügst, wird gespeichert oder gesendet.
Fragen
Wie lang dürfen Release Notes im App Store sein?
What's New in This Version in App Store Connect nimmt bis zu 4.000 Zeichen Klartext. Es ist für jede Version nach der ersten Pflicht.
Kann ich einfach „Fehlerbehebungen und Performance-Verbesserungen“ schreiben?
Bei einer einfachen Fehlerbehebung, einem Sicherheits- oder Performance-Update: ja. App Review Guideline 2.3.12 sagt, dass größere Änderungen und neue Funktionen in den Notes stehen müssen.
Wie füge ich einem Sparkle-Appcast Release Notes hinzu?
Setz HTML in das description-Element des Releases, in CDATA eingeschlossen, oder hoste eine Seite und lass sparkle:releaseNotesLink darauf zeigen. Sparkle 2.9 und neuer kann auch Markdown lesen, wenn sparkle:format auf markdown gesetzt ist.
Kann ich git-log-Ausgabe einfügen?
Ja. Commit-Hashes, Präfixe wie feat: und fix: und Pull-Request-Nummern werden entfernt, und chore-, ci-, docs-, test- und Merge-Zeilen werden weggelassen.
Werden meine Notizen irgendwohin gesendet?
Nein. Sie werden auf dieser Seite aufbereitet, und nichts wird gesendet oder gespeichert.