Capacitor - 使用备用付费墙

为了保持流畅的用户体验,为您的付费墙用户引导设置备用付费墙非常重要。这一预防措施可在网络连接部分或完全中断的情况下扩展应用的功能。

  • 如果应用无法访问 Adapty 服务器:

    应用将能够显示备用付费墙,并访问本地用户引导配置。

  • 如果应用无法访问互联网:

    应用将能够显示备用付费墙。用户引导包含远程内容,需要互联网连接才能正常运行。

在按照本指南中的步骤操作之前,请先从 Adapty 下载备用配置文件。

配置

Android

  1. 将备用配置文件添加到您的应用程序中。选择以下目录之一:
    • android/app/src/main/assets/

    • android/app/src/main/res/raw/

      注意:res/raw 文件夹有特殊的文件命名规范(以字母开头,不含大写字母,除下划线外不含特殊字符,文件名中不含空格)。

  2. 更新 FileLocation 常量的 android 属性:
    • 如果文件位于 assets 目录,则传入相对于该目录的文件路径。
    • 如果文件位于 res/raw 目录,则传入不含扩展名的文件名。

iOS

  1. 将备用 JSON 文件添加到您的项目包中:在 XCode 中打开 File 菜单,然后选择 Add Files to “YourProjectName” 选项。
  2. 将您的配置文件名传递给 FileLocation 常量的 ios 属性。

示例

import { adapty } from '@adapty/capacitor';

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 });

参数:

参数描述
fileLocation表示备用配置文件位置的对象。