TWA Uygulamanız Google Play'de Reddedildi mi? WebView'a Geçin

Bağımsız bir geliştiricinin karşılaşabileceği en sinir bozucu reddetmelerden biridir bu. Test kullanıcılarınız gerçekten aktiftı. 12 kişi vardı. 14 gün geçti. Google yine de "test kullanıcılarınız yeterince etkileşimli değildi" / "your testers were not engaged enough" dedi. Uygulamanızı bir Trusted Web Activity (TWA) veya PWA sarmalayıcı olarak kurduysanız, bu örüntü hayal değildir: 7.400+ uygulamada gördüğümüz gibi, sarmalayıcı sürümler standart native veya WebView sürümlerine göre bu retle çok daha sık karşılaşır. Bu rehber nedenini açıklar, önemli mimari farkı gösterir ve bankanızdaki test günlerini çöpe atmadan WebView'a geçişi adım adım anlatır.

TWA Uygulamaları Kapalı Testte Neden Reddedilir?

Bir Trusted Web Activity, ekranları kendi uygulamanızın içinde çizmek yerine sitenizi Chrome'un Custom Tabs yüzeyi üzerinden sunar. Siteyi veya PWA'yı yüklenebilir hale getirmenin hızlı bir yoludur ve birçok üretim uygulamasında sorun çıkarmaz. Sorun özellikle bir kişisel geliştirici hesabının üretim erişiminden önce zorunlu 14 günlük kapalı test şartını geçmesi gerektiğinde ortaya çıkar.

7.400+ uygulamayı bu süreçten geçirmeye yardımcı olurken edindiğimiz deneyime göre TWA ve PWA sarmalayıcı sürümler, test kullanıcıları her gün gerçekten aktif olsa bile standart native uygulamalara göre "testers were not engaged" / "test kullanıcıları yeterince etkileşimli değildi" reddine çok daha sık takılır. Örüntü o kadar tutarlıdır ki, uygulama hâlâ 14 günlük kapalı testi geçmek zorundaysa geliştiricileri TWA'dan uzak tutuyoruz.

TWA Gerçekte Nedir (ve Nasıl İnşa Edilir)

Reddi düzeltmeden önce tam olarak ne yüklediğinizi anlamak faydalıdır. Bir Trusted Web Activity, özünde gerçek bir tarayıcı motoru içinde tam ekran çalışan web sitenizdir: adres çubuğu yok, tarayıcı arayüzü yok, kullanıcının bir web sayfasına baktığını söyleyen hiçbir şey yok. Kullanıcıya native bir uygulama gibi görünür ve hissettirir. Motorun altında ise canlı web sitenizdir.

TWA'lar genellikle Google'ın Bubblewrap CLI'si veya PWABuilder ile üretilir; ikisi de Google'ın androidbrowserhelper kütüphanesinin üzerindedir. Aracı bir URL'ye yönlendirirsiniz, bir Android projesi çıkar, imzalar ve AAB'yi Google Play'e yüklersiniz.

Geliştiriciler Neden TWA'ya Yönelir

Redde Yol Açan Ödün

TWA'yı ucuz kılan şey, kapalı test için onu kırılgan da kılar:

• İnternet gerekir. Sitenize açılan bir penceredir; PWA'nızın sağlam offline desteği yoksa zayıf bağlantı zayıf uygulama demektir.
• Play Store red riski. Minimum Functionality / yeniden paketlenmiş içerik politikası "sadece bir sarmalayıcıdaki web sitesi" uygulamalarını hedefler. Gerçek native yeteneği olmayan bir TWA, özellikle yeni gönderimlerde reddedilebilir veya kaldırılabilir. Native özellikler (push bildirimleri, offline mod, kamera, paylaşım hedefleri) eklemek o çizginin doğru tarafında kalmanın yoludur.
• Yukarıda ele alınan etkileşim sinyali sorunu: bu yüzden 14 günlük kapalı testi bekleyen kişisel hesaplar "testers not engaged" mesajını almaya devam eder.

Yanlış Kanı: TWA Bir WebView Değildir

Çoğu makalenin yanlış anlattığı kısım budur ve sorun nasıl çözüleceğini değiştirdiği için net olmak gerekir. Bir TWA, Android'in WebView bileşenini hiç kullanmaz.

TWA, Custom Tabs arkasındaki motoru kullandığı için gerçek Chrome tarayıcısıyla aynı render motoru, JavaScript motoru ve güvenlik sandbox'ını, ayrıca Chrome ile paylaşılan çerez ve depolamayı (web'de zaten oturum açmış kullanıcı oturumda kalır), otomatik tarayıcı güncellemelerini ve tam web platformu desteğini alırsınız. Normal yayınlanmış bir uygulama için bu gerçekten güçlüdür; ama aynı zamanda ekranlarınızın süreç dışında, Chrome'un içinde çalıştığı anlamına gelir. Hem etkileşim sinyali seyrelmesinin hem de düşük aktif kullanıcı sayılarının kökü budur.

Başlatma Akışı, Adım Adım

Güven Kontrolü: Digital Asset Links

Chrome adres çubuğunu yalnızca uygulama web sitesine sahip olduğunu Digital Asset Links ile kanıtlarsa kaldırır. Uygulama hangi siteyi temsil ettiğini bildirir; site de uygulamanın package adını ve imzalama sertifikası parmak izini (SHA-256) adlandıran bir dosyayı /.well-known/assetlinks.json adresinde sunmalıdır.

[{
  "relation": ["delegate_permission/common.handle_all_urls"],
  "target": {
    "namespace": "android_app",
    "package_name": "com.yourapp.name",
    "sha256_cert_fingerprints": [
      "AB:CD:EF:...:99"  // your signing cert SHA-256
    ]
  }
}]

Etkileşim Sinyali Yolu: TWA vs WebView

Reddi anlamanın en basit yolu, bir test kullanıcısının aktivitesinin gerçekten nereye gittiğini izlemektir. TWA'da ekranlarınız uygulamanızdan bir katman uzakta, Chrome'un Custom Tabs yüzeyinin içindedir. WebView uygulamasında aynı ekranlar kendi uygulama sürecinizde çalışır ve doğrudan package'ınıza yazılır. Aktivitenin ne kadar güçlü kayda geçtiğini değiştiren tek fark budur.

TWA Nasıl Tanınır (Dışarıdan ve İçeriden)

Sizin (veya bir yüklenicinin) gönderdiği uygulamanın gerçekten TWA olup olmadığından emin değil misiniz? Önce gözle, sonra APK veya bağlı cihazdan kesin olarak nasıl doğrulayacağınız burada.

Hızlı görsel ipuçları (kullanıcı olarak)

• Web sitesi gibi davranır, tam olarak: çünkü web sitesidir.
• Geliştirici yanlış yapılandırdıysa üstte bir tarayıcı adres çubuğu görürsünüz: kesin işaret (yukarıdaki assetlinks hatasına bakın).
• İçerik Play Store'da bir uygulama güncellemesi olmadan yenilenir.

Kesin teknik ipuçları (APK / cihaz incelemesi)

adb ile doğrulayın

Bağlı bir cihazda (veya emülatörde) iki komut işi bitirir:

# Is it a TWA? Look for the delegation service:
adb shell dumpsys package <package.name> | grep -i DelegationService

# Which site does it wrap, and is the trust check passing?
adb shell pm get-app-links <package.name>
#   -> "verified"  = Digital Asset Links pass (fullscreen)
#   -> "1024"      = verification failed (address bar shows)

Kapalı Test için TWA vs WebView: Yan Yana

Her iki mimari de web içeriğini sarmalar. 14 günlük kapalı testi geçmek için önemli fark, o içeriğin nerede çalıştığı ve aktivitenin nasıl yazıldığıdır. Bir döngüde üretime ulaşıp ulaşamayacağınızı belirleyen metriklerde şöyle karşılaştırılırlar.

Çözüm: Bunun Yerine Standart Bir WebView Uygulaması İnşa Edin

Bir TWA'yı yamalamak veya ondan daha iyi sinyaller koparmaya çalışmak yerine daha temiz yol, uygulamayı bir WebView bileşeni etrafında yeniden inşa edip o sürümü yayınlamaktır. Üç ana akım yol vardır; hepsi sitenizi kendi uygulamanızın içinde yükler:

Minimum WebView kurulumu (kopyalamaya hazır)

Çekirdek küçüktür: JavaScript ve depolama açık bir WebView URL'nizi yükler, gezinmeyi Chrome'a fırlatmak yerine uygulama içinde tutar ve Google incelemesinin beklediği geri düğmesi işleyicisini bağlar. Dilinize göre sekmeyi değiştirin ve temeli kopyalayın:

val webView = findViewById<WebView>(R.id.webview)
webView.settings.apply {
    javaScriptEnabled = true          // most sites need this
    domStorageEnabled = true          // localStorage / sessionStorage
    cacheMode = WebSettings.LOAD_DEFAULT
}

// Keep links INSIDE the app (this is the key difference vs a TWA)
webView.webViewClient = WebViewClient()
webView.loadUrl("https://yourwebsite.com")

// The exact back-button handler Google looks for
onBackPressedDispatcher.addCallback(this, object : OnBackPressedCallback(true) {
    override fun handleOnBackPressed() {
        if (webView.canGoBack()) {
            webView.goBack()
        } else {
            finish()
        }
    }
})

WebView webView = findViewById(R.id.webview);
WebSettings settings = webView.getSettings();
settings.setJavaScriptEnabled(true);      // most sites need this
settings.setDomStorageEnabled(true);      // localStorage / sessionStorage
settings.setCacheMode(WebSettings.LOAD_DEFAULT);

// Keep links INSIDE the app (this is the key difference vs a TWA)
webView.setWebViewClient(new WebViewClient());
webView.loadUrl("https://yourwebsite.com");

// The exact back-button handler Google looks for
getOnBackPressedDispatcher().addCallback(this, new OnBackPressedCallback(true) {
    @Override
    public void handleOnBackPressed() {
        if (webView.canGoBack()) {
            webView.goBack();
        } else {
            finish();
        }
    }
});

# Wrap an existing web/PWA project in a native WebView shell
npm install @capacitor/core @capacitor/cli
npx cap init "YourApp" "com.yourapp.name"

# Point Capacitor at your live site (capacitor.config.ts)
#   server: { url: "https://yourwebsite.com", cleartext: false }

npm install @capacitor/android
npx cap add android
npx cap sync

# Capacitor handles back-button + DOM storage natively.
# Open in Android Studio to build a signed AAB:
npx cap open android

İncelemeyi geçmek için eklemeniz gereken üç şey

Yalnızca loadUrl() çağıran çıplak bir WebView hâlâ thin wrapper'dır. Bu üç ekleme onu gerçek bir uygulama yapar ve test kullanıcılarını boş ekranlardan uzak tutar:

14 Günlük Sayacı Yeniden Başlatmadan Nasıl Geçersiniz

Testin ortasındaysanız baştan başlamak zorunda değilsiniz. Aynı test kanalında aynı package name ile kaldığınız sürece 14 günlük sayaç bir uygulama güncellemesinden sağ çıkar. Güvenli geçiş şöyle:

WebView Uygulaması Hâlâ "Thin Wrapper" Sayılır mı?

WebView'ın sihirli bir değnek sandığı geliştiricileri yakalayan tuzak budur. TWA'dan WebView'a geçmek etkileşim sinyali sorununu ele alır ama Google'ın Spam and Minimum Functionality politikasından muaf tutmaz. Ana sayfanızın bir çerçevede olduğu bir WebView, çıplak bir TWA gibi thin wrapper olarak reddedilebilir.

Bunları iki ayrı kapı olarak görmek yardımcı olur. Bir test hizmeti veya WebView yeniden inşası birini geçmenize yardımcı olabilir; diğerini sizin yerinize geçmez.

Yani hedef yalnızca "TWA yerine WebView" değildir; kendi ayakları üzerinde duracak kadar gerçek değeri ve native davranışı olan bir WebView uygulamasıdır. Pratikte bu demektir ki:

Kalite reddini neyin tetiklediğine dair daha derin kontrol listesi mi istiyorsunuz? Kapalı test neden reddedilir rehberimiz, etkileşim dışındaki en yaygın politika ve inceleme başarısızlıklarını ayırır.

Uygulamanız TWA mı Emin Değil misiniz? Sipariş Anında Kontrol Ederiz

adb komutları çalıştırmanız veya APK'nizi kendiniz kurcalamanız gerekmez. Evet: PrimeTestLab uygulamanızın TWA olup olmadığını sizin için doğrulayabilir. Test hizmetimizi sipariş ettiğiniz anda ekibimiz sürümünüzü inceler, TWA veya PWA sarmalayıcı olup olmadığını belirler ve öyleyse etkileşim nedeniyle işaretlenecek bir mimaride 14 günlük sayaç boşa gitmeden önce tam olarak neyi düzeltmeniz gerektiğini söyler.

Sipariş anında ne olur

PrimeTestLab Nasıl Yardımcı Olur (Sorunun Diğer Yarısı)

Mimari sorunun bir yarısıdır. Diğer yarısı (çoğu solo geliştiriciyi durduran) aralıksız 14 gün teste katılacak ve kayıtlı kalacak 12 test kullanıcısı bulmaktır. Bunu PrimeTestLab üstlenir.

Gerçek Android cihazlarda doğrulanmış, kayıtlı test kullanıcıları sağlar ve kapalı testinizi şartın tamamında aktif tutarız; böylece tek bir test kullanıcısının düşmesi 14 günlük seriyi bozmaz. Kapalı test kayıt bağlantınızı paylaşırsınız; davet, kayıt doğrulama, günlük etkileşim izleme ve 14 günlük tutmayı biz yönetiriz. 7.400+ uygulama ve sayıyor, ilk denemede %99,9 başarı oranı.

Güncel paketler

Sık Sorulan Sorular

Özet