ÿÿ HÆ°á»›ng dẫn migration lên Flutter Adapty SDK 3.10.0
English 中文TürkçeРуÑÑкийEspañol日本語Tiếng Việt

Hướng dẫn migration lên Flutter Adapty SDK 3.10.0

Adapty SDK 3.10.0 là một bản phát hành lớn mang lại một số cải tiến, tuy nhiên có thể yêu cầu bạn thực hiện một số bước migration:

  1. Cập nhật phương thức makePurchase để sử dụng AdaptyPurchaseParameters thay vì các tham số riêng lẻ.
  2. Thay thế vendorProductIds bằng productIdentifiers trong model AdaptyPaywall.

Cập nhật phương thức makePurchase

PhÆ°Æ¡ng thức makePurchase hiện sá»­ dụng AdaptyPurchaseParameters thay vì các đối số subscriptionUpdateParams và isOfferPersonalized riêng lẻ. Äiá»u này giúp đảm bảo kiểu dữ liệu an toàn hÆ¡n và cho phép mở rá»™ng các tham số mua hàng trong tÆ°Æ¡ng lai.

- 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(),
+ );

Nếu không cần thêm tham số nào, bạn có thể sử dụng đơn giản như sau:

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

Cập nhật cách sử dụng model AdaptyPaywall

Thuộc tính vendorProductIds đã bị deprecated và được thay thế bằng productIdentifiers. Thuộc tính mới trả vỠcác đối tượng AdaptyProductIdentifier thay vì chuỗi đơn giản, cung cấp thông tin sản phẩm có cấu trúc hơn.

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

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

Äối tượng AdaptyProductIdentifier cung cấp quyá»n truy cập vào vendor product ID thông qua thuá»™c tính vendorProductId, giữ nguyên chức năng nhÆ° cÅ© trong khi cung cấp cấu trúc tốt hÆ¡n cho các cải tiến trong tÆ°Æ¡ng lai.

Tương thích ngược

Cả hai thay đổi Ä‘á»u duy trì tÆ°Æ¡ng thích ngược:

  • Các tham số cÅ© trong makePurchase đã bị deprecated nhÆ°ng vẫn hoạt Ä‘á»™ng bình thÆ°á»ng
  • Thuá»™c tính vendorProductIds đã bị deprecated nhÆ°ng vẫn có thể truy cập được
  • Code hiện tại sẽ tiếp tục hoạt Ä‘á»™ng, mặc dù bạn sẽ thấy các cảnh báo deprecation

Chúng tôi khuyến nghị cập nhật code của bạn để sử dụng các API mới nhằm đảm bảo khả năng tương thích trong tương lai và tận dụng tính an toàn kiểu dữ liệu và khả năng mở rộng được cải thiện.

ÿÿÿÿ