Форматувальник нотаток про реліз
Вставте нотатки, по одній зміні на рядок. Їх упорядковують просто на цій сторінці, і нічого нікуди не надсилається.
Спробуйте приклад:
Що робить
Кожне оновлення потребує кількох рядків про те, що змінилося, і більшості Mac-застосунків вони потрібні не в одному місці: текст What's New в App Store Connect, нотатки про реліз, які Sparkle показує у вікні оновлення, і реліз на GitHub або сторінка зі змінами. Цей інструмент бере все, що у вас є, наприклад чорнові нотатки, список або рядки, які друкує git log --oneline, і розкладає кожен рядок на «Нове», «Покращено» або «Виправлено». Він прибирає хеші комітів, префікси на кшталт feat: і fix: та номери pull request, пропускає рядки, важливі лише вам, як-от chore, ci, docs, test і merge-коміти, і пише три копії, які можна вставити. Потім він читає результат так, як міг би прочитати App Review.
Куди йде кожна копія
| Копіювати | Куди йде |
|---|---|
| App Store | What's New in This Version, в App Store Connect. Простий текст, до 4 000 символів. Обов'язково для кожної версії після першої. |
| Sparkle | Усередині description релізу у вашому appcast, обгорнутого в CDATA, або на сторінці, на яку вказує sparkle:releaseNotesLink. |
| Markdown | GitHub release, CHANGELOG.md або Sparkle від версії 2.9 на macOS від версії 12, з sparkle:format="markdown". |
Команди для запуску
git log --oneline v2.0..HEAD git log --pretty=format:"%s" v2.0..HEAD
Обидві команди показують коміти з вашого останнього тега релізу, тут v2.0, по одному на рядок. Друга без хешів. Вставте будь-який варіант сюди, а потім перепишіть рядки, які все ще звучать як нотатка самому собі.
Що означає кожен результат
| Позначка | Що це означає |
|---|---|
| Виправити | App Store Connect такого не прийме, наприклад What's New понад ліміт (4 000 симв.). |
| Вигляд | Вставиться, але рядок може заплутати людей або викликати запитання на перевірці, як-от номер тікета, ім'я файлу чи назва іншої платформи. |
| OK | Вміщується і каже, що змінилося. |
| Примітка | Що залишено, що прибрано і куди йде кожна копія. |
Джерела: App Store Connect Help, Platform version information, App Review Guidelines (2.2, 2.3.10 і 2.3.12) та Sparkle, Publishing an update, усе прочитано 13 листопада 2026 р.
Як це працює
Усередині кілька простих текстових правил, які працюють на цій сторінці. Інструмент сортує рядок за першим словом або префіксом, тож «Add» і feat: потрапляють у «Нове», «Fix» і fix: у «Виправлено», а все, що він не може визначити, у «Покращено». Заголовок у ваших нотатках, наприклад «Fixed:», сортує рядки під ним. Він не переписує ваші речення і не може знати, чи рядок правдивий і зрозумілий: це й далі ваша частина. Нічого зі вставленого не зберігається і не надсилається.
Запитання
Якої довжини можуть бути нотатки про реліз в App Store?
What's New in This Version в App Store Connect приймає до 4 000 символів простого тексту. Поле обов'язкове для кожної версії після першої.
Чи можна просто написати «bug fixes and performance improvements»?
Для простого виправлення помилки, оновлення безпеки або продуктивності так. App Review Guideline 2.3.12 каже, що більші зміни та нові функції треба перелічити в нотатках.
Як додати нотатки про реліз до Sparkle appcast?
Помістіть HTML в елемент description релізу, обгорнутий у CDATA, або розмістіть сторінку й вкажіть на неї через sparkle:releaseNotesLink. Sparkle від версії 2.9 також уміє читати Markdown, якщо sparkle:format встановлено в markdown.
Чи можна вставити вивід git log?
Так. Хеші комітів, префікси на кшталт feat: і fix: та номери pull request видаляються, а рядки chore, ci, docs, test і merge пропускаються.
Чи надсилаються мої нотатки кудись?
Ні. Їх упорядковують на цій сторінці, нічого не надсилається і не зберігається.