Xử lý lỗi trong Android SDK
Mọi lỗi được trả về bởi SDK đều có dạng AdaptyError.
Bật verbose logs trước khi debug. Hầu hết các AdaptyError đều bọc một lỗi bên dưới từ Play Billing, mạng, hoặc backend. Khi bật verbose logs (Adapty.logLevel = AdaptyLogLevel.VERBOSE — xem Logging), lỗi được bọ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ệ hỗ trợ, giúp chúng tôi hỗ trợ bạn hiệu quả hơn.
| Lỗi | Giải pháp |
|---|---|
| UNKNOWN | Lỗi này cho biết đã xảy ra một lỗi không xác định hoặc không mong đợi. |
| ITEM_UNAVAILABLE | Lỗi này thường xảy ra trong giai đoạn kiểm thử. Nguyên nhân có thể là các sản phẩm chưa có trên môi trường production, hoặc người dùng không thuộc nhóm Testers trong Google Play. |
| ADAPTY_NOT_INITIALIZED | Adapty SDK chưa được kích hoạt. Thường gặp khi màn hình splash hoặc một UI hook sớm gọi các phương thức Adapty trước khi Adapty.activate hoàn tất. Triệu chứng này không ổn định và có thể không tái hiện trên máy ảo vì thời gian thực thi trên thiết bị thật khác nhau. Hãy chờ Adapty.activate hoàn tất trước khi gọi bất kỳ SDK nào khác. Xem Thứ tự gọi trong Android SDK để biết trình tự đầy đủ. Bạn cũng cần cấu hình Adapty SDK đúng cách bằng phương thức Adapty.activate. |
| PROFILE_WAS_CHANGED | Hồ sơ người dùng đã 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ệnh gọi đang xử lý đó rơi vào một hồ sơ sắp bị thay thế, và SDK từ chối nó. Hãy chờ Adapty.identify hoàn tất trước khi gọi các SDK khác. Xem Thứ tự gọi trong Android SDK. |
| PRODUCT_NOT_FOUND | Lỗi này cho biết sản phẩm được yêu cầu mua không có sẵn trong cửa hàng. |
| INVALID_JSON | JSON của paywall dự phòng cục bộ không hợp lệ. Hãy sửa paywall tiếng Anh mặc định trước, sau đó thay thế các paywall cục bộ không hợp lệ. Tham khảo chủ đề Tùy chỉnh paywall bằng Remote Config để biết cách sửa paywall, và Định nghĩa paywall dự phòng cục bộ để biết cách thay thế các paywall cục bộ. |
CURRENT_SUBSCRIPTION_TO_UPDATE _NOT_FOUND_IN_HISTORY | Không tìm thấy gói đăng ký gốc cần thay thế trong danh sách gói đăng ký đang hoạt động. |
| BILLING_SERVICE_TIMEOUT | Lỗi này cho biết yêu cầu đã vượt quá 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 thao tác được yêu cầu bởi lệnh gọi Play Billing Library bị trễ. |
| FEATURE_NOT_SUPPORTED | Tính năng được yêu cầu không được Play Store hỗ trợ trên thiết bị hiện tại. |
| BILLING_SERVICE_DISCONNECTED | Lỗi này cho biết kết nối của ứng dụng khách đến dịch vụ Google Play Store thông qua BillingClient đã bị ngắt. |
| BILLING_SERVICE_UNAVAILABLE | Lỗ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à các dịch vụ Google Play Billing. |
| BILLING_UNAVAILABLE | Lỗi này cho biết đã xảy ra sự cố thanh toán trong quá trình mua hàng. Các nguyên nhân có thể bao gồm: 1. Ứng dụng Play Store trên thiết bị của người dùng bị thiếu hoặc đã lỗi thời. 2. Người dùng ở quốc gia không được hỗ trợ. 3. Người dùng thuộc tài khoản doanh nghiệp mà quản trị viên đã tắt tính năng mua hà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 đã hết hạn). 5. Người dùng chưa đăng nhập vào ứng dụng Play Store. |
| DEVELOPER_ERROR | Lỗi này cho biết bạn đang sử dụng API không đúng cách. |
| BILLING_ERROR | Lỗi này cho biết có sự cố nội bộ với chính Google Play. |
| ITEM_ALREADY_OWNED | Sản phẩm đã được mua trước đó. |
| ITEM_NOT_OWNED | Lỗi này cho biết thao tác được yêu cầu trên mặt hàng thất bại vì người dùng chưa sở hữu nó. |
| BILLING_NETWORK_ERROR | Lỗi này cho biết có sự cố với kết nối mạng giữa thiết bị và hệ thống của Play. |
| NO_PRODUCT_IDS_FOUND | Lỗi này cho biết không có sản phẩm nào trong paywall khả dụng trong cửa hàng. Nếu bạn gặp lỗi này, hãy làm theo các bước dưới đây để khắc phục:
|
| NO_PURCHASES_TO_RESTORE | Lỗi này cho biết Google Play không tìm thấy giao dịch mua để khôi phục. |
| AUTHENTICATION_ERROR | Bạn cần cấu hình Adapty SDK đúng cách bằng phương thức Adapty.activate. |
| BAD_REQUEST | 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 Google Play. |
| SERVER_ERROR | Lỗi máy chủ. |
| REQUEST_FAILED | Lỗi này cho biết có sự cố mạng không thể xác định cụ thể. |
| DECODING_FAILED | Chúng tôi không thể giải mã phản hồi. Hãy xem lại code của bạn và đảm bảo rằng các tham số bạn gửi đi là hợp lệ. Ví dụ, lỗi này có thể cho biết bạn đang sử dụng API key không hợp lệ. |
| ANALYTICS_DISABLED | Chúng tôi không thể xử lý các sự kiện analytics vì bạn đã tắt tính năng này. |
| WRONG_PARAMETER | Lỗi này cho biết một số tham số của bạn không đúng: để trống khi không được phép để trống, hoặc sai kiểu dữ liệu, v.v. |
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 các 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ờ 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 [email protected] 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úp được, 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 verbose logging và chia sẻ logs với đội ngũ. Bạn cũng có thể đính kèm các đoạn code liên quan.