远程更新 (OTA) 更新提供了一种灵活的方式,无需在 App Store、Google Play 或其他部署平台上发布新版本,即可向移动和 Web 应用程序交付翻译更新。这种方法通过减少延迟和手动流程,支持持续本地化和敏捷开发工作流程。
Phrase Strings 中的 OTA 功能与 iOS、Android、React Native、Flutter、i18next 和 Rails 平台集成。文本标签的更新会立即推送到移动应用程序。
必须创建一个新版本,以便应用更新后的设置。包含在版本中的所有内容必须在 Phrase Strings 中可用,它将翻译直接流式传输到应用程序。如果内容不存在,则不会交付翻译。
对于移动应用程序,OTA 需要将相关的 软件开发工具包 (SDK) 集成到应用程序中,以便在运行时从 Phrase Strings 获取翻译。
首次在设备上启动实现 iOS、Android、React Native 或 Flutter SDK 的应用程序时,会生成一个唯一且随机的设备标识符。此标识符用于跟踪特定时间段内的可用的用户。除此之外不作它用,也不保存任何用户或设备信息。
OTA 请求的数量和月度可用的用户 (MAU) 数量是 有限的,具体取决于所选的定价套餐。
MAU 是请求翻译的唯一设备的数量。每个设备都会被分配一个随机 ID。MAU 是根据过去 30 天内分配的唯一 ID 数量计算得出的。与 Phrase 服务器的每次交互都被视为一个请求。
随 OTA 请求发送的数据
SDK 与 OTA 服务进行通信以检查更新,并在每次请求中包含以下详细信息:
-
设备标识符(例如"F3AFCB10-80A2-84CB-94C0-27F5EF58876D".对于此应用程序是唯一的,因此不允许跟踪特定设备。)
-
应用版本(例如"1.2.0")
-
译文文件的最后更新(例如"1542187679")
-
SDK版本(例如"1.0.0")
-
区域(例如“de-DE”)
-
文件格式(例如“Strings”)
-
客户(例如“ios”)
-
分发 ID(分发的ID)
-
环境密钥(用于区分开发环境和生产环境)
SDK使用的域:
欧盟数据中心
-
ota.eu.phrase.com
-
cdn.eu.phrase.com
-
ota.phraseapp.com
-
cdn.phraseapp.com
美国数据中心
-
ota.us.phrase.com
-
cdn.us.phrase.com
Phrase OTA SDK旨在确保即使在OTA API不可用时,应用也能保持功能正常。在这种情况下,SDK会回退到存储在设备上的最后一次成功获取的译文,或者回退到应用包中包含的捆绑译文。这可以防止最终用户出现错误或缺少Strings的情况。为保证可靠的回退,捆绑的译文应在每次应用发布时保持更新。
分发是一种配置好的设置,用于定义如何以及在何处为特定平台或项目交付OTA更新。
译文平台是在分发中定义的:
-
iOS
-
安卓
-
Flutter
-
i18next
-
Rails
可以有多个分发,但理想情况下每个项目对应一个分发。如果使用 iOS 和 Android 的分发,两种格式的占位符会自动转换。
回退
如果在与分发关联的项目语言设置中设置了语言回退,则当请求的语言存在但键未翻译时,将显示来自所选语言的 Strings。
如果使用了特定国家/地区的语言(例如 en-GB),但该语言不属于发布版本,则如果项目中存在该语言的标准版本(例如 en),系统可以回退到该版本。如果根本找不到请求的语言,则可以改为提供项目的默认区域。
回退不适用于链接键。
创建分发
要创建分发,请按照以下步骤操作:
-
在页面上的框中,点击配置或现有配置的数量(如果已存在)。
页面打开并显示现有配置。
-
点击新建分发。窗口打开。
-
在常规选项卡中,提供、分发关联的、所需的以及所需的。
-
对于 Android 分发,点击Android选项卡以选择格式选项,该选项可根据需要将包含 HTML 标记的任何翻译括在 CDATA 中。
-
选择与分发关联的项目后,调度选项卡变为可用。如果需要,使用此选项卡在分发中设置 OTA 计划发布。
-
-
在回退语言选项卡中,根据需要选择分发特定的回退设置。回退选项按列表中显示的顺序排列优先级。
-
(可选)点击Strings选项卡以选择使用最新已审校版本翻译的选项。仅在配合高级审校工作流使用时启用此选项。
-
点击保存。
分发详情将与 SDK 所需的 ID 一起显示。点击 页面中的分发,即可再次显示详情。
要更新翻译,请在分发内创建一个新发布。项目的当前状态将被导出并提供给已连接的客户端。
要创建一个发布,请按照以下步骤操作:
-
在远程更新页面上,点击所需分发旁边的 添加发布。
窗口随即打开。
-
提供 、所需的 、、 和 。
如有必要,请输入标记,以便仅在发布中包含带有特定标记的键。
-
点击保存。
该发布将添加到分发详情页面底部的列表中。
要设置分发的定期发布计划,请按照以下步骤操作:
-
在 页面上,点击所需分发旁边的齿轮
图标。
窗口随即显示。
-
选择 安排发布 选项卡并点击 。
发布计划选项随即显示。
注释
在 创建新分发 时也可以使用计划选项。
-
从 下拉菜单中,通过选择可用选项之一来选择发布频率:
-
-
选择计划发布所需的星期几。
-
-
提供时间和相关的 。
-
如有必要,请为计划发布选择 、 和 。
-
仅当在项目中启用了分支时,才会显示 字段。选择分支会更新区域设置和语言列表。
-
-
(可选)在 和 字段中指定应用程序版本。
留空以将计划发布应用于应用的所有版本。
-
点击保存。
分发已使用发布计划信息进行更新。
禁用计划会停止自动发布分发,但已配置的设置会被保存。
集成相应的移动 SDK 或 Web 库不仅可以一键更新翻译,还能提供用于衡量使用情况的指标。移动 SDK 和 Web 库报告提供了关于可用的应用用户及其应用语言的宝贵见解。此组报告适用于每个分发,数据每天刷新两次。
报告提供了关于可用的用户数量、总请求数、各语言请求数、各平台请求数以及未提供的设备语言的信息。
可通过 页面上的
图标访问每个分发的报告。
集成 OTA SDK 的技术文档可在每个项目存储库的 README 文件中找到: