Sürüm notları biçimlendirici
Notlarınızı yapıştırın, satır başına bir değişiklik. Tam burada, bu sayfada düzenlenirler ve hiçbir yere gönderilmez.
Bir örnek deneyin:
Ne yapar
Her güncelleme neyin değiştiğini söyleyen birkaç satır ister ve çoğu Mac uygulaması bunlara birden fazla yerde ihtiyaç duyar: App Store Connect'teki What's New metni, Sparkle'ın güncelleme penceresinde gösterdiği sürüm notları ve bir GitHub sürümü ya da değişiklik günlüğü sayfası. Bu araç elinizde ne varsa alır, örneğin kaba notlar, bir liste ya da git log --oneline çıktısındaki satırlar, ve her satırı Yeni, İyileştirildi ya da Düzeltildi altına koyar. Commit hash'lerini, feat: ve fix: gibi önekleri ve pull request numaralarını siler, yalnızca sizi ilgilendiren satırları, chore, ci, docs, test ve merge commit'leri gibi, dışarıda bırakır ve yapıştırabileceğiniz üç kopya yazar. Sonra sonucu App Review'un okuyabileceği gibi okur.
Her kopya nereye gider
| Kopyala | Nereye gider |
|---|---|
| App Store | What's New in This Version, App Store Connect'te. Düz metin, 4.000 karaktere kadar. İlk sürümden sonra her sürüm için zorunlu. |
| Sparkle | Appcast'inizdeki sürümün description alanının içine, CDATA ile sarılmış olarak ya da sparkle:releaseNotesLink ile işaret edilen bir sayfada. |
| Markdown | Bir GitHub sürümü, bir CHANGELOG.md ya da macOS 12 ve sonrasında Sparkle 2.9 ve sonrası, sparkle:format="markdown" ile. |
Çalıştırılacak komutlar
git log --oneline v2.0..HEAD git log --pretty=format:"%s" v2.0..HEAD
İkisi de son sürüm etiketinizden bu yana yapılan commit'leri, burada v2.0, satır başına bir tane listeler. İkincisi hash'leri atlar. Hangisini isterseniz buraya yapıştırın, sonra hâlâ kendinize not gibi okunan satırları yeniden yazın.
Her sonucun anlamı
| İşaret | Ne anlama gelir |
|---|---|
| Düzelt | App Store Connect kabul etmez, örneğin 4.000 karakteri aşan What's New. |
| Görünüm | Yapışır, ama bir satır insanları şaşırtabilir ya da incelemede soru getirebilir, örneğin bir talep numarası, bir dosya adı ya da başka bir platformun adı. |
| Tamam | Sığar ve neyin değiştiğini söyler. |
| Not | Nelerin tutulduğu, nelerin dışarıda bırakıldığı ve her kopyanın nereye gittiği. |
Kaynaklar: App Store Connect Help, Platform version information, App Review Guidelines (2.2, 2.3.10 ve 2.3.12) ve Sparkle, Publishing an update, hepsi 13 Kasım 2026 tarihinde okundu.
Nasıl çalışır
Bu sayfada çalışan birkaç düz metin kuralıdır. Bir satırı ilk kelimesine ya da önekine göre ayırır, yani “Add” ve feat: Yeni altına, “Fix” ve fix: Düzeltildi altına, yerleştiremediği her şey İyileştirildi altına gider. Notlarınızdaki “Fixed:” gibi bir başlık, altındaki satırları ayırır. Cümlelerinizi yeniden yazmaz ve bir satırın doğru ya da açık olup olmadığını söyleyemez: o kısım hâlâ sizin. Yapıştırdığınız hiçbir şey kaydedilmez ya da gönderilmez.
Sorular
App Store sürüm notları ne kadar uzun olabilir?
App Store Connect'teki What's New in This Version, 4.000 karaktere kadar düz metin alır. İlk sürümden sonraki her sürüm için zorunludur.
Sadece “hata düzeltmeleri ve performans iyileştirmeleri” yazabilir miyim?
Basit bir hata düzeltmesi, güvenlik ya da performans güncellemesi için evet. App Review Yönerge 2.3.12, daha büyük değişikliklerin ve yeni özelliklerin notlarda listelenmesi gerektiğini söylüyor.
Bir Sparkle appcast'ine sürüm notları nasıl eklerim?
HTML'i sürümün description öğesinin içine CDATA ile sarılmış olarak koyun ya da bir sayfa barındırıp sparkle:releaseNotesLink ile ona işaret edin. Sparkle 2.9 ve sonrası, sparkle:format markdown olarak ayarlandığında Markdown'ı da okuyabilir.
git log çıktısını yapıştırabilir miyim?
Evet. Commit hash'leri, feat: ve fix: gibi önekler ve pull request numaraları kaldırılır; chore, ci, docs, test ve merge satırları dışarıda bırakılır.
Notlarım bir yere gönderiliyor mu?
Hayır. Bu sayfada düzenlenir ve hiçbir şey gönderilmez ya da saklanmaz.