Flutter Adapty SDK 3.10.0 için Geçiş Rehberi

Adapty SDK 3.10.0, bazı geliştirmeler içeren büyük bir sürümdür. Bu değişiklikler için aşağıdaki geçiş adımlarını uygulamanız gerekebilir:

  1. makePurchase metodunu, tek tek parametreler yerine AdaptyPurchaseParameters kullanacak şekilde güncelleyin.
  2. AdaptyPaywall modelinde vendorProductIds yerine productIdentifiers kullanın.

makePurchase metodunu güncelleyin

makePurchase metodu artık ayrı ayrı subscriptionUpdateParams ve isOfferPersonalized argümanları yerine AdaptyPurchaseParameters kullanıyor. Bu değişiklik daha iyi tip güvenliği sağlar ve satın alma parametrelerinin gelecekte genişletilmesine olanak tanır.

- final purchaseResult = await adapty.makePurchase(
-   product: product,
-   subscriptionUpdateParams: subscriptionUpdateParams,
-   isOfferPersonalized: true,
- );

+ final parameters = AdaptyPurchaseParametersBuilder()
+   ..setSubscriptionUpdateParams(subscriptionUpdateParams)
+   ..setIsOfferPersonalized(true)
+   ..setObfuscatedAccountId('your-account-id')
+   ..setObfuscatedProfileId('your-profile-id');

+ final purchaseResult = await adapty.makePurchase(
+   product: product,
+   parameters: parameters.build(),
+ );

Ek parametreye ihtiyaç duymuyorsanız şu şekilde kullanabilirsiniz:

final purchaseResult = await adapty.makePurchase(
  product: product,
);

AdaptyPaywall model kullanımını güncelleyin

vendorProductIds özelliği kullanımdan kaldırılmış olup yerini productIdentifiers almıştır. Yeni özellik, düz string’ler yerine AdaptyProductIdentifier nesneleri döndürerek daha yapılandırılmış ürün bilgisi sunar.

- paywall.vendorProductIds.map((vendorId) => 
-   ListTextTile(title: vendorId)
- ).toList()

+ paywall.productIdentifiers.map((productId) => 
+   ListTextTile(title: productId.vendorProductId)
+ ).toList()

AdaptyProductIdentifier nesnesi, vendorProductId özelliği aracılığıyla vendor ürün kimliğine erişim sağlar; mevcut işlevselliği korurken gelecekteki geliştirmeler için daha iyi bir yapı sunar.

Geriye dönük uyumluluk

Her iki değişiklik de geriye dönük uyumluluğu korumaktadır:

  • makePurchase içindeki eski parametreler kullanımdan kaldırılmış olsa da çalışmaya devam eder
  • vendorProductIds özelliği kullanımdan kaldırılmış olsa da erişilebilir olmaya devam eder
  • Mevcut kodunuz çalışmaya devam eder; ancak deprecation uyarıları göreceksiniz

Gelecekteki uyumluluğu sağlamak ve geliştirilmiş tip güvenliği ile genişletilebilirlikten yararlanmak için kodunuzu yeni API’leri kullanacak şekilde güncellemenizi öneririz.