リリースノートフォーマッター
メモを貼り付けてください。1行に1つの変更です。このページ上でそのまま整えられ、どこにも送信されません。
例を試す:
機能
アップデートのたびに、何が変わったかを伝える数行が必要で、ほとんどのMacアプリでは、それを複数の場所に用意することになります。App Store ConnectのWhat's Newのテキスト、Sparkleがアップデートウィンドウに表示するリリースノート、そしてGitHubのリリースや変更履歴のページです。このツールは、大まかなメモ、リスト、git log --onelineが出力する行など、手元にあるものを受け取り、1行ずつ新機能、改善、修正に振り分けます。コミットのハッシュ、feat:やfix:のようなプレフィックス、プルリクエスト番号を取り除き、chore、ci、docs、test、mergeのコミットのように自分にしか関係のない行は除いて、貼り付けられるコピーを3つ作ります。そのうえで、App Reviewが読むような目線で結果をチェックします。
各コピーの貼り付け先
| コピー | 貼り付け先 |
|---|---|
| App Store | App Store ConnectのWhat's New in This Version。プレーンテキストで最大4,000文字。最初のバージョン以降は必須です。 |
| Sparkle | appcast内のリリースの説明の中に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)以降のコミットを1行ずつ並べます。2つ目はハッシュを省きます。どちらかをここに貼り付けたら、自分宛てのメモのように読める行を書き直してください。
各結果の意味
| 印 | 意味 |
|---|---|
| 修正 | 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の行は除外されます。
入力したメモはどこかに送信されますか?
いいえ。メモはこのページ上で整えられ、送信も保存もされません。