Capacitor ile HTML5 Oyunu Google Play'de Yayınlama, Adım Adım

Bir HTML5 oyunu Google Play'de yayınlamak için oyun klasörünü Capacitor ile yerel bir Android projesine sararsınız, Android Studio'da imzalı bir Android App Bundle derlersiniz, uygulamayı Play Console'da oluşturursunuz, içerik formlarını yanıtlarsınız ve paketi üretimden önce bir test kanalına yüklersiniz. Geliştirici hesabınız 13 Kasım 2023'ten sonra açılmış kişisel bir hesapsa, Google ayrıca üretime başvurmadan önce en az 12 test kullanıcısıyla 14 gün süren kapalı bir test istiyor.

Bunu kendi oyunlarımızla yaptık. Ekim 2026'da Ricopop ve Velvet Pool'u Capacitor ile paketleyip ikisini de Google Play üretim incelemesine gönderdik; aksiyon oyunumuz Little Ninja Dash'i de. Bu rehber, 30 Ekim 2026'da okunan resmi Capacitor, Android ve Play Console sayfalarının söylediklerini kendi sürüm notlarımızın kaydettikleriyle birleştiriyor. Kurallar ve gereksinimler değişiyor; göndermeden önce bağlantı verilen her sayfayı kontrol edin.

HTML5 oyunu Google Play'de yayınlamadan önce

• Bir Google Play geliştirici hesabı. Google tek seferlik 25 ABD doları kayıt ücreti alıyor ve her geliştiriciden kimlik doğrulaması istiyor. Kişisel hesaplar ayrıca yayınlamadan önce Play Console mobil uygulamasıyla bir Android cihaza erişimlerini doğrulamalı.
• Node.js ve Android Studio. Capacitor'ın Android belgeleri, Capacitor Android uygulamalarının Android Studio üzerinden yapılandırılıp yönetildiğini söylüyor.
• Kök dizininde bir index.html bulunan, kendi klasöründen çevrimdışı çalışan bir oyun.
• Oyun için bir lisans. Şablonlarımızda bir lisans bir son ürünü kapsar ve o oyunu Google Play ile App Store dahil istediğiniz yerde yayınlayabilirsiniz. Şablonun kendisini yeniden satamazsınız. Fiyat ya da uygulama içi satın alma eklemeden önce bize sorun; şartlarımız oyuncuların ürüne ücretsiz ya da reklamlı eriştiğinden söz ediyor.

Şablon sürümlerimiz tarayıcı oyunlarıdır. Her sürüm sayfası yerel uygulama derlemelerini dahil olmayanlar arasında listeler; yani aşağıdaki adımlar sizin yapacağınız ya da bizden teklifle sipariş edeceğiniz işlerdir.

Android için de paketlediğimiz bilardo şablonu Velvet Pool'u inceleyin

Adım 1: oyun klasörünü Capacitor ile sarmalayın

Capacitor'ın bir package.json'a, derlenmiş web dosyalarının bulunduğu bir klasöre ve o klasörün kökünde bir index.html'e ihtiyacı var. Başlangıç sayfası, index.html'de bir head etiketi olması gerektiği, yoksa eklentilerin çalışmayacağı uyarısını yapıyor. İndirilen bir HTML5 şablonunda bu klasör genellikle zaten vardır: bizimkilerde adı game/.

1. Yeni bir proje klasöründe npm i @capacitor/core ve npm i -D @capacitor/cli komutlarını çalıştırın.
2. npx cap init komutunu çalıştırın. Uygulama adını, uygulama kimliğini (ters alan adı, örneğin com.yourstudio.yourgame) ve web klasörünü sorar. webDir'i oyun klasörünüze yönlendirin.
3. npm i @capacitor/android, ardından npx cap add android komutunu çalıştırın. Bu, android/ projesini oluşturur.
4. Oyun dosyalarını her değiştirdiğinizde npx cap sync çalıştırın. Dosyaları yerel projeye kopyalar.
5. Projeyi Android Studio'da açmak için npx cap open android çalıştırın.

Capacitor'ın belgelerine göre API 24 ve üzeri, yani Android 7 ve sonrası destekleniyor. Android projelerimiz bu alt sınırı kullanıyor.

Bizim farklı yaptığımız şey: yerel projeyi, oyunu kendi web klasörüne kopyalayan ayrı bir mobile/ çalışma alanında tutuyoruz. Web sitesi sürümü olduğu gibi kalıyor; yerel reklamlar gibi yalnızca uygulamaya ait her şey bu çalışma alanında duruyor.

Adım 2: uygulama paketini derleyin ve imzalayın

Ağustos 2021'den beri Google Play'deki yeni uygulamalar APK değil, Android App Bundle (AAB) olarak yayınlanmak zorunda. Android Studio'da Build, ardından Generate Signed Bundle/APK seçeneğini kullanın, Android App Bundle'ı seçin ve bir keystore oluşturun ya da seçin.

Bu keystore yükleme anahtarınızı tutar. Google'ın uygulama imzalama sayfası, yeni uygulamaların ilk yayında kurmak zorunda olduğu Play App Signing ile uygulama imzalama anahtarını Google'ın sakladığını, sizin de her yüklemeyi yükleme anahtarıyla imzaladığınızı açıklıyor. Yükleme anahtarını gizli tutun, güçlü parolalar seçin ve keystore'u güvenli bir yerde saklayın. Kaybolur ya da ele geçirilirse Play Console üzerinden yükleme anahtarı sıfırlama talep edebilirsiniz.

• Hedef API düzeyi: 31 Ağustos 2026'dan itibaren yeni uygulamalar ve güncellemeler Android 16'yı (API düzeyi 36) ya da üstünü hedeflemeli. Hedefi android/app/build.gradle içinde kontrol edin.
• Sürüm kodu: her yüklemeden önce artırın. Yüklediğiniz her paket kendi sürüm kodunu tüketir; bu yüzden biz her derlemeden önce Play Console'daki en yüksek kodu okuyoruz.
• Yalnızca release derlemesi: üretime gönderdiğiniz pakette hata ayıklama menüsü, test reklam kimliği ya da geliştirici kısayolu olmasın.

Webview içinde ne bozulur ve biz ne yaptık

Tarayıcıda iyi çalışan bir oyun, uygulama içinde farklı davranabilir. Sürüm notlarımızın kaydettiği sorunlar bunlar; belgelenmiş bir çözüm varsa onunla birlikte.

Android geri düğmesi

Capacitor'ın App eklentisinde bir backButton olayı var. Belgelerine göre bu olayı dinlemek varsayılan geri düğmesi davranışını devre dışı bırakır; geri tuşunun ne yapacağına siz karar verirsiniz. Uygulamayı kapatmak için App.exitApp() da sunuluyor. Velvet Pool'da geri tuşunun oyunu kapatmak yerine duraklatma menüsünü açmasını sağladık.

Duraklatma ve devam etme

Aynı eklenti appStateChange, pause ve resume olaylarını tetikler. Oyuncu uygulamadan çıktığında oyunu, zamanlayıcıları ve oynayan reklamı duraklatmak, sonra da temiz biçimde devam etmek için bunları kullanın.

localhost'ta hata ayıklama kısayolları

Capacitor, uygulama içinde oyunu yerel bir adresten sunar. Oyununuz localhost'ta çalışırken hata ayıklama araçlarını açıyorsa, bunlar uygulamada da açılır. Derleme betiklerimiz bu bayrakları zorla kapatıyor, kapatamazsa derlemeyi reddediyor.

Reklamlar

Uygulamalarımızın içinde web sitesi reklam kodunu kullanmıyoruz. Android'de bir Capacitor eklentisi üzerinden yerel AdMob SDK'sını kullanıyoruz; test sırasında Google'ın demo reklam birimleriyle, uygulamanın kendi birimleriyle yalnızca üretim derlemesinde.

Yerleşim ve kayıt

Emülatörde yatay modda kesilen düğmeler ve kötü bölünen uzun kelimeler bulduk; tarayıcı sürümünde bunlar görünmüyordu. Her ekranı iki yönde de test edin ve uygulamayı kapatıp yeniden açtıktan sonra ilerlemenin korunduğunu kontrol edin.

Google Play için paketlediğimiz bir başka şablon olan Ricopop'u inceleyin

Adım 3: Play Console kurulumu ve mağaza sayfası

Uygulamayı Play Console'da oluşturun, ardından uygulama içeriği bölümünü sırayla tamamlayın. Her oyun için doldurduğumuz formlar şunlardı: gizlilik politikası, uygulama erişimi, reklamlar, içerik derecelendirmesi, hedef kitle, Veri güvenliği, reklam kimliği ve devlet, finans ve sağlık beyanları.

• İçerik derecelendirmesi: Google, tüm uygulamaların bir IARC derecelendirmesine sahip olması gerektiğini, olmayanların kaldırılacağını söylüyor. Anketi dürüstçe yanıtlayarak alırsınız.
• Veri güvenliği: hiç veri toplamayanlar dahil her uygulama bu formu doldurmalı. Formda reklam SDK'sı gibi üçüncü taraf SDK'ların topladığı veriler de yer almalı ve bir gizlilik politikası bağlantısı gerekiyor.
• Hedef kitle: gerçekten hedeflediğiniz oyunculara göre yanıtlayın. Derecelendirme ve hedef kitle ayrı yanıtlardır.

Mağaza sayfası görselleri

• Uygulama simgesi: 512 x 512 piksel, 32 bit PNG, en fazla 1024 KB.
• Öne çıkan grafik: 1024 x 500 piksel, JPEG ya da alfa kanalı olmayan 24 bit PNG.
• Ekran görüntüleri: cihaz türü başına en az iki, en fazla sekiz. Oyunlar için Google, gerçek oynanışı gösteren en az üç adet 16:9 yatay (en az 1920 x 1080) ya da 9:16 dikey (en az 1080 x 1920) görüntü öneriyor.
• Kısa açıklama: en fazla 80 karakter.

Adım 4: test, ardından üretim

İş akışımızda önce dahili test geliyor: uygulamayı gerçek bir hesapla Play'den kurup her şeyden önce oynamak. Ardından sürüm üretime yükseltiliyor ve orada Google'ın incelemesinden geçiyor.

Yeni kişisel hesaplar için kural

Google'ın Play Console Yardım sayfasına göre 13 Kasım 2023'ten sonra açılan kişisel geliştirici hesapları, en az 14 gün boyunca kesintisiz olarak teste katılmış en az 12 test kullanıcısıyla kapalı bir test yürütmeli. Ardından Kontrol Paneli'nden üretim erişimi için başvurur ve kapalı test, uygulama ve üretime hazırlığı hakkındaki soruları yanıtlarsınız. Bu iki haftayı çıkış tarihinize dahil edin.

Bir müşteriye durum bildirirken aşamaları birbirinden ayırın: test kanalına yüklendi, incelemeye gönderildi, onaylandı ve Google Play'de yayında, dört ayrı andır. Kendi sürüm notlarımız onay tarihlerini değil, gönderim tarihlerini kaydediyor; bu rehber de öyle.

Şablonlarımız neleri içeriyor ve sizin için yapabileceğimiz kısım

Her şablon barındırmaya hazır oyun klasörü, okunabilir kaynak kodu, bir kılavuz ve 6 ay destekle gelir; uzatmayla 12 ay. Destek, sağlanan dosyaların kurulumu ve kullanımını ve tekrar üretilebilen hataların düzeltilmesini kapsar. Android için paketleme, yerel reklamlar, SDK entegrasyonu ve mağazada yayınlama ayrı hizmetlerdir.

Android Studio ile kendiniz uğraşmak istemiyorsanız şablonu, mağaza hesabı planınızı ve teslim tarihini bize gönderin. Hiçbir iş başlamadan kapsam, fiyat ve süreyle dönüş yaparız. Özel işler için fiyat listesi yayınlamıyoruz.

Oyununuzu Google Play için paketletmek üzere teklif isteyin

Sıkça sorulan sorular

Bir HTML5 oyunu Google Play'de yayınlamak ne kadara mal olur?

Google, geliştirici hesabı için tek seferlik 25 ABD doları kayıt ücreti alıyor. Diğer maliyetleriniz oyun lisansı, mağaza görselleri ve zamanınızdır; paketlemeyi başkası yapıyorsa da teklifli bir hizmet.

Google Play'de yayınlamak için 12 test kullanıcısına ihtiyacım var mı?

Yalnızca hesabınız 13 Kasım 2023'ten sonra açılmış kişisel bir geliştirici hesabıysa. Bu hesaplar, üretim erişimine başvurmadan önce en az 14 gün teste katılmış en az 12 test kullanıcısıyla kapalı bir test yürütmeli.

APK mı, AAB mi?

AAB. Google Play'deki yeni uygulamalar Ağustos 2021'den beri Android App Bundle kullanmak zorunda. APK ise bir derlemeyi doğrudan kendi test telefonunuza kurmak için hâlâ işe yarar.

Uygulama oyunumu doğrudan web sitemden yükleyemez mi?

Biz bunu yapmıyoruz. Oyun dosyalarını uygulamanın içine koyuyoruz; böylece çevrimdışı çalışıyor ve bir siteye bağımlı kalmıyor. Google'ın spam politikası da asıl amacı bir web sitesini sahibinin izni olmadan webview içinde göstermek olan uygulamaları hedefliyor.

Şablonlarınız kutudan çıktığı gibi Google Play'e hazır mı?

Hayır. Barındırmaya hazır tarayıcı oyunlarıdır ve ürün sayfaları yerel uygulama derlemelerinin dahil olmadığını belirtir. Yukarıdaki adımlarla kendiniz paketleyebilir ya da işi bizden teklifle sipariş edebilirsiniz.