翻译管理

远程更新 (Strings)

文本由 Phrase Language AI 从英语机器翻译而得。

远程更新 (OTA) 更新提供了一种灵活的方式,将翻译更新交付给移动和网络应用,而无需在应用商店、Google Play或其他部署平台上发布新版本。这种方法通过减少延迟和手动流程,支持持续本地化和敏捷开发工作流程。

Phrase Strings中的OTA功能与iOS、Android、React Native、Flutter、i18next和Rails平台集成。文本标签的更新会立即推送到移动应用。

OTA User Device Diagram

必须创建新版本,以便应用更新的设置。发布中包含的所有内容必须在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分发

分发是一个配置的设置,定义了如何以及在哪里为特定平台或项目提供OTA更新。

目标平台在分发中定义:

  • iOS

  • 安卓

  • Flutter

  • i18next

  • Rails

可以有多个发行版,但理想情况下每个项目只有一个发行版。如果同时使用 iOS 和 Android 的发行版,两个格式的占位符会自动转换。

后备

如果在项目的语言设置中设置了语言后备,则如果请求的语言存在但未翻译键,将显示所选语言的字符串。

如果使用特定国家的语言(例如 en-GB),但不在发布中,则系统可以回退到该语言的标准版本(例如 en),前提是该语言在项目中存在。如果请求的语言完全找不到,则可以提供项目的默认区域。

后备将不适用于 链接键

创建发行版

要创建发行版,请按照以下步骤操作:

  1. 远程更新 (OTA) 框中,点击 集成 页面上的 配置 或者如果已经存在一些配置,则点击配置数量。

    远程更新 页面打开并显示现有配置。

  2. 点击 新建发行版添加发行版 窗口打开。

  3. 常规 选项卡中,提供一个 名称,该发行版关联的 项目,所需的 语言 和所需的 平台

    • 对于 Android 发行版,点击 Android 选项卡以选择格式选项,如果需要,将任何翻译(包括 HTML 标签)放入 CDATA 中。

    • 选择要与发行版关联的项目后,调度 选项卡将变为可用。如有需要,使用此选项卡 设置 OTA 定时发布

  4. 后备语言 选项卡中,根据需要选择特定于发行版的后备设置。回退选项按列表中显示的优先级进行排序。

  5. 可选地,点击翻译选项卡以选择使用最新审校版本的翻译。仅在使用高级审校工作流时启用此选项。

  6. 点击保存

    分发详情显示SDK所需的ID。可以通过点击远程更新页面中的分发再次显示详情。

OTA发布

要更新翻译,请在分发中创建一个新版本。项目的当前状态被导出并提供给连接的客户端。

要创建一个版本,请按照以下步骤操作:

  1. 在远程更新页面,点击所需分发旁边的添加版本

    新版本窗口打开。

  2. 提供描述、所需的平台分支地区应用版本

    如有必要,输入标签以仅在版本中包含特定标签的键。

  3. 点击保存

    该版本已添加到分发详情页面底部的列表中。

安排OTA发布

要设置分发的定期发布计划,请按照以下步骤操作:

  1. 远程更新页面,点击所需分发旁边的齿轮图标Modify

    编辑分发窗口显示。

  2. 选择安排发布选项卡并点击启用调度

    发布调度选项已显示。

    注释

    调度选项在创建新发行版时也可用。

  3. 下拉菜单中,选择发布频率,选择可用选项之一:

    • 选择所需的工作日进行计划发布。

  4. 提供时间和相关的时区

  5. 如有必要,选择分支标记语言进行计划发布。

    • 仅当项目中启用了分支时,分支字段才会显示。选择一个分支会更新地区和语言的列表。

  6. 可选地,在最小版本最大版本字段中指定应用程序版本。

    留空以将计划发布应用于所有版本的应用。

  7. 点击保存

    分发已更新为发布调度信息。

禁用调度将停止分发的自动发布,但配置的设置将被保存。

注释

我们仍在不断优化,实际的用户界面可能与视频中呈现的不一样。

OTA移动SDK和Web库报告

集成适当的移动SDK或Web库允许一键更新翻译,同时提供使用情况的指标。移动SDK和Web库报告提供了有关活跃应用用户及其应用语言的宝贵见解。这组报告适用于每个分发,并且数据每天刷新两次。

报告提供了活跃用户数量、总体请求、每种语言的请求、每个平台的请求以及未提供的设备语言的请求。

每个分发的报告可以通过Open Reports图标在远程更新页面访问。

OTA SDK 集成

集成 OTA SDK 的技术文档可在每个项目存储库的 README 文件中找到:

这篇文章有帮助吗?

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.