릴리스 노트 포매터
메모를 붙여 넣으세요. 한 줄에 변경 하나씩이에요. 바로 이 페이지에서 정리되고, 어디로도 전송되지 않아요.
예시로 해 보기:
하는 일
업데이트할 때마다 무엇이 바뀌었는지 알리는 몇 줄이 필요하고, 대부분의 Mac 앱은 그걸 여러 곳에 써야 해요. App Store Connect의 What's New 문구, Sparkle이 업데이트 창에 보여 주는 릴리스 노트, 그리고 GitHub 릴리스나 변경 내역 페이지예요. 이 도구는 대충 쓴 메모, 목록, git log --oneline이 출력하는 줄 등 가진 것을 무엇이든 받아서 각 줄을 새 기능, 개선, 수정으로 나눠요. 커밋 해시, feat:와 fix: 같은 접두사, 풀 리퀘스트 번호를 없애고, chore, ci, docs, test, merge 커밋처럼 나한테만 의미 있는 줄은 빼고, 붙여 넣을 수 있는 사본 세 개를 만들어요. 그런 다음 App Review가 읽을 법한 눈으로 결과를 살펴봐요.
각 사본이 들어갈 곳
| 복사 | 들어갈 곳 |
|---|---|
| App Store | App Store Connect의 What's New in This Version. 일반 텍스트, 최대 4,000자. 첫 버전 이후 모든 버전에서 필수예요. |
| Sparkle | appcast에 있는 해당 릴리스의 description 안에 CDATA로 감싸서 넣거나, sparkle:releaseNotesLink가 가리키는 페이지에 두세요. |
| Markdown | GitHub 릴리스, CHANGELOG.md, 또는 sparkle:format="markdown"을 쓰는 Sparkle 2.9 이상(macOS 12 이상). |
실행할 명령
git log --oneline v2.0..HEAD git log --pretty=format:"%s" v2.0..HEAD
둘 다 마지막 릴리스 태그(여기서는 v2.0) 이후의 커밋을 한 줄씩 보여 줘요. 두 번째는 해시를 뺀 거예요. 둘 중 하나를 여기에 붙여 넣고, 여전히 자기한테 쓴 메모처럼 읽히는 줄은 다시 쓰세요.
결과별 의미
| 표시 | 의미 |
|---|---|
| 수정 | App Store Connect가 받아 주지 않는 경우예요. 예를 들어 4,000자를 넘는 What's New가 있어요. |
| 모양 | 붙여 넣을 수는 있지만, 티켓 번호, 파일 이름, 다른 플랫폼 이름처럼 사람들을 헷갈리게 하거나 심사에서 질문을 받을 수 있는 줄이 있어요. |
| OK | 길이에 맞고, 무엇이 바뀌었는지 말해 줘요. |
| 참고 | 남긴 줄, 뺀 줄, 그리고 각 사본이 들어갈 곳. |
출처: App Store Connect Help, Platform version information, App Review Guidelines(2.2, 2.3.10, 2.3.12), Sparkle, Publishing an update. 모두 2026년 11월 13일에 확인했어요.
작동 방식
이 페이지에서 돌아가는 몇 가지 단순한 텍스트 규칙이에요. 줄의 첫 단어나 접두사를 보고 나눠요. 그래서 "Add"와 feat:는 새 기능에, "Fix"와 fix:는 수정에 들어가고, 어디에도 맞지 않으면 개선에 들어가요. 메모 안의 "Fixed:" 같은 제목은 그 아래 줄들을 나눠 줘요. 문장을 고쳐 쓰지 않고, 줄의 내용이 사실인지 명확한지는 판단할 수 없어요. 그건 여전히 내 몫이에요. 붙여 넣은 내용은 저장되거나 전송되지 않아요.
질문
App Store 릴리스 노트는 얼마나 길게 쓸 수 있나요?
App Store Connect의 What's New in This Version에는 일반 텍스트로 최대 4,000자까지 쓸 수 있어요. 첫 버전 이후의 모든 버전에서 필수예요.
"버그 수정 및 성능 개선"이라고만 써도 되나요?
단순한 버그 수정, 보안, 성능 업데이트라면 괜찮아요. App Review Guideline 2.3.12는 더 큰 변경이나 새 기능은 노트에 적어야 한다고 해요.
Sparkle appcast에 릴리스 노트는 어떻게 추가하나요?
릴리스의 description 요소 안에 CDATA로 감싼 HTML을 넣거나, 페이지를 호스팅하고 sparkle:releaseNotesLink가 그 페이지를 가리키게 하세요. Sparkle 2.9 이상은 sparkle:format을 markdown으로 설정하면 Markdown도 읽을 수 있어요.
git log 출력을 붙여 넣어도 되나요?
네. 커밋 해시, feat:와 fix: 같은 접두사, 풀 리퀘스트 번호는 지워지고, chore, ci, docs, test, merge 줄은 빠져요.
내 메모가 어딘가로 전송되나요?
아니요. 이 페이지 안에서 정리되고, 전송되거나 저장되는 것은 없어요.