备用文件命令

下载应用在无法连接 Adapty 时所打包的备用文件。该文件与 Placements 页面上 Fallbacks 下载的文件相同。

adapty fallbacks get

adapty fallbacks get --app <app-id> --platform ios --sdk-version 4.4.0 --output ios_fallback.json
参数是否必填描述
--app是App ID(UUID)
--platform是App Store 使用 ios,Google Play 使用 android。macOS 和 visionOS 应用使用 ios 文件。
--sdk-version是应用所使用的 Adapty SDK 版本,格式为 X.Y.Z。Flutter、React Native、Unity、Kotlin Multiplatform 和 Capacitor 请传入 Adapty 插件版本号。
--output否指定写入的文件路径,父目录会自动创建。不指定时,内容输出到标准输出。

每个应用的所有版位只需一个文件即可覆盖。要同时支持两个应用商店,请分别使用 --platform ios 和 --platform android 各运行一次该命令。

该文件仅包含已上线的版位,因此请先发布你的流程并激活对应版位,再下载文件。每次修改版位或升级 SDK 后,都需要重新下载,因为该文件只是一个快照。

Adapty 会根据 --sdk-version 自动选择文件格式。SDK 只接受与其构建版本匹配的格式,启动时会拒绝任何其他格式的文件,且不会产生构建错误:

--sdk-version文件格式
4.4.0 及更高版本12
4.1.x – 4.3.x11
4.0.x10
3.12.x 及更高 3.x 版本9
3.8.x – 3.11.x8
3.4.x – 3.7.x7
3.0.x – 3.3.x6
3.0 以下5

付费墙版位在所有格式中均可用。流程版位仅在 SDK 4.0 及更高版本的文件中支持。

使用 --output 时,CLI 只在整个下载成功后才写入文件,因此即使运行失败,之前的文件也会保留。不使用该选项时,标准输出只传输文件内容,所有错误信息则输出到标准错误流。直接使用 > file 重定向会在请求开始前清空文件,所以请使用 --output。

Adapty 在响应前会构建整个文件,大型应用可能需要几分钟。该命令只发送一次请求,不会重试。每个应用的所有令牌每小时最多可下载该文件 30 次;超出后命令会失败,并显示限速错误,提示需要等待多长时间。请仅在发布构建时下载该文件,而非每次提交都执行。

退出代码含义
0文件已写入
1文件无法写入,原有文件保持不变
2无效的标志值
3无令牌,或访问被拒绝
4API 错误,包括速率限制,或返回内容不是备用付费墙文件
5无法连接到 Adapty,300 秒内未响应,或下载中断