Formateur de notes de version
Collez vos notes, un changement par ligne. Elles sont mises en forme ici même, dans cette page, et rien n'est envoyé nulle part.
Essayez un exemple :
Ce qu'il fait
Chaque mise à jour a besoin de quelques lignes disant ce qui a changé, et la plupart des apps Mac en ont besoin à plusieurs endroits : le texte What's New dans App Store Connect, les notes de version que Sparkle affiche dans sa fenêtre de mise à jour, et une release GitHub ou une page de changelog. Cet outil prend ce que vous avez, comme des notes brutes, une liste ou les lignes qu'affiche git log --oneline, et range chaque ligne en Nouveau, Amélioré ou Corrigé. Il retire les hashes de commit, les préfixes comme feat: et fix: et les numéros de pull request, écarte les lignes qui n'intéressent que vous, comme chore, ci, docs, test et les commits de merge, et écrit trois copies à coller. Ensuite il relit le résultat comme pourrait le faire App Review.
Où va chaque copie
| Copier | Où cela va |
|---|---|
| App Store | What's New in This Version, dans App Store Connect. Texte brut, jusqu'à 4 000 caractères. Obligatoire pour toute version après la première. |
| Sparkle | Dans la description de la version de votre appcast, entourée de CDATA, ou sur une page vers laquelle pointe sparkle:releaseNotesLink. |
| Markdown | Une release GitHub, un CHANGELOG.md, ou Sparkle 2.9 et suivants sur macOS 12 et suivants, avec sparkle:format="markdown". |
Commandes à lancer
git log --oneline v2.0..HEAD git log --pretty=format:"%s" v2.0..HEAD
Les deux listent les commits depuis votre dernière étiquette de version, ici v2.0, un par ligne. Le second omet les hashes. Collez l'un ou l'autre ici, puis réécrivez les lignes qui ressemblent encore à une note pour vous-même.
Ce que signifie chaque résultat
| Repère | Ce que cela signifie |
|---|---|
| Corriger | App Store Connect ne l'accepte pas, par exemple un What's New de plus de 4 000 caractères. |
| Aspect | Cela se collera, mais une ligne peut dérouter les gens ou provoquer une question en revue, comme un numéro de ticket, un nom de fichier ou le nom d'une autre plateforme. |
| OK | Cela tient et dit ce qui a changé. |
| Remarque | Ce qui a été gardé, ce qui a été écarté, et où va chaque copie. |
Sources : App Store Connect Help, Platform version information, App Review Guidelines (2.2, 2.3.10 et 2.3.12) et Sparkle, Publishing an update, toutes lues le 13 novembre 2026.
Comment ça marche
Ce sont quelques règles de texte simples qui tournent dans cette page. Il range une ligne selon son premier mot ou son préfixe : « Add » et feat: vont dans Nouveau, « Fix » et fix: dans Corrigé, et tout ce qu'il ne sait pas placer va dans Amélioré. Un titre dans vos notes, comme « Fixed: », range les lignes qui le suivent. Il ne réécrit pas vos phrases et ne peut pas savoir si une ligne est vraie ou claire : cette partie reste la vôtre. Rien de ce que vous collez n'est enregistré ni envoyé.
Questions
Quelle longueur peuvent avoir les notes de version de l'App Store ?
What's New in This Version dans App Store Connect accepte jusqu'à 4 000 caractères de texte brut. Il est obligatoire pour toute version après la première.
Puis-je simplement écrire « corrections de bugs et améliorations de performance » ?
Pour une simple correction, une mise à jour de sécurité ou de performance, oui. La Guideline 2.3.12 d'App Review dit que les changements plus importants et les nouvelles fonctions doivent figurer dans les notes.
Comment ajouter des notes de version à un appcast Sparkle ?
Mettez du HTML dans l'élément description de la version, entouré de CDATA, ou hébergez une page et faites-y pointer sparkle:releaseNotesLink. Sparkle 2.9 et suivants peut aussi lire du Markdown avec sparkle:format défini sur markdown.
Puis-je coller la sortie de git log ?
Oui. Les hashes de commit, les préfixes comme feat: et fix: et les numéros de pull request sont retirés, et les lignes chore, ci, docs, test et merge sont écartées.
Mes notes sont-elles envoyées quelque part ?
Non. Elles sont mises en forme dans cette page et rien n'est envoyé ni enregistré.