Форматировщик заметок о релизе
Вставьте заметки, по одному изменению на строку. Они приводятся в порядок прямо на этой странице, и ничего никуда не отправляется.
Попробуйте пример:
Что делает
Каждое обновление требует нескольких строк о том, что изменилось, и большинству 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 пропускаются.
Отправляются ли мои заметки куда-нибудь?
Нет. Они приводятся в порядок на этой странице, ничего не отправляется и не хранится.