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 tệp 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/

Thư mục res/raw có 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ó khoảng trắng trong tên file).

Cập nhật thuộc tính android của hằng số FileLocation:
- Nếu file nằm trong thư mục assets, truyền vào đườ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 vào tên file không bao gồm phần mở rộng.

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 ios củ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 });

setFallback phải chạy trước khi SDK tải flow, paywall hoặc onboarding mục tiêu.

Tham số:

Parameter	Description
fileLocation	Đối tượng biểu thị vị trí của tệp cấu hình paywall dự phòng.