Capacitor - Sử dụng paywall dự phòng
Để duy trì trải nghiệm người dùng mượt mà, điều quan trọng là phải thiết lập paywall dự phòng cho các flow, paywall và onboarding của bạn. Biện pháp phòng ngừa này giúp mở rộng khả năng của ứng dụng trong trường hợp mất kết nối internet một phần hoặc hoàn toàn.
-
Nếu ứng dụng không thể kết nối đến máy chủ Adapty:
Ứng dụng vẫn có thể hiển thị flow hoặc paywall dự phòng, và truy cập cấu hình onboarding đã lưu cục bộ.
-
Nếu ứng dụng không thể kết nối internet:
Ứng dụng vẫn có thể hiển thị flow hoặc paywall dự phòng. Onboarding chứa nội dung từ xa và cần có kết nối internet để hoạt động.
Trước khi thực hiện các bước trong hướng dẫn này, hãy tải xuống các file cấu hình dự phòng từ Adapty.
Cấu hình
Android
- Thêm file cấu hình dự phòng vào ứng dụng của bạn. Chọn một trong các thư mục sau:
-
android/app/src/main/assets/
-
android/app/src/main/res/raw/
Lưu ý: Thư mục
res/rawcó quy tắc đặt tên file đặc biệt (phải bắt đầu bằng chữ cái, không dùng chữ hoa, không dùng ký tự đặc biệt ngoại trừ dấu gạch dưới, và không có dấu cách trong tên).
-
- Cập nhật thuộc tính
androidcủa hằng sốFileLocation:- Nếu file nằm trong thư mục
assets, truyền đường dẫn của file tương đối so với thư mục đó. - Nếu file nằm trong thư mục
res/raw, truyền tên file không bao gồm phần mở rộng.
- Nếu file nằm trong thư mục
iOS
- Thêm file JSON dự phòng vào bundle dự án của bạn: mở menu File trong XCode và chọn tùy chọn Add Files to “YourProjectName”.
- Truyền tên file cấu hình của bạn vào thuộc tính
ioscủa hằng sốFileLocation.
Ví dụ
const fileLocation = {
ios: {
fileName: 'ios_fallback.json'
},
android: {
//if the file is located in 'android/app/src/main/assets/'
relativeAssetPath: 'android_fallback.json'
}
};
await adapty.setFallback({ fileLocation });
Tham số:
| Tham số | Mô tả |
|---|---|
| fileLocation | Đối tượng đại diện cho vị trí của file cấu hình dự phòng. |