在 Expo 项目中使用备用付费墙

本指南适用于 Expo 项目。如果你使用的是纯 React Native（非 Expo），请参阅纯 React Native 备用付费墙指南。

为了保持流畅的用户体验，请务必为您的流程、付费墙和用户引导设置备用方案。这一预防措施可以在网络部分或完全中断时，确保应用仍能正常运行。

若应用无法访问 Adapty 服务器：

应用可以显示备用流程或付费墙，并读取本地的用户引导配置。
若应用无法访问互联网：

应用可以显示备用流程或付费墙。用户引导包含远程内容，需要联网才能正常使用。

在按照本指南操作之前，请先从 Adapty 下载备用配置文件。

Adapty SDK 从原生包中读取备用文件——iOS 资源存放在 .app 包内，Android 条目位于 android/app/src/main/assets/ 下。在 Expo 项目中，npx expo prebuild --clean 每次运行都会重新生成这些目录，因此无法手动将文件放入其中。react-native-adapty 配置插件会自动将文件注入原生包。

可以在 FocusJournalExpo 示例应用中查看完整的可运行示例。

配置

将备用付费墙 JSON 文件放在项目的任意位置——通常与其他资源文件放在一起：

<your-project>/
└── assets/
    ├── ios_fallback.json
    └── android_fallback.json

在 app.json（或 app.config.js）中，为 react-native-adapty 条目添加 fallbackFile 选项。每个平台的键都是可选的——只需配置你需要的平台即可：

   {
     "expo": {
       "plugins": [
         [
           "react-native-adapty",
           {
             "fallbackFile": {
               "ios": "./assets/ios_fallback.json",
               "android": "./assets/android_fallback.json"
             }
           }
         ]
       ]
     }
   }

Adapty 为每个平台导出不同的备用付费墙 JSON 文件——iOS 使用 Apple 产品 ID，Android 使用 Google Play 产品 ID。请为每个平台指定对应的文件。

重新生成原生项目：

   npx expo prebuild

该插件会将 iOS 文件添加到 Xcode 项目的 bundle 资源中，并将 Android 文件复制到 android/app/src/main/assets/。预构建输出中会包含如下信息：

[react-native-adapty] Registered ios_fallback.json as iOS bundle resource
[react-native-adapty] Copied android_fallback.json to android assets/

在运行时向 SDK 注册该文件：

   import { adapty } from 'react-native-adapty';

   await adapty.activate('PUBLIC_SDK_KEY');

   await adapty.setFallback({
     ios: { fileName: 'ios_fallback.json' },
     android: { relativeAssetPath: 'android_fallback.json' },
   });

传给 setFallback 的文件名必须与 fallbackFile 中配置的文件基本名称保持一致。

setFallback 必须在 SDK 获取目标流程、付费墙或用户引导之前执行。

验证

运行 npx expo prebuild 后，检查两个平台：

Android：列出 android/app/src/main/assets/ 的内容。fallbackFile.android 配置的文件应该存在，且仅适用于 iOS 的文件名不应出现在这里。
iOS：在 ios/<ProjectName>.xcodeproj/project.pbxproj 中搜索 iOS 文件名。它应出现在 PBXFileReference、Resources 组和 PBXResourcesBuildPhase 中。仅适用于 Android 的文件名不应出现在 project.pbxproj 中。