Android SDK'da hataları yönetin
SDK tarafından döndürülen her hata AdaptyError türündedir.
Hata ayıklamadan önce ayrıntılı logları etkinleştirin. Çoğu AdaptyError, temel bir Play Billing, ağ veya backend hatasını sarmalıyor. Ayrıntılı loglar açıkken (Adapty.logLevel = AdaptyLogLevel.VERBOSE — bkz. Loglama), sarmalanan hata konsola yazdırılır ve genellikle asıl nedeni ortaya koyar.
Bu çözümler sorununuzu gidermezse, destek ekibiyle iletişime geçmeden önce atmanız gereken adımlar için Diğer sorunlar bölümüne bakın; bu sayede size daha verimli yardım edebiliriz.
| Hata | Çözüm |
|---|---|
| UNKNOWN | Bu hata, bilinmeyen veya beklenmedik bir hata oluştuğunu gösterir. |
| ITEM_UNAVAILABLE | Bu hata çoğunlukla test aşamasında ortaya çıkar. Ürünlerin production’da bulunmadığı ya da kullanıcının Google Play’deki Testers grubuna dahil olmadığı anlamına gelebilir. |
| ADAPTY_NOT_INITIALIZED | Adapty SDK etkinleştirilmemiş. En sık, splash screen veya erken çalışan bir UI bileşeninin Adapty.activate tamamlanmadan önce Adapty metodlarını çağırmasından kaynaklanır. Gerçek cihaz zamanlaması emülatörden farklı olduğu için bu sorun aralıklı olarak ortaya çıkabilir ve emülatörde yeniden üretilmeyebilir. Başka SDK çağrılarını planlamadan önce Adapty.activate tamamlanmasını bekleyin. Tam sıra için Android SDK’da çağrı sırası konusuna bakın. Ayrıca Adapty.activate metoduyla Adapty SDK’yı doğru şekilde yapılandırmanız gerekir. |
| PROFILE_WAS_CHANGED | İşlem sırasında kullanıcı profili değiştirildi. Bu durum, Adapty.identify hâlâ devam ederken başka bir metod çağrıldığında yaşanır; devam eden çağrı değiştirilmek üzere olan bir profile denk gelir ve SDK onu reddeder. Diğer SDK çağrılarını planlamadan önce Adapty.identify tamamlanmasını bekleyin. Bkz. Android SDK’da çağrı sırası. |
| PRODUCT_NOT_FOUND | Bu hata, satın alınmak istenen ürünün mağazada mevcut olmadığını gösterir. |
| INVALID_JSON | Yerel yedek paywall JSON’ı geçerli değil. Önce varsayılan İngilizce paywallınızı düzeltin, ardından geçersiz yerel paywallları değiştirin. Bir paywallın nasıl düzeltileceğine dair ayrıntılar için Paywall’ı remote config ile özelleştirme konusuna, yerel paywallların nasıl değiştirileceğine dair ayrıntılar için ise Yerel yedek paywallları tanımlama konusuna bakın. |
CURRENT_SUBSCRIPTION_TO_UPDATE _NOT_FOUND_IN_HISTORY | Değiştirilmesi gereken orijinal abonelik, aktif abonelikler arasında bulunamadı. |
| BILLING_SERVICE_TIMEOUT | Bu hata, Google Play yanıt veremeden isteğin maksimum zaman aşımına ulaştığını gösterir. Örneğin, Play Billing Library çağrısının talep ettiği işlemin gecikmesinden kaynaklanabilir. |
| FEATURE_NOT_SUPPORTED | İstenen özellik, mevcut cihazda Play Store tarafından desteklenmiyor. |
| BILLING_SERVICE_DISCONNECTED | Bu hata, istemci uygulamanın BillingClient aracılığıyla Google Play Store hizmetiyle kurduğu bağlantının kesildiğini gösterir. |
| BILLING_SERVICE_UNAVAILABLE | Bu hata, Google Play Billing hizmetinin şu anda kullanılamaz durumda olduğunu gösterir. Çoğu durumda bu, istemci cihaz ile Google Play Billing hizmetleri arasındaki bir noktada ağ bağlantısı sorunu olduğu anlamına gelir. |
| BILLING_UNAVAILABLE | Bu hata, satın alma işlemi sırasında bir faturalandırma sorunu oluştuğunu gösterir. Olası nedenler şunlardır: 1. Kullanıcının cihazındaki Play Store uygulaması eksik veya güncel değil. 2. Kullanıcı desteklenmeyen bir ülkede. 3. Kullanıcı, yöneticinin satın almaları devre dışı bıraktığı bir kurumsal hesabın parçası. 4. Google Play, kullanıcının ödeme yöntemini tahsil edemedi (örneğin süresi dolmuş bir kredi kartı). 5. Kullanıcı Play Store uygulamasında oturum açmamış. |
| DEVELOPER_ERROR | Bu hata, bir API’nin hatalı kullanıldığını gösterir. |
| BILLING_ERROR | Bu hata, Google Play’in kendi içinde bir sorun olduğunu gösterir. |
| ITEM_ALREADY_OWNED | Ürün zaten satın alınmış. |
| ITEM_NOT_OWNED | Bu hata, kullanıcının ürüne sahip olmadığı için istenen işlemin gerçekleştirilemediğini gösterir. |
| BILLING_NETWORK_ERROR | Bu hata, cihaz ile Play sistemleri arasındaki ağ bağlantısında bir sorun olduğunu gösterir. |
| NO_PRODUCT_IDS_FOUND | Bu hata, paywallda yer alan ürünlerin hiçbirinin mağazada mevcut olmadığını gösterir. Bu hatayla karşılaşıyorsanız sorunu çözmek için aşağıdaki adımları izleyin:
|
| NO_PURCHASES_TO_RESTORE | Bu hata, Google Play’in geri yüklenecek satın alma işlemi bulamadığını gösterir. |
| AUTHENTICATION_ERROR | Adapty.activate metoduyla Adapty SDK’yı doğru şekilde yapılandırmanız gerekiyor. |
| BAD_REQUEST | Hatalı istek. Google Play ile entegrasyon için gerekli tüm adımları tamamladığınızdan emin olun. |
| SERVER_ERROR | Sunucu hatası. |
| REQUEST_FAILED | Bu hata, düzgün tanımlanamayan bir ağ sorununu gösterir. |
| DECODING_FAILED | Yanıt çözümlenemedi. Kodunuzu gözden geçirin ve gönderdiğiniz parametrelerin geçerli olduğundan emin olun. Örneğin bu hata, geçersiz bir API anahtarı kullandığınıza işaret edebilir. |
| ANALYTICS_DISABLED | Devre dışı bıraktığınız için analytics etkinliklerini işleyemiyoruz. |
| WRONG_PARAMETER | Bu hata, bazı parametrelerinizin hatalı olduğunu gösterir: boş olamayacak bir alan boş bırakılmış ya da yanlış tür kullanılmış vb. |
Diğer sorunlar
Henüz bir çözüm bulamadıysanız, sonraki adımlar şunlar olabilir:
- SDK’yı en son sürüme yükseltme: En son SDK sürümleri daha kararlıdır ve bilinen sorunlara yönelik düzeltmeler içerir; bu nedenle her zaman güncellemenizi öneririz.
- Destek ekibiyle iletişime geçin veya diğer geliştiricilerden yardım alın destek forumunda.
- Destek ekibiyle [email protected] adresinden veya sohbet üzerinden iletişime geçin: SDK’yı yükseltmeye hazır değilseniz ya da yükseltme sorunu çözmediyse destek ekibimize ulaşın. Ayrıntılı günlük kaydını etkinleştirip günlükleri ekiple paylaşırsanız sorununuz daha hızlı çözülür. İlgili kod parçacıklarını da ekleyebilirsiniz.