Sử dụng paywall dự phòng trong dự án React Native thuần

Hướng dẫn này áp dụng cho các dự án React Native thuần túy (không dùng Expo). Nếu bạn đang dùng Expo, hãy làm theo hướng dẫn paywall dự phòng dành cho Expo.

Để 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/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ó dấu cách 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 đườ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 có phần mở rộng.

iOS

Thêm file JSON dự phòng vào bundle dự á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 vào thuộc tính ios của hằng số FileLocation.

Ví dụ

//after v3.8
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);

//Legacy (before v3.8)
const paywallsLocation = {
  ios: {
    fileName: 'ios_fallback.json'
  },
  android: {
    //if the file is located in 'android/app/src/main/assets/'
    relativeAssetPath: 'android_fallback.json'
  }
}
await adapty.setFallbackPaywalls(paywallsLocation);

Tham số	Mô tả
fileLocation	Đối tượng đại diện cho vị trí của tệp cấu hình paywall dự phòng.