App Store sürüm notları örnekleri: kullanıcılara neyin değiştiğini anlatan What's New metni yazın (2026)

İyi App Store sürüm notları tek bir soruyu yanıtlar: güncelledikten sonra benim için ne farklı? Aşağıdaki App Store sürüm notu örneklerinin hepsi aynı kalıbı izler. Kullanıcının fark edeceği değişiklikle başlayın, her düzeltmeyi somut olarak adlandırın ve göremeyecekleri her şeyi dışarıda bırakın. Apple'ın What's New in This Version alanı için kendi rehberliği de aynı şeyi söyler. Yeni özellikleri, arayüz iyileştirmelerini veya hata düzeltmelerini ister ve kullanıcılara "sürümdeki değişikliklerin, iyileştirmelerin veya düzeltmelerin ayrıntılarını" anlatmayı önerir.

App Store Connect ve Google Play'de sürüm notu kuralları nelerdir?

Apple'ın What's New alanı 4.000 karaktere izin verir ve ilk sürümden sonraki her sürümde zorunludur. Google Play dil başına 500 Unicode karaktere izin verir ve tanıtım içeriğini yasaklar.

Ekim 2026 itibarıyla Play Console Yardım şöyle diyor: "Sürüm notlarını tanıtım amacıyla veya kullanıcıdan işlem talep etmek için kullanmayın." Apple'da ise pazarlama metnini bunun yerine Promotional Text alanına koyun. Bu alan 170 karaktere izin verir, açıklamanızın üstünde görünür ve Apple yeni sürüm göndermeden güncellemenize izin verir.

İyi App Store sürüm notları nasıl görünür?

İyi sürüm notları kullanıcının içinde bulunduğu durumu ve artık elde ettiği sonucu adlandırır. Aşağıdaki örnekler kurgusal bir alışkanlık takip uygulamasından alınmıştır. Belirsiz sürümler, son dakikada yazılan türden notlardır.

Bir düzeltme tek cümleyle açıklanamayacak kadar teknikse kullanıcılar muhtemelen fark etmeyecektir; bu yüzden sondaki tek bir "kararlılık iyileştirmeleri" satırının altına girebilir. Yönerge 2.3.12 buna küçük düzeltmeler için izin verir, gerçek özellik değişiklikleri için değil.

Yeniden kullanabileceğim bir sürüm notu şablonu var mı?

Evet. Yeniden kullanılabilir bir şablonda bir başlık, ardından New (Yeni), Improved (İyileştirildi) ve Fixed (Düzeltildi) bölümleri bulunur. Şablonu deponuzda değişiklik günlüğünün yanında tutun ve derleme yüklendikten sonra değil, sürüm dalını oluştururken doldurun.

[One-line headline: the change most users will notice]

New
- [Feature]: [what you can now do], [where to find it]

Improved
- [Screen or flow]: [what feels different]

Fixed
- [Symptom the user saw] when [situation]

Thanks for the reports. Reply via Settings > Help if anything looks off.

Google Play için aynı notları 500 karaktere sığacak şekilde başlık ve ilk iki üç madde işaretine indirin. Her dilin etiketlerini ayrı satırlara koyun, örneğin <en-US> ve </en-US>. Kapanış satırını Play'de çıkarın, çünkü kullanıcıdan bir şey yapmasını istiyor.

Birleştirilen pull request'leri sürüm notlarına nasıl dönüştürürsünüz?

Birleştirilen pull request'leri sürüm notlarına dönüştürmek için kullanıcıların göremediği değişiklikleri ayıklayın, ardından kalan her değişikliği bir belirti veya sonuç olarak yeniden yazın. Her sürümde şu adımları izleyin.

1. Son etiketten bu yana birleştirilen pull request başlıklarını dışa aktarın, ardından yeniden düzenlemeler, bağımlılık güncellemeleri ve CI değişiklikleri gibi kullanıcıların göremediği her şeyi silin.
2. Kalan her öğeyi bir belirti veya sonuç olarak yeniden yazın. "Fix nil coordinator", "Apple ile giriş yaptıktan sonra görünen boş ekran düzeltildi" olur.
3. Öğeleri ne kadar mühendislik emeği gerektirdiklerine göre değil, kaç kullanıcıyı etkilediklerine göre sıralayın.
4. App Store Connect'te yeni sürümü oluşturun, ardından önceki sürümün meta verileri aktarıldığı için yeni notları yapıştırmadan önce kopyalanan What's New metnini temizleyin.
5. Notları desteklediğiniz her yerelleştirmeye, çevrilmiş ya da en azından her dilde kontrol edilmiş olarak yapıştırın; böylece diğer yerel ayarlardaki kullanıcılar geçen sürümün notlarını görmez.
6. Play için kısaltılmış sürümü dil etiketlerinin içine yapıştırın ve her dilin 500 karakterin altında kaldığını doğrulayın.
7. Notları bir kez yüksek sesle okuyun. Bir cümleyi açıklamak için geliştirici gerekiyorsa onu yeniden yazın.

Acil düzeltme (hotfix) için sürüm notları ne demeli?

Acil düzeltme sürüm notları bozuk sürümü adlandırmalı, artık düzeltilen belirtiyi açıklamalı ve etkilenen kullanıcılara güncelledikten sonra ne olacağını söylemelidir. Apple, App Store'da önceki bir sürüme geri dönmenize izin vermez; bu yüzden bir düzeltme her zaman yeni bir sürüm olarak yayınlanır.

Bir örnek: "3.4.0 sürümünde bazı kullanıcılar için hatırlatıcıların çalışmayı durdurduğu sorun düzeltildi. Güncellemeden önce ayarladığınız hatırlatıcılar otomatik olarak yeniden çalışacak." Etkilenen kullanıcılar güncellemeleri gerektiğini anlar, etkilenmeyenler de düzeltmenin kendilerini ilgilendirmediğini görür. İşletim sistemini suçlamayın ve gelecekteki düzeltmeler için tarih vaat etmeyin. Güncellemeleri aşamalı yayınla gönderiyorsanız, düzeltme incelemedeyken dağıtımı duraklatmak bozuk derlemeyi alan kullanıcı sayısını sınırlar. Acil düzeltme bir özelliğin davranışını değiştiriyorsa notların, ekran görüntülerinin ve inceleme notlarının uyumlu olması için App Store gönderim kontrol listesini yeniden gözden geçirin.

App Review bir güncellemeyi sürüm notları yüzünden reddedebilir mi?

Evet. Sürüm notları meta veridir ve App Review Yönergeleri bunları doğrudan kapsar. Yönerge 2.3.12 şöyle der: "Uygulamalar yeni özellikleri ve ürün değişikliklerini "What's New" metninde açıkça tanımlamalıdır."

"Basit hata düzeltmeleri, güvenlik güncellemeleri ve performans iyileştirmeleri" için genel ifadelere izin verilir, ancak "daha önemli değişiklikler notlarda listelenmelidir." Yönerge 2.3.10, What's New dahil meta verilerde diğer mobil platformların adlarını veya görsellerini yasaklar. Bayrakların (feature flag) arkasına gizlenmiş özellikleri veya gönderilen derlemede olmayan herhangi bir şeyi anlatmayın. Yönerge 2.3.1(a) ayrıca yeni özelliklerin "Notes for Review bölümünde ayrıntılı olarak tanımlanmasını" ister; bu yüzden inceleyici adımlarını ve bir demo hesabı herkese açık notlara değil oraya koyun. Bir meta veri sorusu alırsanız, App Store ret düzeltmeleri rehberimiz nasıl yanıt vereceğinizi açıklıyor.

Diğer geliştiriciler hangi sürüm notu sorunlarıyla karşılaştı?

Herkese açık olarak bildirilen vakalar iki hata türü gösteriyor: mağazanın uzunluk sınırını aştığı için reddedilen yüklemeler ve temizleme talimatlarında What's New metnini de içeren inceleme retleri.

• CI'da Play uzunluk sınırı. Bir Flutter dağıtım şablonundaki GitHub issue'su, yapay zekâ ile oluşturulan bir değişiklik günlüğünün fastlane üzerinden yapılan bir Google Play dahili test yüklemesini şu hatayla bozduğunu bildiriyor: "The release created has notes in language ko-KR with length 612, which is too long (max: 500)." Bakımcılar, notları yüklemeden önce kısaltan bir betik ekledi: Play için 480 karakter, sınırını bayt cinsinden ölçen TestFlight için 3.800 bayt.
• What's New'u da kapsayan 2.3.10 temizliği. Apple Developer Forums'taki bir geliştirici, ekran görüntülerindeki iOS dışı durum çubuklarının tetiklediği bir Yönerge 2.3.10 reddini paylaştı. Apple'ın sonraki adımları, "bu bilginin tüm örneklerini uygulamanızdan ve meta verilerinizden, uygulama açıklaması, tanıtım metni, What's New bilgisi, önizlemeler ve ekran görüntüleri dahil olmak üzere kaldırmayı" söylüyordu. Yanıtlar, ekran görüntülerini yeniden çekmeyi ve sürüm notları dahil her meta veri alanını kontrol etmeyi önerdi.

Çıkarılacak ders: uzunluk sınırı mekaniktir ve yüklemede açıkça başarısız olur; inceleme kuralları ise içerikle ilgilidir ve her meta veri alanına uygulanır. Karakter kontrolünü otomatikleştirin ve What's New metnini ekran görüntülerinize gösterdiğiniz özenle okuyun.

Sürüm notlarını göndermeden önce neleri kontrol etmelisiniz?

Göndermeden önce notların yalnızca derlemede olanı anlattığını, her mağazanın sınırlarına sığdığını ve her dilde geçen sürümün metninin yerini aldığını kontrol edin.

• Başlık, kullanıcıların çoğunun fark edeceği değişikliği adlandırıyor.
• Yönerge 2.3.12'nin gerektirdiği gibi her önemli özellik veya ürün değişikliği listelenmiş.
• Her düzeltme dahili kodu değil, kullanıcının gördüğü bir belirtiyi anlatıyor.
• Bayrak arkasındaki özellikler, gelecek vaatleri, dahili bilet numaraları ve diğer platform adları yok.
• Önceki sürümün What's New metni her yerelleştirmede temizlenmiş ve yenisiyle değiştirilmiş.
• Play notları dil başına 500 karakterin altında, doğru dil etiketleriyle sarılmış ve tanıtım ya da harekete geçirici çağrı içermiyor.
• Pazarlama mesajları Apple'da Promotional Text alanına taşınmış.
• Android test kullanıcılarıyla da çalışıyorsanız, aynı notlar kapalı test planınıza göre kontrol edilmiş.

Göndermeden önce güncelleme meta verilerinize ikinci bir göz atılmasını isterseniz, taslak notlarınızı ve derlemedeki değişikliklerin listesini yagyeshsrbobde@gmail.com adresine e-postayla gönderin veya hizmetlerimize göz atın.