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

Hướng dẫn này áp dụng cho dự án React Native thuần (không dùng Expo). Nếu bạn đang dùng Expo, hãy xem hướng dẫn fallback 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, paywallonboarding 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

  1. 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 (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).

  2. 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 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 kèm phần mở rộng.

iOS

  1. 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”.
  2. Truyền tên file cấu hình vào thuộc tính ios của hằng số FileLocation.

Ví dụ

Các 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.