Godot oyunları için Google Play kapalı testi

Google Play debug olmayan bir imza ister. keytool ile bir sürüm anahtar deposu oluştur:

keytool -v -genkey -keystore mygame.keystore -alias mygame -keyalg RSA -validity 10000

Android ön ayarında Keystore altında Release (dosya yolu), Release User (takma ad) ve Release Password alanlarını doldur. Godot şu an anahtar deposu şifresiyle anahtar şifresinin aynı olmasını istiyor; en güvenlisi yalnız harf ve rakam kullanmak.

Bu anahtar deposu senin yükleme anahtarındır. İlk yüklemede Play Uygulama İmzalama kurulur ve uygulama imzalama anahtarını Google saklar. CI'da sırları export_presets.cfg dosyasına koyma, bunun yerine ortam değişkeni olarak ver:

GODOT_ANDROID_KEYSTORE_RELEASE_PATH=/secrets/mygame.keystore
GODOT_ANDROID_KEYSTORE_RELEASE_USER=mygame
GODOT_ANDROID_KEYSTORE_RELEASE_PASSWORD=*****

Ön ayarda Version → Code, Google'ın karşılaştırdığı tam sayıdır; Play Console tekrar kullanılan kodları reddettiği için her yüklemede artır. Version → Name oyuncuların gördüğü değerdir.

31 Ağustos 2026'dan beri yeni uygulamalar ve güncellemeler Android 16'yı (API düzeyi 36) hedeflemek zorunda. Gradle Build altındaki Target SDK targetSdkVersion değerini belirler; boş bırakılırsa şablonun varsayılanı geçerli olur. Godot sürümünün varsayılanı 36'dan düşükse değeri açıkça yaz ya da Godot'yu güncelle, sonra dışa aktarılan paketi yeni bir cihazda test et.

• Uyumsuz şablonlar. Dışa aktarma şablonları ve Android derleme şablonu editör sürümüyle aynı olmalı. Godot'yu güncelledikten sonra ikisini de yeniden kur.
• Açık kalan Export With Debug. Paket o zaman debug anahtar deposuyla imzalanır ve Play Console onu reddeder.
• Eksik arm64-v8a. Architectures altında arm64-v8a açık kalsın; Google Play 64 bit native kod ister.
• Alt çizgiyle başlayan klasörler. Gradle derlemelerinde adı _ ile başlayan bir klasördeki varlıklar pakete girmez. Test ediciler de eksik doku ya da sahnelerle karşılaşır.
• Şifrelerde özel karakterler. Dışa aktarmanın belirsiz hatalarla başarısız olmasına yol açabilir. Harf ve rakam kullan.
• C# projeleri. C# için Android dışa aktarma Godot 4.2'den beri var ama hala deneysel. Sürüm paketini erkenden gerçek cihazlarda test et.

Bir Godot dışa aktarımı betiklerini önceden derlenmiş bir motor kitaplığının üzerinde çalıştırır; bu yüzden test edici raporlarının çoğu motor çökmesi değil, betik hatası, eksik kaynak ya da cihaza özgü görüntü sorunu çıkar. Bunları görmenin en hızlı yolu, düzenleyici bağlıyken kendi telefonundur.

1. 1

   Tek tıkla dağıt

   Telefonda geliştirici modunu ve USB hata ayıklamayı aç, bağla ve Android ön ayarının Runnable olarak işaretli olduğundan emin ol. Düzenleyicinin sağ üst köşesinde bir Android düğmesi belirir ve tek tıkla dışa aktarıp kurar.

2. 2

   Uzaktan hata ayıklamayı aç

   Debug → Deploy with Remote Debug açıkken telefondaki oyun bilgisayarına geri bağlanır; düzenleyicinin hata ayıklayıcısı, kesme noktaları ve hata çıktısı masaüstündeki gibi çalışır.

3. 3

   USB güvenilmezse kablosuz geç

   Telefonda kablosuz hata ayıklamayı aç, gösterdiği kodla adb pair kullanarak eşle ve adb devices ile doğrula. adb devices telefonu listelemiyorsa Godot da onu göremez.

4. 4

   Her yüklemeden sonra Play Console'a bak

   Motor çökmeleri İzle ve iyileştir → Android vitals → Çökmeler ve ANR'ler altında görünür. Lansman öncesi rapor da yüklenen her derlemeyi otomatik olarak test cihazlarına kurar ve çökmeleri ve uyumluluk sorunlarını işaretler.

# Wireless debugging: pair once with the code shown on the phone
adb pair <ip address>:<port>
adb devices

# Watch the device log while you reproduce a tester's report
adb logcat

Export With Debug olmadan dışa aktarılan bir derleme düzenleyiciye bağlanmaz. Release derlemesinin belirli bir telefonda neden başarısız olduğunu görmek için onu oraya kur ve test edicinin adımlarını tekrarlarken adb logcat çıktısını izle.

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

Ön ayardaki Version → Code değerini artır, .aab dosyasını yeniden dışa aktar ve aynı kapalı test kanalına yükle.

Kendi denemelerin için Debug → Small Deploy with Network Filesystem USB üzerinden küçük bir çalıştırılabilir dosya dağıtır ve proje dosyalarını düzenleyiciden ağ üzerinden aktarır; büyük oyunlarda çok zaman kazandırır. Bu tamamen bir geliştirme özelliğidir: test ediciler her zaman kapalı test kanalında dışa aktarılmış tam bir .aab dosyasına ihtiyaç duyar.

• Kenardan kenara. Ön ayardaki Screen → Edge to Edge seçeneği oyunun yarı saydam sistem çubuklarının arkasına çizmesini sağlar. Açarsan önemli arayüz öğelerini DisplayServer.get_display_safe_area() ile dönen alanın içinde tut ki hiçbir şey bir çubuğun ya da kamera çentiğinin altında kalmasın.
• Yerel kitaplıkları sıkıştırma. Gradle Build → Compress Native Libraries paketi küçültür ama açılışı yavaşlatır, çünkü kitaplıkların kullanılmadan önce açılması gerekir. Google Play için Godot belgeleri bunu kapalı bırakmayı önerir.
• Dışa aktarımı betiğe bağla. İmzalama bölümündeki gibi anahtar deposunu ortam değişkenlerinde tutan başsız (headless) bir dışa aktarım her seferinde aynı paketi üretir ve sürüm kodunu artırmayı rutinin parçası yapar.
• Test ortasında Godot'u yükseltme. Yeni bir düzenleyici sürümü, test ediciler için yeni dışa aktarım şablonları, yeni bir Android derleme şablonu ve yeni bir motor kitaplığı demektir. Yükseltmeyi testten önce ya da üretim erişiminden sonra yap.