翻译管理

远程更新 (Strings)

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

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

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

Phrase OTA SDK旨在确保即使在OTA API不可用时,应用也能保持功能正常。在这种情况下,SDK会回退到存储在设备上的最后一次成功获取的译文,或者回退到应用包中包含的捆绑译文。这可以防止最终用户出现错误或缺少Strings的情况。为保证可靠的回退,捆绑的译文应在每次应用发布时保持更新。

OTA分发

分发是一种配置好的设置,用于定义如何以及在何处为特定平台或项目交付OTA更新。

译文平台是在分发中定义的:

  • iOS

  • 安卓

  • Flutter

  • i18next

  • Rails

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

回退

如果在与分发关联的项目语言设置中设置了语言回退,则当请求的语言存在但键未翻译时,将显示来自所选语言的 Strings。

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

回退不适用于链接键

创建分发

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

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

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

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

  3. 常规选项卡中,提供名称、分发关联的项目、所需的语言以及所需的平台

    • 对于 Android 分发,点击Android选项卡以选择格式选项,该选项可根据需要将包含 HTML 标记的任何翻译括在 CDATA 中。

    • 选择与分发关联的项目后,调度选项卡变为可用。如果需要,使用此选项卡在分发中设置 OTA 计划发布

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

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

  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 页面上的 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.