7 veya 8 sürümlerinden Google Play Faturalandırma Kitaplığı 9'a geçiş yapma

Bu belgede, Google Play Faturalandırma Kitaplığı (PBL) 7 veya 8'den PBL 9'a nasıl geçiş yapılacağı ve yeni özelliklerin nasıl entegre edileceği açıklanmaktadır.

9.0.0 sürümündeki değişikliklerin tam listesi için sürüm notlarına bakın.

Genel Bakış

PBL 9, mevcut API'lerde yapılan iyileştirmelerin yanı sıra daha önce desteği sonlandırılan API'lerin kaldırılmasını içerir. Kitaplığın bu sürümü, yeni alt yanıt kodları aracılığıyla daha zengin hata bağlamı da sunar.

PBL yükseltmesi için geriye dönük uyumluluk

PBL 9'a geçmek için sürüm notlarında ve bu geçiş rehberinin ilerleyen bölümlerinde açıklandığı gibi, mevcut API referanslarınızdan bazılarını uygulamanızdan güncellemeniz veya kaldırmanız gerekir.

PBL 7 veya 8'den PBL 9'a yükseltme

PBL 7 veya 8'den PBL 9'a yükseltmek için aşağıdaki adımları uygulayın:

  1. Uygulamanızın build.gradle dosyasında Google Play Faturalandırma Kitaplığı bağımlılık sürümünü güncelleyin.

    dependencies {
      def billing_version = "9.1.0"
      implementation "com.android.billingclient:billing:$billing_version"
    }
    

    Kotlin kullanıyorsanız Google Play Faturalandırma Kitaplığı KTX modülü, Google Play Faturalandırma Kitaplığı'nı kullanırken deyimsel Kotlin yazmanıza olanak tanıyan Kotlin uzantıları ve eş yordam desteği içerir. Bu uzantıları projenize dahil etmek için uygulamanızın build.gradle dosyasına aşağıdaki bağımlılığı ekleyin:

    dependencies {
      val billing_version = "9.1.0"
      implementation("com.android.billingclient:billing-ktx:$billing_version")
    }
    
  2. (Yalnızca PBL 7'den PBL 9'a yükseltme için geçerlidir). queryProductDetailsAsync yönteminin uygulamasını güncelleyin.

    ProductDetailsResponseListener.onProductDetailsResponse yönteminin imzasında bir değişiklik yapıldı. Bu nedenle, queryProductDetailsAsync uygulamasında değişiklik yapmanız gerekir. Daha fazla bilgi için Ürün stok durumunu gösterme başlıklı makaleyi inceleyin.

  3. Kaldırılan API'leri yönetme

    Aşağıdaki tabloda, kaldırılan API'ler ve uygulamanızda kullanmanız gereken alternatif API'ler listelenmiştir.

    Yükseltme kaynağı

    PBL 9, aşağıdaki tabloda listelenen API'leri artık desteklemiyor. Uygulamanızda bu kaldırılan API'lerden herhangi biri kullanılıyorsa karşılık gelen alternatif API'ler için tabloya bakın.

    Daha önce desteği sonlandırılan API kaldırıldı Kullanılacak alternatif API
    queryPurchaseHistoryAsync API'leri İşlem Geçmişini Sorgulama bölümüne bakın. Ücretsiz denemeler için uygunluğu belirlemek üzere queryPurchaseHistoryAsync yöntemini kullanıyorsanız artık kullanıcının hangi teklifler için uygun olduğunu belirlemek üzere ProductDetails.getSubscriptionOfferDetails() yöntemini kullanmanız gerekir.
    BillingClient.SkuType BillingClient.ProductType. INAPP ve SUBS ürün türü sabitleri, desteği sonlandırılan SKU türü sabitleriyle işlevsel olarak benzerdir.
    SkuDetails ProductDetails. Bu, tek seferlik ürünleri destekleyen yeni veri modelidir.
    SkuDetailsParams queryProductDetailsAsync ile QueryProductDetailsParams kullanın.
    SkuDetailsResponseListener queryProductDetailsAsync ile ProductDetailsResponseListener'ı kullanın.
    QueryPurchaseHistoryParams
    • Etkin veya bekleyen satın alma işlemleri için queryPurchasesAsync yöntemini kullanın.
    • Tüketilen satın alma işlemlerini arka uç sunucularınızda takip edin.
    • İptal edilen veya geçersiz kılınan satın alma işlemleri için sunucu tarafı Voided Purchases API'yi kullanın.
    getSkuDetailsList ve setSkuDetailsList BillingFlowParams.Builder.setProductDetailsParamsList kullanın.
    querySkuDetailsAsync queryProductDetailsAsync
    enablePendingPurchases() (Parametresiz API) enablePendingPurchases(PendingPurchasesParams params)
    Desteği sonlandırılan enablePendingPurchases() yönteminin işlevsel olarak enablePendingPurchases(PendingPurchasesParams.newBuilder().enableOneTimeProducts().build()) ile eşdeğer olduğunu unutmayın.
    queryPurchasesAsync(String skuType, PurchasesResponseListener listener) queryPurchasesAsync

    Yükseltme kaynağı

    Aşağıdaki tabloda, PBL 9'da kaldırılan API'ler ve uygulamanızda kullanmanız gereken alternatif API'ler listelenmiştir.

    Daha önce desteği sonlandırılan API kaldırıldı Kullanılacak alternatif API
    BillingClient.SkuType BillingClient.ProductType. INAPP ve SUBS ürün türü sabitleri, desteği sonlandırılan SKU türü sabitleriyle işlevsel olarak benzerdir.
    SkuDetails ProductDetails. Bu, tek seferlik ürünleri destekleyen yeni veri modelidir.
    SkuDetailsParams queryProductDetailsAsync ile QueryProductDetailsParams kullanın.
    SkuDetailsResponseListener queryProductDetailsAsync ile ProductDetailsResponseListener'ı kullanın.
    QueryPurchaseHistoryParams
    • Etkin veya bekleyen satın alma işlemleri için queryProductDetailsAsync yöntemini kullanın.
    • Tüketilen satın alma işlemlerini arka uç sunucularınızda takip edin.
    • İptal edilen veya geçersiz kılınan satın alma işlemleri için sunucu tarafı Voided Purchases API'yi kullanın.
    getSkuDetailsList ve setSkuDetailsList BillingFlowParams.Builder.setProductDetailsParamsList kullanın.

  4. (Önerilir) Otomatik hizmet yeniden bağlantısını etkinleştirin.

    Play Faturalandırma Kitaplığı, hizmet bağlantısı kesikken bir API çağrısı yapılırsa hizmet bağlantısını otomatik olarak yeniden kurmaya çalışabilir. Daha fazla bilgi için Otomatik hizmet yeniden bağlantısını etkinleştirme başlıklı makaleyi inceleyin.

  5. Yeni alt yanıt kodlarını işleme

    launchBillingFlow() tarafından döndürülen BillingResult artık bir alt yanıt kodu alanı içerecek. Bu alan, yalnızca bazı durumlarda hatanın daha ayrıntılı nedenini belirtmek için doldurulur. Alt yanıt alanı aşağıdaki değerleri içerebilir:

    • PAYMENT_DECLINED_DUE_TO_INSUFFICIENT_FUNDS: Kullanıcının bakiyesi, satın almaya çalıştığı öğenin fiyatından düşük olduğunda döndürülür.
    • USER_INELIGIBLE: Kullanıcı, bir abonelik teklifi için yapılandırılmış uygunluk koşullarını karşılamadığında döndürülür.
    • NO_APPLICABLE_SUB_RESPONSE_CODE: Başka bir alt yanıt kodu geçerli olmadığında döndürülen varsayılan değer.

    Taşıma adımı: Daha iyi bir kullanıcı deneyimi sunmak için PurchasesUpdatedListener veya eşdeğer sonuç işleme kodunuzu, bu belirli alt yanıt kodlarını tanıyıp yanıtlayacak şekilde güncelleyin. Örneğin, kullanıcıdan ödeme yöntemlerini düzeltmesini isteyin veya belirli bir hata mesajı gösterin.

  6. Hata kodu yeniden sınıflandırma farkındalığı.

    Play Store uygulamasının sistem tarafından engellendiği durumlarda (ör. OEM tarafından özelleştirilmiş çocuk modunda), PBL'den gelen yanıt kodu ERROR yerine BILLING_UNAVAILABLE olarak değiştirildi.

    Taşıma adımı: Hata işleme mantığınızın bu değişikliğe uyum sağladığından ve bu belirli senaryolarda genel bir hata almayı beklemediğinden emin olun.

  7. DeveloperProvidedBillingDetails.getLinkUri() null değer alabilme özelliğini işleyin.

    Harici ödeme entegrasyonu kapsamında DeveloperProvidedBillingDetails kullanıyorsanız getLinkUri() artık @Nullable olarak adlandırılıyor.

    Taşıma adımı: Bu değişikliği güvenli bir şekilde yönetmek için entegrasyon kodunuzun, tarayıcı intent'lerini ayrıştırmadan veya başlatmadan önce DeveloperProvidedBillingDetails.getLinkUri() yönteminden gelen hem null hem de boş dize ("") değerlerini işlediğinden emin olun. Örneğin:

    Kotlin

    Java

    String linkUri = details.getLinkUri();
    if (!android.text.TextUtils.isEmpty(linkUri)) {
      Intent intent = new Intent(Intent.ACTION_VIEW, Uri.parse(linkUri));
      context.startActivity(intent);
    }
    
  8. İsteğe bağlı değişiklikler.