Flutter SDK'da hataları yönetme

SDK tarafından döndürülen her hata AdaptyErrorCode türündedir. İşte bir örnek:

Tip

Hata ayıklamadan önce ayrıntılı günlükleri etkinleştirin. Çoğu AdaptyError, temelinde bir StoreKit, Play Billing, ağ veya backend hatası barındırır. Ayrıntılı günlükler açıkken (await Adapty().setLogLevel(AdaptyLogLevel.verbose) — bkz. Loglama), sarmalanmış hata konsola yazdırılır ve genellikle asıl nedeni ortaya koyar.

Important

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; böylece size daha verimli yardım sunabiliriz.

    try {
      final result = await adapty.makePurchase(product: product);
    } on AdaptyError catch (adaptyError) {
      if (adaptyError.code == AdaptyErrorCode.paymentCancelled) {
        // Cancelled
      }
    } catch (e) {
    }

System StoreKit kodları

HataKodÇözüm
unknown0Bilinmeyen veya beklenmedik bir hata oluştuğunu belirten hata kodu.
Yeniden deneyin veya Diğer sorunlar bölümüne bakın.
clientInvalid1İstemcinin gerçekleştirmeye çalıştığı işleme izin verilmediğini belirten hata kodu.
paymentCancelled2

Kullanıcının ödeme isteğini iptal ettiğini belirten hata kodu.

Herhangi bir işlem yapmanıza gerek yok; ancak iş mantığı açısından kullanıcıya indirim teklif edebilir ya da daha sonra hatırlatabilirsiniz.

paymentInvalid3Ödeme parametrelerinden birinin App Store tarafından tanınmadığını belirten hata kodu.
paymentNotAllowed4Kullanıcının ödeme yapmaya yetkili olmadığını belirten hata kodu.
storeProductNotAvailable5İstenen ürünün mağazada mevcut olmadığını belirten hata kodu.
Uygulamayı yeniden yüklemeyi deneyin.
cloudServicePermissionDenied6Kullanıcının bulut hizmeti bilgilerine erişime izin vermediğini belirten hata kodu.
cloudServiceNetworkConnectionFailed7Cihazın ağa bağlanamadığını belirten hata kodu.
cloudServiceRevoked8Kullanıcının bu bulut hizmetini kullanma iznini iptal ettiğini belirten hata kodu.
privacyAcknowledgementRequired9Kullanıcının Apple’ın gizlilik politikasını henüz onaylamadığını belirten hata kodu.
unauthorizedRequestData10Uygulamanın gerekli yetkiye sahip olmadığı bir özelliği kullanmaya çalıştığını belirten hata kodu.
invalidOfferIdentifier11

identifier teklif kimliği geçerli değil. Örneğin, App Store’da bu kimlikle bir teklif oluşturmamış ya da teklifi iptal etmiş olabilirsiniz.

İstediğiniz teklifleri AppStore Connect’te oluşturduğunuzdan ve geçerli bir teklif kimliği ilettiğinizden emin olun.

invalidSignature12Ödeme indirimindeki imzanın geçerli olmadığını belirten hata kodu.
missingOfferParams13Ödeme indiriminde parametrelerin eksik olduğunu belirten hata kodu.
invalidOfferPrice14App Store Connect’te belirttiğiniz fiyatın artık geçerli olmadığını belirten hata kodu. Teklifler her zaman indirimli bir fiyatı temsil etmelidir.

Özel Android kodları

HataKodÇözüm
adaptyNotInitialized20Adapty SDK’yı Adapty.activate metoduyla düzgün şekilde yapılandırmanız gerekiyor. Nasıl yapılacağını öğrenmek için Flutter için konusuna bakabilirsiniz.
productNotFound22Bu hata, satın alınmak istenen ürünün mağazada mevcut olmadığını gösterir.
invalidJson23Paywall JSON’ı geçerli değil. Adapty Kontrol Paneli’nde düzeltin. Nasıl düzelteceğinizi öğrenmek için Paywall’u remote config ile özelleştirme konusuna bakın.
currentSubscriptionToUpdateNotFoundInHistory24Yenilenmesi gereken orijinal abonelik geçmişte bulunamadı.
pendingPurchase25Bu hata, satın alma durumunun tamamlandı yerine beklemede olduğunu gösterir. Ayrıntılar için Android Geliştirici belgelerindeki Bekleyen işlemleri yönetme sayfasına bakın.
billingServiceTimeout97Bu hata, Google Play yanıt veremeden önce isteğin maksimum zaman aşımına ulaştığını gösterir. Bu durum, örneğin Play Billing Library çağrısının istediği eylemin gecikmeli yürütülmesinden kaynaklanabilir.
featureNotSupported98İstenen özellik, mevcut cihazda Play Store tarafından desteklenmiyor.
billingServiceDisconnected99Bu kritik hata, istemci uygulamanın BillingClient aracılığıyla Google Play Store hizmetiyle kurduğu bağlantının kesildiğini gösterir.
billingServiceUnavailable102Bu geçici 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ında bir ağ bağlantısı sorunu olduğu anlamına gelir.
billingUnavailable103

Bu hata, satın alma sürecinde kullanıcı kaynaklı bir faturalandırma hatası oluştuğunu gösterir. Bu durumun yaşanabileceği örnekler şunlardır:

1. Kullanıcının cihazındaki Play Store uygulaması güncel değil.

2. Kullanıcı desteklenmeyen bir ülkede.

3. Kullanıcı bir kurumsal hesap kullanıcısı ve kurumsal yöneticisi satın alma işlemlerini devre dışı bırakmış.

4. Google Play, kullanıcının ödeme yöntemini tahsil edemiyor. Örneğin, kullanıcının kredi kartının süresi dolmuş olabilir.

5. Kullanıcı Play Store uygulamasında oturum açmamış.

developerError105Bu, bir API’yi hatalı kullandığınızı gösteren kritik bir hatadır.
billingError106Bu, Google Play’in kendi iç sorununu gösteren kritik bir hatadır.
itemAlreadyOwned107Consumable ürün zaten satın alınmış.
itemNotOwned108Bu hata, öğe üzerinde istenen işlemin başarısız olduğunu gösterir sin

Özel StoreKit kodları

HataKodÇözüm
noProductIDsFound1000

Bu hata, paywall’da talep ettiğiniz ürünlerin hiçbirinin App Store’da listelenmesine rağmen satın alma için mevcut olmadığını gösterir. Bu hata bazen bir InvalidProductIdentifiers uyarısıyla birlikte gelebilir. Uyarı hatasız görünüyorsa yoksayın.

Bu hatayla karşılaşıyorsanız Kod-1000 noProductIDsFound hatası için Düzeltme bölümündeki adımları izleyin.

productRequestFailed1002Şu anda mevcut ürünler alınamıyor.
cantMakePayments1003Bu cihazda uygulama içi satın almalar izin verilmiyor. Sorun giderme kılavuzuna bakın.
noPurchasesToRestore1004Adapty Flutter SDK 4.0.4’te kullanımdan kaldırıldı: restorePurchases() artık bu hatayı döndürmüyor. Geri yüklenecek bir şey olmadığında, yöntem mevcut profille başarıyla tamamlanır; bu nedenle içindeki access level durumunu kontrol edin. Daha eski SDK sürümlerinde bu hata, Google Play’in geri yüklenecek satın almayı bulamadığını gösterir.
cantReadReceipt1005

Cihazda geçerli bir makbuz mevcut değil. Bu durum sandbox testleri sırasında sorun oluşturabilir.

Sandbox ortamında, gerçekten bir satın alma yapana kadar geçerli bir makbuz dosyanız olmayacaktır; bu nedenle erişmeden önce bir satın alma yaptığınızdan emin olun. Sandbox testleri sırasında ayrıca cihazda geçerli bir Apple sandbox hesabıyla oturum açtığınızdan emin olun.

productPurchaseFailed1006Ürün satın alımı başarısız oldu. Bu hata, temel bir StoreKit hatasını sarmalamaktadır — gerçek nedeni görmek için sarmalanan hatayı okuyun (veya konsolda görmek için ayrıntılı günlükleri etkinleştirin). Sarmalanan hata genellikle yukarıdaki tablodaki StoreKit kodlarından 0–14 arasında biridir; en yaygın olanları paymentCancelled, paymentInvalid, paymentNotAllowed veya invalidOfferPrice’tır. Belirli bir neden tespit edemiyorsanız yeni bir sandbox profili deneyin; sorun devam ediyorsa Apple desteğiyle iletişime geçin.
refreshReceiptFailed1010Bu hata, makbuzun alınmadığını gösterir. Yalnızca StoreKit 1 için geçerlidir.
receiveRestoredTransactionsFailed1011Satın alma geri yükleme işlemi başarısız oldu.
billingPlanUnavailable1060Yalnızca iOS. Ürün, bu cihazda veya bu mağazada talep edilen faturalandırma planını sunmuyor. 12 aylık taahhüt planı iOS 26.4 veya sonrasını ve Xcode 26.5 veya sonrasıyla derlenmiş bir uygulama gerektirir. SDK 4.3.0 veya sonrasını gerektirir.

Özel ağ kodları

HataKodÇözüm
notActivated2002Adapty SDK etkinleştirilmemiş.
En sık, bir açılış ekranı veya erken bir UI kancası Adapty().activate dönmeden önce Adapty yöntemlerini çağırdığında görülür. Belirti aralıklıdır ve gerçek cihaz zamanlaması farklı olduğundan emülatörde yeniden üretilemeyebilir. Diğer SDK çağrılarını planlamadan önce activate Future’ı await ile bekleyin. Tam sıra için Flutter SDK’da çağrı sırası bölümüne bakın.
badRequest2003Hatalı istek.
App Store ile entegrasyon için gereken tüm adımları tamamladığınızdan emin olun.
serverError2004Sunucu hatası.
Bir süre sonra tekrar deneyin. Sorun çözülmezse Adapty destek ekibiyle iletişime geçin.
networkFailed2005Bu hata, kullanıcının cihazında ağ bağlantısıyla ilgili sorunlar olduğunu gösterir.
VPN’i devre dışı bırakmayı veya mobil ağdan WiFi’ye ya da tam tersine geçmeyi deneyin.
decodingFailed2006Bu hata, yanıt kodunun çözülmesinin başarısız olduğunu gösterir.
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ızı gösterebilir.
encodingFailed2009Bu hata, istek kodlamasının başarısız olduğunu gösterir.
analyticsDisabled3000Devre dışı bıraktığınız için analitik olaylarını işleyemiyoruz.
wrongParam3001Bu hata, bazı parametrelerinizin doğru olmadığını gösterir.
Adapty paywall builder kullanıyorsanız ve bu hata nedeniyle paywall görüntüleyemiyorsanız, paywall builder’da Show on device seçeneğini açın.
Bu sorunun bir diğer olası nedeni, yerel yedek dosya sürümünün SDK sürümüyle eşleşmemesidir. Kontrol panelinden yeni bir dosya indirin.
activateOnceError3005.activate yöntemini birden fazla kez çağırmak mümkün değildir.
profileWasChanged3006İşlem sırasında kullanıcı profili değiştirildi.
Bu durum, Adapty().identify hâlâ devam ederken bir yöntem çağrıldığında gerçekleşir — devam eden çağrı, değiştirilmek üzere olan bir profile düşer ve SDK bunu reddeder. Kullanıcı eylemiyle ilgili her çağrıdan önce identify’ı await ile bekleyin. Bkz. Flutter SDK’da çağrı sırası.
unsupportedData3007Bu hata, veri formatının SDK tarafından desteklenmediğini gösterir.
fetchTimeoutError3101Bu hata, getirme işleminin zaman aşımına uğradığını gösterir.
operationInProgress3201Yalnızca iOS. Unity’de OperationInProgress. Aynı türden başka bir işlem hâlâ çalışıyor.
Önceki bir çağrı mağaza mesajlarını göstermeye devam ederken showStoreMessages tarafından döndürülür: bkz. Flutter, React Native veya Unity. İşlem tamamlanana kadar bekleyin, ardından tekrar deneyin. SDK 4.3.0 veya üstü gerektirir.
resolverFailure3202Yalnızca iOS. Unity’de ResolverFailure. SDK, işlemin ihtiyaç duyduğu kaynağı bulamadı.
Ön planda etkin pencere sahnesi olmadığında showStoreMessages tarafından döndürülür. Uygulama ön plandayken yöntemi tekrar çağırın. SDK 4.3.0 veya üstü gerektirir.

Özel Kullanıcı Arayüzü ve Eklenti Kodları

HataKodÇözüm
jsException4105Builder ile oluşturulan bir paywall veya onboarding çalışırken JavaScript’ten bir istisna fırlatıldı. Temel JavaScript hatasını görmek için ayrıntılı günlüğü etkinleştirin.
operationInterrupted9000Bu işlem sistem tarafından kesintiye uğratıldı.
Çağrıyı yeniden deneyin.
emptyResult10001Flutter eklentisi, yerel SDK’dan boş bir sonuç aldı.
Çağrıyı yeniden deneyin; ardından Diğer sorunlar bölümüne bakın.
internalPluginError10002Flutter eklentisinde dahili bir hata oluştu.
Diğer sorunlar bölümüne bakın.

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ümlerine yükseltmenizi her zaman öneririz; bu sürümler daha kararlıdır ve bilinen sorunlar için düzeltmeler içerir.
  • Destek ekibiyle iletişime geçin veya diğer geliştiricilerden yardım alın destek forumunda.
  • Destek ekibiyle support@adapty.io adresinden veya sohbet yoluyla iletişime geçin: SDK’yı yükseltmeye hazır değilseniz veya bu işlem sorunu çözmediyse destek ekibimizle iletişime geçin. Ayrıntılı günlük kaydını etkinleştirip günlükleri ekiple paylaşırsanız sorununuz daha hızlı çözülecektir. İlgili kod parçacıklarını da ekleyebilirsiniz.