XỠlý lỗi trong Flutter SDK
Má»i lá»—i được trả vá» bởi SDK Ä‘á»u là AdaptyErrorCode. DÆ°á»›i đây là má»™t và dụ:
Báºt verbose logs trÆ°á»›c khi debug. Hầu hết các AdaptyError Ä‘á»u bao gồm má»™t lá»—i gốc từ StoreKit, Play Billing, mạng, hoặc backend. Khi báºt verbose logs (await Adapty().setLogLevel(AdaptyLogLevel.verbose) — xem Logging), lá»—i gốc đó sẽ được in ra console, thÆ°á»ng cho biết nguyên nhân thá»±c sá»±.
Nếu các giải pháp nà y không khắc phục được vấn Ä‘á» của bạn, hãy xem Các vấn Ä‘á» khác để biết các bÆ°á»›c cần thá»±c hiện trÆ°á»›c khi liên hệ bá»™ pháºn há»— trợ, giúp chúng tôi há»— trợ bạn hiệu quả hÆ¡n.
try {
final result = await adapty.makePurchase(product: product);
} on AdaptyError catch (adaptyError) {
if (adaptyError.code == AdaptyErrorCode.paymentCancelled) {
// Cancelled
}
} catch (e) {
}Mã StoreKit hệ thống
| Lỗi | Mã | Giải pháp |
|---|---|---|
| unknown | 0 | Mã lỗi cho biết đã xảy ra lỗi không xác định hoặc không mong đợi. ThỠlại hoặc xem phần Các vấn đỠkhác. |
| clientInvalid | 1 | Mã lá»—i nà y cho biết client không được phép thá»±c hiện hà nh Ä‘á»™ng đã thá». |
| paymentCancelled | 2 | Mã lá»—i nà y cho biết ngÆ°á»i dùng đã hủy yêu cầu thanh toán. Không cần thá»±c hiện hà nh Ä‘á»™ng nà o, nhÆ°ng vá» mặt logic nghiệp vụ, bạn có thể Ä‘á» nghị giảm giá cho ngÆ°á»i dùng hoặc nhắc nhở há» sau. |
| paymentInvalid | 3 | Lá»—i nà y cho biết má»™t trong các tham số thanh toán không được App Store nháºn dạng. |
| paymentNotAllowed | 4 | Mã lá»—i nà y cho biết ngÆ°á»i dùng không được phép xác thá»±c thanh toán. |
| storeProductNotAvailable | 5 | Mã lá»—i nà y cho biết sản phẩm được yêu cầu không có sẵn trong cá»a hà ng. Thá» cà i đặt lại ứng dụng. |
| cloudServicePermissionDenied | 6 | Mã lá»—i nà y cho biết ngÆ°á»i dùng chÆ°a cho phép truy cáºp thông tin dịch vụ Cloud. |
| cloudServiceNetworkConnectionFailed | 7 | Mã lỗi nà y cho biết thiết bị không thể kết nối mạng. |
| cloudServiceRevoked | 8 | Mã lá»—i nà y cho biết ngÆ°á»i dùng đã thu hồi quyá»n sá» dụng dịch vụ cloud nà y. |
| privacyAcknowledgementRequired | 9 | Mã lá»—i nà y cho biết ngÆ°á»i dùng chÆ°a xác nháºn chÃnh sách quyá»n riêng tÆ° của Apple. |
| unauthorizedRequestData | 10 | Mã lá»—i nà y cho biết ứng dụng Ä‘ang cố sá» dụng má»™t thuá»™c tÃnh mà nó không có quyá»n truy cáºp cần thiết. |
| invalidOfferIdentifier | 11 |
Hãy đảm bảo bạn đã thiết láºp các Æ°u đãi mong muốn trong AppStore Connect và truyá»n má»™t identifier Æ°u đãi hợp lệ. |
| invalidSignature | 12 | Mã lỗi nà y cho biết chữ ký trong payment discount không hợp lệ. |
| missingOfferParams | 13 | Mã lỗi nà y cho biết các tham số bị thiếu trong payment discount. |
| invalidOfferPrice | 14 | Mã lỗi nà y cho biết mức giá bạn đã chỉ định trong App Store Connect không còn hợp lệ. Các ưu đãi phải luôn thể hiện mức giá được giảm. |
Mã Android tùy chỉnh
| Lỗi | Mã | Giải pháp |
|---|---|---|
| adaptyNotInitialized | 20 | Bạn cần cấu hình Adapty SDK đúng cách bằng phương thức Adapty.activate. Tìm hiểu cách thực hiện cho Flutter. |
| productNotFound | 22 | Lá»—i nà y cho biết sản phẩm yêu cầu mua không có sẵn trong cá»a hà ng. |
| invalidJson | 23 | JSON của paywall không hợp lệ. Hãy sá»a lại trong Adapty Dashboard. Tham khảo chủ Ä‘á» Tùy chỉnh paywall bằng remote config để biết cách khắc phục. |
| currentSubscriptionToUpdateNotFoundInHistory | 24 | Không tìm thấy gói đăng ký gốc cần gia hạn. |
| pendingPurchase | 25 | Lỗi nà y cho biết trạng thái mua hà ng đang ở trạng thái chỠxỠlý thay vì đã mua. Tham khảo trang XỠlý giao dịch đang chỠtrong tà i liệu Android Developer để biết thêm chi tiết. |
| billingServiceTimeout | 97 | Lá»—i nà y cho biết yêu cầu đã đạt đến thá»i gian chá» tối Ä‘a trÆ°á»›c khi Google Play có thể phản hồi. Nguyên nhân có thể là do cháºm trá»… trong việc thá»±c thi hà nh Ä‘á»™ng được yêu cầu bởi lệnh gá»i Play Billing Library. |
| featureNotSupported | 98 | TÃnh năng yêu cầu không được há»— trợ bởi Play Store trên thiết bị hiện tại. |
| billingServiceDisconnected | 99 | Lá»—i nghiêm trá»ng nà y cho biết kết nối của ứng dụng khách đến dịch vụ Google Play Store qua BillingClient đã bị ngắt. |
| billingServiceUnavailable | 102 | Lá»—i tạm thá»i nà y cho biết dịch vụ Google Play Billing hiện không khả dụng. Trong hầu hết các trÆ°á»ng hợp, Ä‘iá»u nà y có nghÄ©a là có sá»± cố kết nối mạng ở đâu đó giữa thiết bị khách và dịch vụ Google Play Billing. |
| billingUnavailable | 103 | Lá»—i nà y cho biết đã xảy ra lá»—i thanh toán của ngÆ°á»i dùng trong quá trình mua hà ng. Má»™t số trÆ°á»ng hợp có thể xảy ra bao gồm: 1. Ứng dụng Play Store trên thiết bị của ngÆ°á»i dùng đã lá»—i thá»i. 2. NgÆ°á»i dùng ở quốc gia không được há»— trợ. 3. NgÆ°á»i dùng là ngÆ°á»i dùng doanh nghiệp và quản trị viên doanh nghiệp đã tắt tÃnh năng mua hà ng cho ngÆ°á»i dùng. 4. Google Play không thể tÃnh phà phÆ°Æ¡ng thức thanh toán của ngÆ°á»i dùng. Và dụ: thẻ tÃn dụng của ngÆ°á»i dùng có thể đã hết hạn. 5. NgÆ°á»i dùng chÆ°a đăng nháºp và o ứng dụng Play Store. |
| developerError | 105 | Äây là lá»—i nghiêm trá»ng cho biết bạn Ä‘ang sá» dụng API không đúng cách. |
| billingError | 106 | Äây là lá»—i nghiêm trá»ng cho biết có sá»± cố ná»™i bá»™ vá»›i chÃnh Google Play. |
| itemAlreadyOwned | 107 | Sản phẩm consumable nà y đã được mua trước đó. |
| itemNotOwned | 108 | Lỗi nà y cho biết hà nh động yêu cầu trên mặt hà ng đã thất bại vì |
Mã StoreKit tùy chỉnh
| Lỗi | Mã | Giải pháp |
|---|---|---|
| noProductIDsFound | 1000 | Lỗi nà y cho biết không có sản phẩm nà o bạn yêu cầu trên paywall khả dụng để mua trong App Store, mặc dù chúng đã được liệt kê ở đó. Lỗi nà y đôi khi đi kèm với cảnh báo Nếu bạn gặp lỗi nà y, hãy là m theo các bước trong phần Cách khắc phục lỗi Code-1000 |
| noProductsFound | 1001 | Lá»—i nà y cho biết sản phẩm được yêu cầu mua không khả dụng trong cá»a hà ng. |
| productRequestFailed | 1002 | Không thể tải danh sách sản phẩm khả dụng và o lúc nà y. |
| cantMakePayments | 1003 | In-app purchase không được phép trên thiết bị nà y. Xem hướng dẫn khắc phục sự cố. |
| noPurchasesToRestore | 1004 | Lỗi nà y cho biết App Store không tìm thấy giao dịch mua cần khôi phục. |
| cantReadReceipt | 1005 | Không có biên lai hợp lệ trên thiết bị. Äây có thể là sá»± cố trong quá trình kiểm thá» sandbox. Trong sandbox, bạn sẽ không có tệp biên lai hợp lệ cho đến khi thá»±c sá»± thá»±c hiện má»™t giao dịch mua, vì váºy hãy đảm bảo bạn đã mua Ãt nhất má»™t lần trÆ°á»›c khi truy cáºp biên lai. Khi kiểm thá» sandbox, cÅ©ng hãy đảm bảo bạn đã đăng nháºp trên thiết bị bằng tà i khoản Apple sandbox hợp lệ. |
| productPurchaseFailed | 1006 | Mua sản phẩm thất bại. Lá»—i nà y bao bá»c má»™t lá»—i StoreKit bên dÆ°á»›i — hãy Ä‘á»c lá»—i được bao bá»c (hoặc báºt verbose logs để xem trong console) để biết nguyên nhân thá»±c sá»±. Lá»—i được bao bá»c thÆ°á»ng là má»™t trong các mã StoreKit 0–14 trong bảng trên — phổ biến nhất là paymentCancelled, paymentInvalid, paymentNotAllowed, hoặc invalidOfferPrice. Nếu bạn không xác định được nguyên nhân cụ thể, hãy thá» hồ sÆ¡ sandbox má»›i; nếu vẫn thất bại, hãy liên hệ bá»™ pháºn há»— trợ của Apple. |
| missingOfferSigningParams | 1007 | Lá»—i nà y cho biết có vấn Ä‘á» vá»›i tÃch hợp Adapty hoặc vá»›i các Æ°u đãi. Tham khảo Cấu hình tÃch hợp App Store và Ưu đãi để biết cách thiết láºp chúng. |
| refreshReceiptFailed | 1010 | Lá»—i nà y cho biết biên lai không được nháºn. Chỉ áp dụng cho StoreKit 1. |
| receiveRestoredTransactionsFailed | 1011 | Khôi phục giao dịch mua thất bại. |
Mã mạng tùy chỉnh
| Lỗi | Mã | Giải pháp |
|---|---|---|
| notActivated | 2002 | Adapty SDK chÆ°a được kÃch hoạt. ThÆ°á»ng gặp khi mà n hình splash hoặc má»™t hook UI sá»›m gá»i các phÆ°Æ¡ng thức Adapty trÆ°á»›c khi Adapty().activate trả vá». Triệu chứng nà y không ổn định và có thể không tái hiện trên emulator vì thá»i gian thá»±c thi trên thiết bị tháºt khác biệt. Hãy await Future activate trÆ°á»›c khi gá»i bất kỳ phÆ°Æ¡ng thức SDK nà o khác. Xem Thứ tá»± gá»i trong Flutter SDK để biết toà n bá»™ trình tá»±. |
| badRequest | 2003 | Yêu cầu không hợp lệ. Äảm bảo bạn đã hoà n thà nh tất cả các bÆ°á»›c cần thiết để tÃch hợp vá»›i App Store. |
| serverError | 2004 | Lá»—i máy chủ. Hãy thá» lại sau má»™t thá»i gian. Nếu vấn Ä‘á» vẫn chÆ°a được giải quyết, hãy liên hệ vá»›i Ä‘á»™i ngÅ© há»— trợ Adapty. |
| networkFailed | 2005 | Lá»—i nà y cho biết có sá»± cố vá»›i kết nối mạng trên thiết bị của ngÆ°á»i dùng. Thá» tắt VPN hoặc chuyển từ mạng di Ä‘á»™ng sang WiFi hoặc ngược lại. |
| decodingFailed | 2006 | Lá»—i nà y cho biết việc giải mã phản hồi thất bại. Kiểm tra lại code và đảm bảo các tham số bạn gá»i Ä‘i là hợp lệ. Và dụ, lá»—i nà y có thể cho thấy bạn Ä‘ang dùng API key không hợp lệ. |
| encodingFailed | 2009 | Lỗi nà y cho biết việc mã hóa yêu cầu thất bại. |
| analyticsDisabled | 3000 | Không thể xá» lý các sá»± kiện analytics vì bạn đã tắt tÃnh năng nà y. |
| wrongParam | 3001 | Lá»—i nà y cho biết má»™t số tham số của bạn không đúng. Nếu bạn Ä‘ang dùng Adapty paywall builder và không hiển thị được paywall do lá»—i nà y, hãy báºt Show on device trong paywall builder. Nguyên nhân khác có thể là phiên bản file fallback cục bá»™ không khá»›p vá»›i phiên bản SDK. Hãy tải file má»›i vá» từ dashboard. |
| activateOnceError | 3005 | Không thể gá»i phÆ°Æ¡ng thức .activate nhiá»u hÆ¡n má»™t lần. |
| profileWasChanged | 3006 | Hồ sÆ¡ ngÆ°á»i dùng đã bị thay đổi trong quá trình thá»±c hiện thao tác. Äiá»u nà y xảy ra khi má»™t phÆ°Æ¡ng thức được gá»i trong khi Adapty().identify vẫn Ä‘ang chạy — lá»i gá»i Ä‘ang thá»±c thi sẽ tác Ä‘á»™ng lên má»™t hồ sÆ¡ sắp bị thay thế và SDK từ chối nó. Luôn await identify trÆ°á»›c bất kỳ lá»i gá»i nà o liên quan đến hà nh Ä‘á»™ng của ngÆ°á»i dùng. Xem Thứ tá»± gá»i trong Flutter SDK. |
| unsupportedData | 3007 | Lỗi nà y cho biết định dạng dữ liệu không được SDK hỗ trợ. |
| persistingDataError | 3100 | Äã xảy ra lá»—i khi lÆ°u dữ liệu. |
| fetchTimeoutError | 3101 | Lá»—i nà y cho biết thao tác fetch đã hết thá»i gian chá». |
Các vấn đỠkhác
Nếu bạn vẫn chưa tìm được giải pháp, các bước tiếp theo có thể là :
- Nâng cấp SDK lên phiên bản má»›i nhất: Chúng tôi luôn khuyến nghị nâng cấp lên phiên bản SDK má»›i nhất vì chúng ổn định hÆ¡n và bao gồm các bản sá»a lá»—i đã biết.
- Liên hệ Ä‘á»™i ngÅ© há»— trợ hoặc nháºn trợ giúp từ các nhà phát triển khác trong diá»…n Ä‘Ã n há»— trợ.
- Liên hệ Ä‘á»™i ngÅ© há»— trợ qua support@adapty.io hoặc qua chat: Nếu bạn chÆ°a sẵn sà ng nâng cấp SDK hoặc việc nâng cấp không giải quyết được vấn Ä‘á», hãy liên hệ Ä‘á»™i ngÅ© há»— trợ của chúng tôi. LÆ°u ý rằng vấn Ä‘á» của bạn sẽ được giải quyết nhanh hÆ¡n nếu bạn báºt ghi log chi tiết và chia sẻ log vá»›i Ä‘á»™i ngÅ©. Bạn cÅ©ng có thể Ä‘Ãnh kèm các Ä‘oạn code liên quan.