远程更新 (OTA) 更新提供了一种灵活的方式,将翻译更新交付给移动和网络应用,而无需在应用商店、Google Play或其他部署平台上发布新版本。这种方法通过减少延迟和手动流程,支持持续本地化和敏捷开发工作流程。
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
短语OTA SDK旨在确保应用程序在OTA API不可用时仍然功能正常。在这种情况下,SDK会回退到设备上存储的最后成功获取的翻译,或回退到包含在应用程序包中的捆绑翻译。这可以防止最终用户出现错误或缺失字符串。为了保证可靠的回退,捆绑翻译应在每次应用发布时保持最新。
分发是一个配置的设置,定义了如何以及在哪里为特定平台或项目提供OTA更新。
目标平台在分发中定义:
-
iOS
-
安卓
-
Flutter
-
i18next
-
Rails
可以有多个发行版,但理想情况下每个项目只有一个发行版。如果同时使用 iOS 和 Android 的发行版,两个格式的占位符会自动转换。
后备
如果在项目的语言设置中设置了语言后备,则如果请求的语言存在但未翻译键,将显示所选语言的字符串。
如果使用特定国家的语言(例如 en-GB),但不在发布中,则系统可以回退到该语言的标准版本(例如 en),前提是该语言在项目中存在。如果请求的语言完全找不到,则可以提供项目的默认区域。
后备将不适用于 链接键。
创建发行版
要创建发行版,请按照以下步骤操作:
-
在 框中,点击 页面上的 配置 或者如果已经存在一些配置,则点击配置数量。
页面打开并显示现有配置。
-
点击 新建发行版。 窗口打开。
-
在 常规 选项卡中,提供一个 ,该发行版关联的 ,所需的 和所需的 。
-
对于 Android 发行版,点击 Android 选项卡以选择格式选项,如果需要,将任何翻译(包括 HTML 标签)放入 CDATA 中。
-
选择要与发行版关联的项目后,调度 选项卡将变为可用。如有需要,使用此选项卡 设置 OTA 定时发布。
-
-
在 后备语言 选项卡中,根据需要选择特定于发行版的后备设置。回退选项按列表中显示的优先级进行排序。
-
可选地,点击翻译选项卡以选择使用最新审校版本的翻译。仅在使用高级审校工作流时启用此选项。
-
点击保存。
分发详情显示SDK所需的ID。可以通过点击页面中的分发再次显示详情。
要更新翻译,请在分发中创建一个新版本。项目的当前状态被导出并提供给连接的客户端。
要创建一个版本,请按照以下步骤操作:
要设置分发的定期发布计划,请按照以下步骤操作:
-
在页面,点击所需分发旁边的齿轮图标
。
窗口显示。
-
选择安排发布选项卡并点击。
发布调度选项已显示。
注释
调度选项在创建新发行版时也可用。
-
从下拉菜单中,选择发布频率,选择可用选项之一:
-
-
选择所需的工作日进行计划发布。
-
-
提供时间和相关的。
-
如有必要,选择、和进行计划发布。
-
仅当项目中启用了分支时,字段才会显示。选择一个分支会更新地区和语言的列表。
-
-
可选地,在和字段中指定应用程序版本。
留空以将计划发布应用于所有版本的应用。
-
点击保存。
分发已更新为发布调度信息。
禁用调度将停止分发的自动发布,但配置的设置将被保存。
集成适当的移动SDK或Web库允许一键更新翻译,同时提供使用情况的指标。移动SDK和Web库报告提供了有关活跃应用用户及其应用语言的宝贵见解。这组报告适用于每个分发,并且数据每天刷新两次。
报告提供了活跃用户数量、总体请求、每种语言的请求、每个平台的请求以及未提供的设备语言的请求。
每个分发的报告可以通过图标在页面访问。
集成 OTA SDK 的技术文档可在每个项目存储库的 README 文件中找到: