Deliver (Fastlane) — nedir, App Store'a yükleme ve iOS ve Android geliştirmede yapılandırma

Deliver (Fastlane) nedir?

Deliver (Fastlane), Fastlane ekosisteminin bir bileşenidir ve mobil uygulamaları App Store'da yayınlama sürecini otomatikleştirir. İkili dosya yüklemelerini, meta veri güncellemelerini (ad, açıklama, anahtar kelimeler), ekran görüntüsü yüklemelerini ve tüm yerelleştirme dilleri için fiyatlandırma yapılandırmasını yönetir.

Deliver olmadan, her sürüm App Store Connect web arayüzü aracılığıyla manuel olarak bilgi güncellemesi gerektirir: birden çok dilde açıklama doldurma, her ekran boyutu için ekran görüntüsü yükleme, anahtar kelimeleri güncelleme ve fiyatlandırmayı yapılandırma. App Store'da yayınlama, iOS uygulama yaşam döngüsünün son aşamasıdır ve ikili dosya doğrulaması, içerik denetimi ve uygulamanın üretime sunulmasını içerir.

App Store Connect Belgelerine (2025) göre, düzenli güncellemeler alan uygulamalar %30 daha fazla yeniden kurulum alır ve arama sonuçlarında daha iyi sıralanır. Deliver, ekiplerin rutin yayınlama adımlarını otomatikleştirerek ve düzinelerce dilde meta veri doldururken insan hatası riskini azaltarak haftalık güncellemeler yayınlamasını sağlar.

App Store'da yayınlanan herhangi bir uygulama için Deliver'ı kullanın — özellikle 32 dilin manuel olarak güncellenmesinin saatler sürdüğü çok dilli yerelleştirme projeleri için değerlidir.

Deliver, App Store Connect ile nasıl çalışır

Deliver'ın çalışma mekanizması iki aşamalı bir sürece dayanır. İlk aşamada, araç meta verileri hazırlar — Deliverfile yapısını doğrular, ekran görüntülerini yükler ve bir değişiklik bildirgesi oluşturur. İkinci aşamada, Deliver App Store Connect API'sine veri gönderir, ikili dosyayı yükler ve Apple tarafında derleme doğrulama sürecini başlatır.

Deliver tüm işlemler için App Store Connect API'sini kullanır, bu da Apple'ın en son gereksinimleriyle uyumluluğu garanti eder ve özel arayüzlerin kullanımını ortadan kaldırır. App Store Connect API'si, derleme yüklemeleri, meta veri yönetimi ve inceleme durumu takibi dahil olmak üzere uygulama işlemlerini otomatikleştirmek için Apple'ın resmi REST API'sidir.

İkili dosya yükleme

Deliver, Fastlane aracılığıyla Gym ile doğrudan entegre olur: IPA derlemesinden sonra, Deliver bunu App Store Connect'e yükler ve işlemeyi başlatır. --ipa parametresi ikili dosyanın yolunu belirtir. Belirtilmezse, Deliver otomatik olarak Gymfile'da belirtilen veya önceki Fastlane adımları aracılığıyla iletilen derleme dizinindeki en son IPA'yı bulur.

Yüklemeden sonra Deliver, Apple'ın ikili dosya işlemesinin tamamlanmasını bekler — Pilot'a benzer şekilde, durum bir ilerleme çubuğu aracılığıyla takip edilir. Mevcut durumlar: Processing, Waiting For Review, In Review, Ready For Sale veya Rejected. Deliver, Fastfile'daki geri çağırmalar aracılığıyla ekibi her durum değişikliğinden haberdar eder.

Uygulama meta verileri yönetimi

Deliver, uygulama meta verilerinin tam setini yönetir: ad, açıklama (kısa ve tam), anahtar kelimeler, destek ve pazarlama URL'leri, kategori ve yaş derecelendirmesi. Uygulama meta verileri, App Store sayfasında görüntülenen ve arama indeksleme ve ASO optimizasyonu için kullanılan uygulama hakkındaki metinsel bilgilerdir.

--submit_for_review parametresi, meta veri yüklemesinden hemen sonra uygulamayı denetime gönderir. Bu, tamamen otomatikleştirilmiş sürümler için önemli bir parametredir. Bu parametre olmadan, Deliver yalnızca verileri yükler ancak uygulamayı incelemeye göndermez — fiili gönderimden önce tüm alanları önceden kontrol etmek için kullanışlıdır.

Ekran görüntüleriyle çalışma

Deliver, belirtilen dizinden tüm cihaz ve dil kombinasyonları için otomatik olarak ekran görüntüleri yükler. Dosya adları şu kalıbı izlemelidir: ilk yuvadaki 6,5 inç iPhone için iPhone_6.5_01.png. Deliver ekran görüntüsü boyutunu belirler ve her cihaz türü için Apple gereksinimleriyle eşleştirir.

Ekran görüntüleri doğru sırada ve her yerelleştirme dili için ayrı ayrı yüklenir. Bir dil için ekran görüntüsü bulunamazsa, Deliver yedek olarak İngilizce sürümleri kullanır. Ekran görüntüsü yerelleştirmesi, farklı ülkelerin App Store'unda iyi sıralama elde etmek isteyen uygulamalar için zorunlu bir gerekliliktir, çünkü Apple arama sonuçlarında yerel içeriği dikkate alır.

# App Store'a temel yükleme komutu
fastlane deliver

# Belirtilen meta veriler ve ekran görüntüleriyle yükleme
fastlane deliver --ipa "build/MyApp.ipa" \
      --force --submit_for_review

# Yükleme olmadan önizleme
fastlane deliver --preview

Deliverfile aracılığıyla Deliver yapılandırması

Deliverfile, uygulama meta verilerini yapılandırılmış Ruby biçiminde depolamak için bir Fastlane yapılandırma dosyasıdır. App Store Connect'te manuel olarak form doldurmanın aksine, Deliverfile meta verilerin Git'te sürümlenmesine ve yayınlamadan önce kod incelemesi yoluyla değişikliklerin doğrulanmasına olanak tanır.

# Deliverfile — uygulama meta verileri
app_identifier("com.company.app")
title("MyApp")
description("Mağaza için uygulama açıklaması")
keywords("mobil, uygulama, ios, swift")
support_url("https://company.com/support")
marketing_url("https://company.com")
privacy_url("https://company.com/privacy")

# Meta veri yerelleştirme dilleri
languages(["en-US", "ru", "de"])

languages parametresi, hangi diller için meta verilerin yükleneceğini belirler. fastlane/metadata klasöründe her dil için ilgili açıklama, anahtar kelime ve pazarlama metni dosyalarıyla ayrı bir dizin oluşturulmalıdır. Deliver aynı anda 32 App Store dilini destekler.

Ekran görüntüsü yüklemeleri için Fastlane klasörü içindeki screenshots dizini kullanılır. Klasör yapısı: screenshots/[Language]/[DeviceType]_[ScreenSize]_[Number].png. Deliver, belirtilen diller ve cihazlar için otomatik olarak ekran görüntüleri yükler ve boyutları Apple gereksinimleriyle eşleştirir. Ekran görüntüleri oluşturmak için Snapshot kullanılması önerilir — çıktı biçimleri Deliver ile uyumludur.

Fiyat grubu, 0 ile 87 arasında bir fiyat seviyesi numarası kabul eden price_tier parametresi aracılığıyla yapılandırılır. Apple'ın fiyat seviyeleri, uygulamanın bulunduğu tüm ülkelerin para birimlerine otomatik olarak dönüştürülür. Deliver, geçici promosyonlar veya uygulamanın iş modeli değişiklikleri için kullanışlı olan bir sürümün parçası olarak fiyatı değiştirmeye olanak tanır.

Uygulama yayınlamak için Deliver komutları

Deliver arayüzü, meta verileri, ikili dosyaları, ekran görüntülerini ve tam sürümleri yüklemek için komutlar içerir. Parametresiz ana fastlane deliver komutu, tam bir yayınlama döngüsü için Deliverfile ve meta veri dizinindeki verileri kullanır.

fastlane deliver --preview komutu, App Store Connect'e fiilen yükleme yapmadan ön meta veri doğrulaması çalıştırır. Yükleme için --force gereklidir — onsuz, Deliver önizleme modunda çalışır. --skip_binary parametresi, ikili dosya yüklemesini atlayarak yalnızca meta verileri ve ekran görüntülerini yükler — yeni bir sürüm olmadan ASO alanlarını hızlıca güncellemek için kullanışlıdır.

# İkili dosya yüklemesiyle tam sürüm
fastlane deliver --force --ipa "build/App.ipa"

# İkili dosya olmadan yalnızca meta verileri yükle
fastlane deliver --force --skip_binary

# Yalnızca ekran görüntülerini güncelle
fastlane deliver --force --skip_metadata

--skip_metadata parametresi, mevcut meta verileri değiştirmeden yalnızca ekran görüntülerini ve ikili dosyayı yükler. Bu, açıklama ve ASO alanlarını değiştirmeden hızlıca bir düzeltme yayınlamanız gereken hata düzeltme sürümleri için kullanışlıdır. Bayrakların kombinasyonu, her yayınlama aşamasının ayrı ayrı esnek bir şekilde yönetilmesine olanak tanır.

Deliver'ı sürüm hattına entegre etme

Sürüm hattı Deliver ile, taahhütten App Store yayınına kadar tüm aşamaları otomatikleştiren iOS için eksiksiz bir CI/CD sürecidir. Tipik bir hat şunları içerir: sertifikalar için Match, IPA derlemeleri için Gym, ekran görüntüleri için Snapshot ve tüm verileri App Store Connect'e yüklemek ve ardından denetime göndermek için Deliver.

Hattaki Deliver'ın önemli bir özelliği, meta verileri yapılandırılmış JSON biçiminde depolayan metadata.json desteğidir. Bu, harici CMS sistemlerinden programlı olarak meta veri oluşturmayı veya bir çeviri API'si aracılığıyla birden çok dilde otomatik olarak açıklamalar oluşturmayı sağlar.

# Fastfile'da sürüm hattı
lane :release do
    match(type: :appstore)
    capture_screenshots
    gym(scheme: "MyApp", export_method: "app-store")
    deliver(ipa: "build/MyApp.ipa", force: true, submit_for_review: true)
end

Hatta Deliver'ı çağırmadan önce, tüm meta verilerin güncel olduğundan emin olun: açıklama yeni sürümle eşleşiyor, ekran görüntüleri yeni özellikler için güncellenmiş ve fiyat grubunun değişmesi gerekmiyor. Submit for review, uygulamayı Apple denetimine gönderir; yeni uygulamalar için 24 ila 48 saat, güncellemeler için 2 ila 12 saat sürer.

Deliver, meta veri güncellemeleri için hedef sürümü belirlemeye olanak tanıyan app_version mekanizmasını destekler. Sürüm belirtilmezse, Deliver App Store Connect'teki uygulamanın mevcut aktif sürümünü günceller. Yeni bir sürüm yayınlamak için, App Store Connect arayüzü veya API'si aracılığıyla önce ilgili sürümü oluşturmak gerekir.

Deliver ile çalışırken yaygın hatalar

Deliver'ı kullanırken geliştiriciler sıklıkla meta veri doğrulama hataları, yanlış ekran görüntüsü dosya yapısı ve kimlik doğrulama sorunlarıyla karşılaşır. Hata teşhisi Deliver'da komut günlüklerinin analiziyle başlar — Deliver her yükleme aşaması ve reddetme nedenleri hakkında ayrıntılı bilgi çıktısı verir.

“Invalid screenshot path” hatası, ekran görüntüsü klasör yapısı beklenen biçimle eşleşmediğinde oluşur. Çözüm: ekran görüntüsü dosya adlarının DeviceType_ScreenSize_Number.png kalıbını izlediğini kontrol edin (örneğin AppleiPhone15ProMax_6.7_01.png). Deliver, dosya adlarında büyük/küçük harf duyarlılığına ve ayırıcılara duyarlıdır.

“Metadata validation failed” hatası, meta verilerin App Store gereksinimlerini karşılamadığını gösterir. Çözüm: açıklama uzunluğunu (4000 karaktere kadar), anahtar kelime uzunluğunu (100 karaktere kadar) ve ad uzunluğunu (30 karaktere kadar) kontrol edin. App Store İnceleme Yönergeleri, her meta veri alanı için tam gereksinimleri içerir — her sürümden önce bunları kontrol etmeniz önerilir.

“Apple ID not found” hatasında, belirtilen apple_identifier ile uygulama App Store Connect'te bulunmaz. Çözüm: ilk Deliver çağrısından önce web arayüzü aracılığıyla App Store Connect'te uygulama girişini oluşturun, Bundle Identifier'ı ve adı belirterek. Deliver yeni uygulamalar oluşturmaz — yalnızca mağazadaki mevcut girişleri günceller.