Ionic ve Capacitor uygulamaları için Google Play kapalı testi

Google Play yeni uygulamalarda Play Uygulama İmzalama ister. Android Studio sihirbazında (Create new) oluşturduğun ya da npx cap build'e verdiğin anahtar deposu senin yükleme anahtarındır; ayrı uygulama imzalama anahtarını ilk yüklemenden sonra Google saklar.

Android Studio yeni bir anahtar için en az 25 yıl geçerlilik önerir. Native projeyi yeniden oluşturma ihtimaline karşı .jks dosyasını android/ klasörünün dışında tut ve iki şifreyle birlikte yedekle. Yükleme anahtarı kaybolursa Play Console'dan sıfırlama isteyebilirsin.

Derleme seçeneklerini Capacitor yapılandırmasında tutuyorsan şifreleri depoya eklediğin dosyaya yazma. Yapılandırma deponun bir parçasıdır.

Capacitor sürümü package.json'dan okumaz. Google Play'in gördüğü değerler android/app/build.gradle içindedir; her yüklemeden önce versionCode'u artır:

android {
    defaultConfig {
        versionCode 2
        versionName "1.0.1"
    }
}

31 Ağustos 2026'dan beri yeni uygulamalar ve güncellemeler Android 16'yı (API düzeyi 36) hedeflemek zorunda. Capacitor targetSdkVersion değerini android/variables.gradle içinde belirler ve her ana sürüm tam olarak tek bir değeri destekler: Capacitor 8 36'yı, Capacitor 7 35'i kullanır. Özel değerler desteklenmez; API 36'ya giden yol sayıyı elle değiştirmek değil, eklentilerinle birlikte Capacitor 8'e geçmektir.

ext {
    // ...
    targetSdkVersion = 36
}

• Açık kalan canlı yeniden yükleme. Capacitor yapılandırmasındaki bir server.url, uygulamanın geliştirme makinenin adresini yüklemesine yol açar. Test ediciler boş ekran görür. Sürüm derlemesinden önce kaldır.
• Bayat web varlıkları. Önce npx cap sync android çalıştırmadan Android Studio'da paket oluşturmak önceki web derlemesini yayınlar.
• Başka ana sürümdeki eklentiler. Tüm @capacitor/* paketleri ve topluluk eklentileri @capacitor/android ile aynı ana sürümde olmalı. Uyumsuzluk native derleme hatalarına ya da çalışırken çökmelere yol açar.
• Şifresiz (cleartext) istekler. Android düz http:// trafiğini varsayılan olarak engeller. Üretim derlemeleri yalnız HTTPS API'leri çağırmalı.
• Native eklentiler ve 16 KB sayfalar. .so kitaplığı içeren eklentiler 16 KB bellek sayfalarını desteklemeli. Play Console bunun için uyarır ve 1 Şubat 2027'den itibaren desteklemeyen güncellemeler yayınlanamaz.
• Yalnız tarayıcıda test etmek. Geri tuşu, izinler ve derin bağlantılar Android WebView'da farklı davranır. Yüklemeden önce sürüm derlemesini gerçek bir cihaza kur.

Capacitor release derlemelerindeki sorunların çoğu web katmanındadır; bu yüzden en iyi giriş yolu zaten bildiğin tarayıcı araçlarıdır. Release derlemesinde bunlar kapalıdır: webContentsDebuggingEnabled varsayılan olarak false olur, Capacitor'ın kendi günlükleri de varsayılanı debug olan loggingBehavior ayarını izler; yani release derlemeleri sessiz kalır.

1. 1

   Debug derlemesinde yeniden üret

   Uygulamayı Android Studio'dan bir telefonda çalıştır, bilgisayarındaki Chrome'da chrome://inspect aç ve WebView'ı seç. Web kodun için konsol, ağ paneli ve kesme noktaları elinde olur. Edge'de edge://inspect aynı şekilde çalışır.

2. 2

   Release derlemesini yalnız yerelde incele

   Hata yalnız release'te çıkıyorsa kendin kuracağın bir derlemede webContentsDebuggingEnabled değerini geçici olarak true yap. Bu derlemeyi asla yükleme: uygulamanın web içeriğini her cihazda hata ayıklanabilir hale getirir.

3. 3

   Yerel çökmeleri Play Console'da topla

   Capacitor'ın Java kodundaki ya da yerel eklentilerdeki çökmeler İzle ve iyileştir → Android vitals → Çökmeler ve ANR'ler altında görünür. R8 açıksa .aab içindeki eşleme dosyası onları okunur yapar.

const config: CapacitorConfig = {
  // ...
  android: {
    // Never ship this to Google Play
    webContentsDebuggingEnabled: true,
  },
};

Test edicilerden cihaz modelini, Android sürümünü ve Android System WebView sürümünü iste. Yalnız WebView'da görülen hataların çoğu bu son sayıya bağlıdır; android.minWebViewVersion altındaki sürümler de uygulamanın desteklediği aralığın dışındadır.

Ionic / Capacitor paketin derlenip imzalandıktan sonra gerisi Play Console'da geçer ve her çatıda aynıdır. Bu, kısa kontrol listesi; her menü ve ekran Play Console adımlarının tamamında anlatılıyor.

• Uygulama kurulumunu bitir: Kontrol Paneli'nde gizlilik politikası, uygulama erişimi, reklamlar, içerik derecelendirmesi, hedef kitle, veri güvenliği ve mağaza girişi.
• Kapalı test sürümü oluştur: Test et ve yayınla → Test → Kapalı test altında test edicilerinin ülkelerini seç, .aab dosyasını yükle ve incelemeye gönder.
• Test edicileri Google Group ile ekle: Test ediciler sekmesinde grubu ekle ve opt-in bağlantısını paylaş. Bağlantı, kanal Yayınlandı durumuna geçince çalışır.
• En az 12 test ediciyi 14 gün kesintisiz opt-in tut. Dahili test sayılmaz; ayrılıp geri dönen birinin 14 günü baştan başlar.
• Test sırasında en az bir güncelleme yayınla ve test edicilerin ne bulduğunu, senin neyi değiştirdiğini not et.
• Üretime başvur: Kontrol Paneli'nden başvur ve testin, uygulaman ve hazırlığın hakkındaki üç bölümü yanıtla. Karar Google'ındır; kimse onayı garanti edemez.

Ayrılanları hesaba kat: 12 kişiden fazlasını bul ki biri ayrıldığında takvimin uzamasın. Play Console adımlarının tamamını gör.

Web uygulamasını yeniden derle, eşitle, versionCode'u artır ve aynı kapalı test kanalı için yeni bir imzalı paket oluştur:

npm run build
npx cap sync android
npx cap open android

Google Play'in Cihaz ve Ağ Kötüye Kullanımı politikası bir uygulamanın kendini Google Play dışında güncellemesini yasaklar; WebView'daki JavaScript gibi bir yorumlayıcıda ya da sanal makinede çalışan kod için ise istisna tanır. Web katmanı için canlı güncelleme servislerinin var olma nedeni budur. Yerel kod, eklentiler ve izinler her zaman Google Play üzerinden yeni bir paket ister.

Kapalı test sırasında en düz yol, kapalı test kanalında yeni bir versionCode'dur: incelenir, test ediciler onu Google Play'den alır ve sürüm geçmişinde görünür. Ayrıca bir canlı güncelleme servisi kullanıyorsan onu gerçek düzeltmelere ayır ve kapalı test kanalındaki web derlemesini onunla eşit tut.

• WebView alt sınırına dikkat et. android.minWebViewVersion varsayılan olarak 60 olur ve 55 altına inemez. Sorun yaşayan test ediciler önce Google Play'den Android System WebView'ı güncellemeli.
• Karışık içerik yok. android.allowMixedContent varsayılan olarak kapalıdır ve üretim için değildir. Her API'yi ve varlığı HTTPS üzerinden sun, server.cleartext ayarını da varsayılan false değerinde bırak.
• Her derlemeden önce sync et. Her düzeltme, web derlemesinden sonra npx cap sync android ister; yoksa yeni paket hala eski JavaScript'i içerir.