Formater notatek o wydaniu
Wklej notatki, jedna zmiana na wiersz. Są porządkowane tutaj, na tej stronie, i nic nie jest nigdzie wysyłane.
Wypróbuj przykład:
Co robi
Każda aktualizacja potrzebuje kilku wierszy mówiących, co się zmieniło, a większość aplikacji na Mac potrzebuje ich w więcej niż jednym miejscu: tekst What's New w App Store Connect, notatki o wydaniu, które Sparkle pokazuje w oknie aktualizacji, oraz wydanie na GitHub albo strona z historią zmian. To narzędzie przyjmuje to, co masz, czyli luźne notatki, listę albo wiersze, które wypisuje git log --oneline, i sortuje każdy wiersz do Nowe, Ulepszone lub Naprawione. Usuwa hashe commitów, prefiksy takie jak feat: i fix: oraz numery pull requestów, pomija wiersze ważne tylko dla ciebie, jak chore, ci, docs, test i commity merge, i pisze trzy kopie do wklejenia. Potem czyta wynik tak, jak mógłby go przeczytać App Review.
Gdzie trafia każda kopia
| Kopiuj | Gdzie trafia |
|---|---|
| App Store | What's New in This Version, w App Store Connect. Zwykły tekst, do 4000 znaków. Wymagane przy każdej wersji po pierwszej. |
| Sparkle | W opisie wydania w twoim appcaście, owiniętym w CDATA, albo na stronie, na którą wskazuje sparkle:releaseNotesLink. |
| Markdown | Wydanie na GitHub, CHANGELOG.md albo Sparkle 2.9 i nowszy na macOS 12 i nowszym, z sparkle:format="markdown". |
Polecenia do uruchomienia
git log --oneline v2.0..HEAD git log --pretty=format:"%s" v2.0..HEAD
Oba wypisują commity od ostatniego tagu wydania, tutaj v2.0, po jednym w wierszu. Drugi pomija hashe. Wklej któryś tutaj, a potem przepisz każdy wiersz, który nadal brzmi jak notatka do samego siebie.
Co oznacza każdy wynik
| Oznaczenie | Co to oznacza |
|---|---|
| Popraw | App Store Connect tego nie przyjmie, na przykład What's New powyżej 4000 znaków. |
| Wygląd | Da się wkleić, ale wiersz może zmylić ludzi albo wywołać pytanie w weryfikacji, jak numer zgłoszenia, nazwa pliku albo nazwa innej platformy. |
| OK | Mieści się i mówi, co się zmieniło. |
| Uwaga | Co zachowano, co pominięto i gdzie trafia każda kopia. |
Źródła: App Store Connect Help, Platform version information, App Review Guidelines (2.2, 2.3.10 i 2.3.12) oraz Sparkle, Publishing an update, wszystkie czytane 13 listopada 2026.
Jak to działa
To kilka prostych reguł tekstowych działających na tej stronie. Sortuje wiersz według pierwszego słowa albo prefiksu, więc „Add” i feat: trafiają do Nowe, „Fix” i fix: do Naprawione, a wszystko, czego nie umie przypisać, do Ulepszone. Nagłówek w twoich notatkach, jak „Fixed:”, sortuje wiersze pod nim. Nie przepisuje twoich zdań i nie umie ocenić, czy wiersz jest prawdziwy lub jasny: ta część nadal należy do ciebie. Nic, co wkleisz, nie jest zapisywane ani wysyłane.
Pytania
Jak długie mogą być notatki o wydaniu w App Store?
What's New in This Version w App Store Connect przyjmuje do 4000 znaków zwykłego tekstu. Jest wymagane przy każdej wersji po pierwszej.
Czy mogę po prostu napisać „poprawki błędów i usprawnienia wydajności”?
W przypadku prostej poprawki błędu, aktualizacji bezpieczeństwa lub wydajności tak. Wytyczna App Review 2.3.12 mówi, że większe zmiany i nowe funkcje trzeba wymienić w notatkach.
Jak dodać notatki o wydaniu do appcastu Sparkle?
Umieść HTML w elemencie description wydania, owinięty w CDATA, albo wystaw stronę i wskaż na nią sparkle:releaseNotesLink. Sparkle 2.9 i nowszy potrafi też czytać Markdown, gdy sparkle:format ma wartość markdown.
Czy mogę wkleić wynik git log?
Tak. Hashe commitów, prefiksy takie jak feat: i fix: oraz numery pull requestów są usuwane, a wiersze chore, ci, docs, test i merge są pomijane.
Czy moje notatki są gdzieś wysyłane?
Nie. Są porządkowane na tej stronie i nic nie jest wysyłane ani zapisywane.