Önemli Çıkarımlar
CI/CD boru hatlarını dağıtım API'lerine bağlamak, uygulama güncellemeleri sırasında manuel veri girişini ortadan kaldırır. Fastlane Deliver ve Supply, yerelleştirilmiş meta verileri güvenli bir şekilde aktarmak için endüstri standartları olmaya devam etmektedir. Yapay zeka destekli yerelleştirme sistemleri, sürüm notlarını anında desteklenen 35'ten fazla dile çevirebilir. Git iş akışlarınıza doğrudan entegre edilmiş LLM'ler (Büyük Dil Modelleri), teknik commit mesajlarını otomatik olarak kullanıcıya dönük metinlere dönüştürür. App Store Connect yerelleştirmesini otomatikleştirmek, çoklu platform değişiklik günlüklerini güncellerken oluşabilecek insan kaynaklı biçimlendirme hatalarını önler.
Mobil bir güncelleme yayınlamak, tek tıklamayla halledilen basit bir süreç olmalıdır. Bunun yerine geliştiriciler, her bir bölge (locale) için çevrilmiş değişiklik günlüklerini hantal web konsollarına manuel olarak kopyalayıp yapıştırarak saatler harcarlar. Uygulama sürüm notları otomasyonunu uygulamak; derlenmiş ikili dosyalarla (binaries) birlikte sürüm meta verilerini yazan, çeviren ve dağıtan güvenilir bir sistem yaratır.
App Store sürüm notları nasıl otomatikleştirilir?
App Store sürüm notlarını, CI/CD boru hattınızı doğrudan Apple ve Google geliştirici API'lerine bağlayarak otomatikleştirebilirsiniz. Bu bağlı hat, derleme süreci sırasında metni deponuzdan çeker ve mağaza listelemesine aktarır.
Mağaza meta verilerinize tıpkı uygulama kodu gibi davranın. Sürüm notlarını Git'te depolayarak sürüm kontrolünü sağlar ve güncellemeleri belirli uygulama sürümlerine kadar takip edebilirsiniz. Bir sürümü etiketlemek (tagging), GitHub Actions gibi platformları bir dağıtım betiği çalıştırmak üzere tetikler.
Bu betik, platform sunucularında kimlik doğrulaması yapar ve uygulama paketini, bölgeye özgü metin dosyalarıyla (örn. en-US, tr-TR) birlikte yükler. Otomatikleştirilmiş betik bu dizinlerde gezinerek, metin verilerini uygulama mağazası veritabanındaki hedef dil alanlarıyla eşleştirir.
Apple'ın geliştirici yönergelerine göre, bölgeler arası doğru yerelleştirmeyi sürdürmek, küresel indirme hacmini artıran temel faktörlerden biridir. Programatik otomasyon, insan hatasını ortadan kaldırır ve küresel kitlelerin özellik güncellemelerini doğru bir şekilde almasını sağlar.
Fastlane ile iOS sürüm notları otomatikleştirilebilir mi?
Evet, düz metin dosyalarını doğrudan App Store Connect'e yüklemek için Fastlane Deliver kullanarak iOS sürüm notlarını otomatikleştirebilirsiniz. Deliver, Apple'ın meta veri alanlarıyla kusursuz şekilde eşleşen yerel bir ayna dizin yapısı oluşturur.
Fastlane, CI ortamınız ile Apple sunucuları arasında bir aracı görevi görür. fastlane init komutunu çalıştırmak, desteklenen her dil için alt klasörler içeren bir fastlane/metadata dizini oluşturur. Belirli bir bölge klasörü içinde basitçe bir release_notes.txt dosyası oluşturmanız yeterlidir.
fastlane deliver komutunu çalıştırmak, bir App Store Connect API Anahtarı aracılığıyla güvenli bir şekilde kimlik doğrulaması yapar, release_notes.txt dosyasını ayrıştırır ve "Bu Sürümdeki Yenilikler" (What's New in This Version) alanını günceller. Bir API anahtarı tanımlayarak, deliver eylemini ekleyerek ve anında inceleme gönderimi için isteğe bağlı olarak submit_for_review: true parametresini geçirerek, özel bir Fastlane lane yapılandırması üzerinden bu iş akışını tetikleyebilirsiniz.
Fastlane kullanmak, sıfırdan özel ağ betikleri yazmaya gerek kalmadan iOS uygulama sürüm notlarını otomatikleştirmek için en sağlam yöntem olmaya devam etmektedir. Bu metin dosyalarını dinamik olarak oluşturan iş akışlarına sorunsuz bir şekilde entegre olur.
Uygulama sürüm notları otomatik olarak nasıl çevrilir?
Metin oluşturma iş akışınızı bir yapay zeka çeviri API'sine bağlayarak veya doğrudan App Store Connect'te bir geliştirici uzantısı kullanarak uygulama sürüm notlarını otomatik olarak çevirebilirsiniz. Bu araçlar, temel dildeki güncellemeleri dünya çapındaki yerel bölgelere anında eşleştirir.
Uluslararasılaştırma (L10n), eskiden devasa CSV dosyalarını ve çeviri ajanslarını yönetmeyi gerektiriyordu. Günümüzde betikler, İngilizce sürüm notlarını OpenAI API veya Google Cloud Translation API'sine gönderebiliyor. Bu yerelleştirilmiş yanıtlar daha sonra Fastlane dizinlerine kaydedilir ve yüklenmeye hazır hale getirilir.
Özel API betikleri ince ayarlı prompt'lar (istemler) ve API anahtarlarının korunmasını gerektirdiğinden, tarayıcı araçları verimli bir alternatif sunar. StoreManager, tarayıcınızın içinde doğrudan Gemini AI kullanarak 35'ten fazla dilde App Store Connect yerelleştirmesini otomatikleştirir. Temel metni girersiniz ve uzantı, çevirileri yapılandırılmış tüm bölgelere anında dağıtır.
StoreManager ayrıca diğer konsol görevlerini de basitleştirir. Çok dilli metin oluşturmanın ötesinde, 175'ten fazla bölge için satın alma gücü paritesine (PPP) dayalı fiyatlandırma belirler. Pipeline (boru hattı) betikleri ile tarayıcı otomasyonu arasında seçim yapmak, tamamen özel kod bakımına yönelik teknik tercihinize bağlıdır.
Google Play Store sürüm notları nasıl otomatikleştirilir?
Fastlane Supply kullanarak veya doğrudan Google Play Developer API çağrıları ile Google Play Store sürüm notlarını otomatikleştirebilirsiniz. Google Play, otomasyon aracınızın harfiyen uyması gereken katı bir dosya yapısını zorunlu kılar.
Otomatik android sürüm notları oluşturmak için, metin dosyalarınızı derlemenin (build) sürüm koduna bağlı bir adlandırma kuralı kullanarak Fastlane içinde düzenleyin. Sürüm notlarınızı fastlane/metadata/android/en-US/changelogs/ dizinine yerleştirin.
Dosya adı, uygulama paketinin tam sayı sürüm koduyla eşleşmeli (örn. 10045.txt) veya aynı metni tüm yüklemelere uygulamak için default.txt kullanılmalıdır. Google, Android sürüm notları için 500 karakterlik katı bir sınır uygular. Dağıtım hatalarını önlemek için otomatik iş akışınız, Android metnini kırpacak veya özetleyecek doğrulama adımları içermelidir.
fastlane supply komutunu çalıştırmak, bir Google Cloud Hizmet Hesabı JSON anahtarı aracılığıyla bağlantı kurar. AAB dosyanızı yükler ve ardından yerelleştirilmiş metin dosyalarını sırayla Google Play Console'a göndererek güncellemeyi anında yayınlar.
Yapay zeka uygulama mağazası sürüm notları yazabilir mi?
Evet, yapay zeka, Git commit geçmişinizi alıp Büyük Dil Modellerinden (LLM) yararlanarak ham teknik değişiklikleri özetleyerek uygulama mağazası sürüm notları yazabilir. Yapay zeka prompt'unu (istemini) meta veri yükleme aşamasından önce doğrudan CI iş akışınıza entegre edebilirsiniz.
Geliştiriciler genellikle son derece teknik commit mesajları yazarlar. App Store listelemesini okuyan kullanıcılar ise kodun iç kısımlarındaki yeniden yapılandırmalarla (refactor) ilgilenmezler; onlar güvenlik ve hız iyileştirmelerini önemserler. Mevcut ve önceki sürüm etiketleriniz arasındaki tüm commit mesajlarını toplayacak (aggregate) bir GitHub Action yapılandırabilirsiniz.
Boru hattı betiğiniz bu toplanmış commit dizesini bir yapay zeka uç noktasına (endpoint) gönderir; burada bir istem, modele teknik jargonu kullanıcı faydalarına dönüştürme talimatı verir. Yapay zeka, betiğinizin otomatik olarak release_notes.txt dosyasına yazacağı profesyonelce düzenlenmiş, yapay zeka ile oluşturulmuş uygulama sürüm notları ile yanıt verir. Bu işlem, geliştiricilerin durup pazarlama metinleri yazmasına gerek kalmadan, eklenen gerçek özellikleri ön plana çıkarır.
Güncellemeler için App Store Connect API nasıl kullanılır?
whatsNew (Yenilikler) veri alanınızı güncellemek için appStoreVersionLocalizations uç noktasına (endpoint) kimliği doğrulanmış REST ağ çağrıları yaparak App Store Connect API'sini kullanabilirsiniz. Bu yaklaşım Fastlane gibi aracı araçları atlayarak altyapınız üzerinde tam kontrol sahibi olmanızı sağlar.
Apple'ın API'si katı bir kimlik doğrulama gerektirir; bu, App Store Connect hesabınızdan gizli bir anahtar (private key) kullanarak bir JSON Web Token (JWT) oluşturmanız gerektiği anlamına gelir. Dağıtım betiğiniz bu token'ı imzalar ve HTTP isteğinin Authorization (Yetkilendirme) başlığına ekler. Belirli bir dili güncellemek için, öncelikle bekleyen uygulama sürümünüze ait yerel bölgenin dâhili ID'sini bulmak üzere API'yi sorgulamalısınız.
Güncellenmiş whatsNew dizesini belirten bir JSON yükü (payload) ile https://api.appstoreconnect.apple.com/v1/appStoreVersionLocalizations/{id} adresine bir HTTP PATCH isteği gönderin. Doğrudan API kullanımı inanılmaz derecede hızlıdır ve app store connect güncellemelerini eşzamanlı olarak otomatikleştirmenize olanak tanır. Ancak, kendi hata tekrarlarınızı, istek sınırlarını (rate limits) ve JSON ayrıştırma (parsing) mantığınızı yönetmenizi gerektirir.
Sürüm notlarını yerelleştirmenin en iyi yolu nedir?
Sürüm notlarını yerelleştirmenin en iyi yolu sürüm temponuza bağlıdır: anlık güncellemeler için doğrudan tarayıcı otomasyon araçlarını kullanın veya planlanmış sürümler için tamamen betiklenmiş (scripted) bir CI/CD boru hattı oluşturun. Her ikisi de manuel veri girişini ortadan kaldırır.
Özel bir API entegrasyonu oluşturmak maksimum esneklik sunar ancak platformlar uç noktalarını güncellediğinde sürekli bakım gerektirir. Bir eklenti kullanmak ise iş akışını ciddi ölçüde basitleştirir.
| Yerelleştirme Yöntemi | Kurulum Süresi | Bakım Yükü | En İyi Kullanım Senaryosu |
|---|---|---|---|
| Manuel Giriş | Yok | Çok Yüksek | Sadece tek dilli uygulamalar |
| Fastlane CI/CD | Yüksek | Orta | Özel sunucuları olan kurumsal ekipler |
| Tarayıcı Otomasyonu | Düşük | Düşük | Bağımsız geliştiriciler ve hızlı yinelemeler |
Boru hattı bakımını tamamen atlamak için tarayıcı eklentileri anında değer sağlar. StoreManager'ı kullanarak doğrudan Apple konsol kontrol panelinizden uygulama sürüm notlarını otomatik olarak çevirebilirsiniz. Seçilen araç ne olursa olsun, uygulamanızın küresel ayak izini verimli bir şekilde büyütmek için manuel metin girişinden uzaklaşmak zorunludur.
Sıkça Sorulan Sorular
App Store sürüm notları için karakter sınırı nedir?
Apple, App Store Connect'teki "Bu Sürümdeki Yenilikler" bölümü için katı bir şekilde en fazla 4.000 karakter sınırı uygular. Google Play ise Android sürüm notları için çok daha katı olan 500 karakter sınırını zorunlu kılar. Yükleme hatalarını önlemek için otomasyon betiklerinizin bu sınırlara uyması gerekir.
Sürüm notlarını çevirmek ASO'yu iyileştirir mi?
Evet, yerelleştirilmiş sürüm notları Uygulama Mağazası Optimizasyonu'nu (ASO) önemli ölçüde iyileştirir. Sürüm notlarını kullanıcının anadilinde sunmak, listeleme sayfanızdaki hemen çıkma oranlarını düşürür, okunabilirliği artırır ve küresel dönüşüm oranlarını yükselterek dünya çapında daha fazla indirme elde edilmesini sağlar.
Sürüm notlarımda markdown veya HTML kullanabilir miyim?
Ne Apple ne de Google, sürüm notlarında ham HTML oluşturmayı tam olarak destekler. Apple yalnızca temel düz metni destekler ve markdown biçimlendirmesini yok sayar. Google ise satır sonları için gibi çok basit stil etiketlerine izin verir, ancak karmaşık HTML kodları ham metin olarak görüntülenir.
Uygulama sürüm notlarını ne sıklıkla güncellemeliyim?
Kullanıcıya dönük değişiklikler, hata düzeltmeleri veya performans iyileştirmeleri içeren her canlı ortam (production) dağıtımı için sürüm notlarınızı güncellemelisiniz. Otomasyondan yararlanan modern geliştirme döngülerinde bu, genellikle düzenli sprint sürümleriyle birlikte her 1 ila 2 haftada bir gerçekleşir.
Kaynaklar
- Apple Developer Documentation, REST uç noktaları aracılığıyla App Store sürüm yerelleştirmelerini değiştirmek için resmi API belgeleri.
- Google Play Developer API, Android uygulama paketlerini (AAB) ve meta verileri yüklemek için gereken Edits API'sini detaylandıran belgeler.
- Fastlane Deliver, Yerel metin dosyalarını iOS App Store Connect alanlarıyla eşleştirmek için kapsamlı kurulum talimatları.
- Fastlane Supply, Yerelleştirilmiş değişiklik günlüklerini Google Play Store'a göndermek için yapılandırma yönergeleri.
- GitHub Actions Documentation, Git depo etiketleri (tags) tarafından tetiklenen otomatik iş akışları oluşturmak için en iyi uygulamalar.
- OpenAI Developer Platform, Commit günlüklerini biçimlendirmek ve çevirmek için büyük dil modellerini (LLM) entegre etmeye yönelik API referansı.
