Flutter uygulamaları için Google Play kapalı testi

Yeni uygulamalarda Play Uygulama İmzalama zorunlu: uygulama imzalama anahtarını Google saklar, sen her yüklemeyi kendi yükleme anahtarınla imzalarsın. Yükleme anahtarını kaybedersen Google'dan sıfırlamasını isteyebilirsin; uygulaman onunla birlikte kaybolmaz. Anahtarı keytool ile oluştur:

keytool -genkey -v -keystore ~/upload-keystore.jks -keyalg RSA \
        -storetype JKS -keysize 2048 -validity 10000 -alias upload

Sonra şifreleri ve anahtar deposunun yolunu içeren android/key.properties dosyasını oluştur. Bu dosyayı da .jks dosyasını da sürüm kontrolüne ekleme:

storePassword=<keystore password>
keyPassword=<key password>
keyAlias=upload
storeFile=/Users/<you>/upload-keystore.jks

Dosyayı android/app/build.gradle.kts içinde yükle ve release derleme türünü yeni imza yapılandırmasına bağla:

import java.util.Properties
import java.io.FileInputStream

val keystoreProperties = Properties()
val keystorePropertiesFile = rootProject.file("key.properties")
if (keystorePropertiesFile.exists()) {
    keystoreProperties.load(FileInputStream(keystorePropertiesFile))
}

android {
    // ...
    signingConfigs {
        create("release") {
            keyAlias = keystoreProperties.getProperty("keyAlias")
            keyPassword = keystoreProperties.getProperty("keyPassword")
            storeFile = keystoreProperties.getProperty("storeFile")?.let { file(it) }
            storePassword = keystoreProperties.getProperty("storePassword")
        }
    }
    buildTypes {
        release {
            signingConfig = signingConfigs.getByName("release")
        }
    }
}

Eski projeler build.gradle.kts yerine build.gradle (Groovy) kullanır; alanlar aynıdır. Gradle dosyalarını değiştirdikten sonra flutter clean çalıştır.

Her yüklemenin sürüm kodu, hangi kanalda olursa olsun daha önce yüklediğin tüm paketlerden büyük olmalı. Flutter'da bu, pubspec.yaml içindeki + işaretinden sonraki sayıdır:

version: 1.0.0+1

1.0.0 kullanıcıların gördüğü sürüm adı olur, 1 ise sürüm kodu. Bunu +2, +3 diye artır ya da derlerken ikisini --build-name ve --build-number ile ez.

31 Ağustos 2026'dan beri yeni uygulamalar ve güncellemeler Android 16'yı (API düzeyi 36) ya da üstünü hedeflemek zorunda. Gradle dosyası targetSdk = flutter.targetSdkVersion kullandığı için bunu yükseltmenin olağan yolu Flutter'ı güncellemektir. Flutter sürümün eskiyse targetSdk = 36 değerini kendin yaz ve yüklemeden önce yeni bir Android sürümünde test et.

• Tekrar kullanılan derleme numarası. Play Console sürüm kodu daha önce kullanılmış paketi reddeder. Yüklemeyi planladığın her derlemeden önce pubspec.yaml içindeki +N değerini artır.
• Sembolsüz gizleme. --obfuscate yalnız --split-debug-info ile birlikte çalışır. Yüklediğin her derlemenin sembol klasörünü sakla; yoksa test edicilerden gelen çökme kayıtlarını okuyamazsın.
• Yanlış flavor. Flavor kullanınca staging uç noktalarıyla staging derlemesini yüklemek kolaydır. Test ediciler de üretim kullanıcılarının hiç görmeyeceği hataları bildirir.
• Release'te ağ yok. Ana manifest'te INTERNET izni eksikse uygulama debug'da çalışır, test edicilerde sessizce başarısız olur.
• Debug imzalı paket. release derleme türü hala debug imza yapılandırmasını kullanıyorsa Play Console yüklemeyi reddeder.
• Eski native kodlu eklentiler. .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. Eklentileri ve Flutter SDK'sını testin ortasında değil, öncesinde güncelle.

flutter build appbundle --obfuscate --split-debug-info=build/symbols

Test ediciler hata raporlarına yığın izi (stack trace) yapıştırır, Play Console da çökmeleri İzle ve iyileştir → Android vitals → Çökmeler ve ANR'ler altında toplar. Flutter'da bir yığın izinin iki yarısı vardır: --obfuscate ile kısa ve anlamsız adlara dönüşen Dart kısmı ve R8'in küçülttüğü Android kısmı. Flutter release derlemelerinde kod küçültmeyi her zaman açar; ikisine de hazırlıklı ol.

1. 1

   Dart sembollerini sakla

   --split-debug-info ile yapılan bir derleme, her mimari için app.android-arm64.symbols gibi bir sembol dosyası yazar. Klasörü ait olduğu sürüm koduyla birlikte sakla: başka bir derlemenin dosyası bu izi çözemez.

2. 2

   Dart izlerini çöz

   İzi bir dosyaya kaydet ve cihazın mimarisine ait sembol dosyasıyla birlikte flutter symbolize komutuna ver. Güncel telefonların çoğu arm64'tür.

3. 3

   Java tarafını Play Console'a bırak

   Android Gradle eklentisi 4.1 ve üstünde R8 eşleme dosyası .aab içinde gider; Play Console eklentilerden gelen Java ve Kotlin satırlarını ayrıca dosya yüklemeden çözer.

flutter symbolize -i crash.txt -d build/symbols/app.android-arm64.symbols

Gizleme yalnız sembollerin adını değiştirir; hiçbir şeyi şifrelemez ve gizli bilgiler için uygun bir yer değildir. runtimeType.toString() değerini bir sınıf adıyla karşılaştıran kod gizlemeden sonra bozulur; enum adları ise okunur kalır.

Flutter 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.

Flutter'da: derleme numarasını artır, yeniden derle ve yeni paketi aynı kapalı test kanalına yükle.

flutter build appbundle --build-name=1.0.1 --build-number=2

Her yüklemeden önce release derlemesini gerçek bir telefonda çalıştır. flutter install release APK'sını bağlı cihaza kurar; eksik izinleri, yanlış flavor'ı ve yalnız release'te çıkan çökmeleri dakikalar içinde yakalarsın:

flutter build apk
flutter install

Yüklemek üzere olduğun paketin kendisini denemek için onu Google'ın bundletool aracıyla cihaz APK'larına çevir ya da kapalı test kanalına yükleyip bir test edici hesabıyla Google Play'den kur. Böylece Play'in cihaza göre böldüğü APK'lar dahil, test edicilerin aldığını test edersin.

• Her güncellemede tek ve net bir değişiklik. Küçük sürümler hangi düzeltmenin hangi test edici raporuna yanıt verdiğini netleştirir ve üretim erişimi formu için somut örnekler sağlar.
• Test ortasında Flutter sürümünü değiştirme; test edicilerin bildirdiği bir hata gerektirmiyorsa. SDK yükseltmesi motoru, her eklentinin yerel kodunu ve belki targetSdk değerini aynı anda değiştirir.
• İncelemeye zaman bırak. Kapalı test kanalındaki her yeni sürüm test edicilere ulaşmadan önce Google'a gönderilir; son düzeltmeni son güne bırakma.