Išleidimo pastabų formatavimo įrankis
Įklijuok pastabas, po vieną pakeitimą eilutėje. Jos sutvarkomos čia pat, šiame puslapyje, ir niekur nesiunčiama.
Išbandyk pavyzdį:
Ką daro
Kiekvienam atnaujinimui reikia kelių eilučių, sakančių, kas pasikeitė, o daugumai Mac programų jų reikia keliose vietose: What's New tekstas App Store Connect, išleidimo pastabos, kurias Sparkle rodo atnaujinimo lange, ir GitHub leidimas ar pakeitimų puslapis. Šis įrankis priima tai, ką turi, pavyzdžiui, negrabias pastabas, sąrašą ar eilutes, kurias spausdina git log --oneline, ir kiekvieną eilutę priskiria prie Nauja, Patobulinta ar Ištaisyta. Jis nuima commit hash, tokius prefiksus kaip feat: ir fix: bei pull request numerius, išmeta eilutes, svarbias tik tau, pavyzdžiui, chore, ci, docs, test ir merge commit'us, ir parašo tris kopijas įklijuoti. Tada perskaito rezultatą taip, kaip galėtų perskaityti App Review.
Kur patenka kiekviena kopija
| Kopijuoti | Kur patenka |
|---|---|
| App Store | What's New in This Version, App Store Connect. Paprastas tekstas, iki 4 000 simbolių. Privaloma kiekvienai versijai po pirmosios. |
| Sparkle | Išleidimo aprašyme tavo appcast, apgaubtame CDATA, arba puslapyje, į kurį rodo sparkle:releaseNotesLink. |
| Markdown | GitHub leidimas, CHANGELOG.md arba Sparkle 2.9 ir naujesnė macOS 12 ir naujesnėje, su sparkle:format="markdown". |
Komandos paleisti
git log --oneline v2.0..HEAD git log --pretty=format:"%s" v2.0..HEAD
Abi išvardija commit'us nuo paskutinės tavo išleidimo žymos, čia v2.0, po vieną eilutėje. Antroji praleidžia hash. Įklijuok bet kurią čia, tada perrašyk kiekvieną eilutę, kuri vis dar skamba kaip pastaba sau.
Ką reiškia kiekvienas rezultatas
| Žyma | Ką tai reiškia |
|---|---|
| Pataisyti | App Store Connect jo nepriims, pavyzdžiui, What's New daugiau nei 4 000 simbolių. |
| Išvaizda | Įsiklijuos, bet eilutė gali sutrikdyti žmones ar sulaukti klausimo peržiūroje, pavyzdžiui, užduoties numeris, failo pavadinimas ar kitos platformos pavadinimas. |
| Gerai | Telpa ir sako, kas pasikeitė. |
| Pastaba | Kas paliktas, kas išmesta ir kur patenka kiekviena kopija. |
Šaltiniai: App Store Connect Help, Platform version information, App Review Guidelines (2.2, 2.3.10 ir 2.3.12) ir Sparkle, Publishing an update, visi skaityti 2026 m. lapkričio 13 d.
Kaip tai veikia
Tai kelios paprastos teksto taisyklės, veikiančios šiame puslapyje. Eilutę jis rūšiuoja pagal pirmą žodį ar prefiksą, todėl „Add“ ir feat: patenka į Nauja, „Fix“ ir fix: į Ištaisyta, o viskas, ko neįstengia priskirti, į Patobulinta. Tavo pastabų antraštė, pavyzdžiui, „Fixed:“, surūšiuoja po ja esančias eilutes. Jis neperrašo tavo sakinių ir negali pasakyti, ar eilutė teisinga ar aiški: ta dalis vis dar tavo. Nieko, ką įklijuoji, neišsaugoma ir nesiunčiama.
Klausimai
Kokio ilgio gali būti App Store išleidimo pastabos?
What's New in This Version App Store Connect priima iki 4 000 simbolių paprasto teksto. Jis privalomas kiekvienai versijai po pirmosios.
Ar galiu tiesiog parašyti „klaidų pataisos ir našumo patobulinimai“?
Paprastai klaidos pataisai, saugumo ar našumo atnaujinimui taip. App Review gairė 2.3.12 sako, kad didesni pakeitimai ir naujos funkcijos turi būti įrašytos pastabose.
Kaip pridėti išleidimo pastabas į Sparkle appcast?
Įdėk HTML į leidimo description elementą, apgaubtą CDATA, arba patalpink puslapį ir nukreipk į jį sparkle:releaseNotesLink. Sparkle 2.9 ir naujesnė taip pat gali skaityti Markdown, kai sparkle:format nustatytas į markdown.
Ar galiu įklijuoti git log išvestį?
Taip. Commit hash, prefiksai kaip feat: ir fix: bei pull request numeriai pašalinami, o chore, ci, docs, test ir merge eilutės išmetamos.
Ar mano pastabos kur nors siunčiamos?
Ne. Jos sutvarkomos šiame puslapyje ir nieko nesiunčiama ir nesaugoma.