空中下载 (OTA) 更新提供了一种灵活的方式,将翻译更新交付给移动和网络应用,而无需在 App Store、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)
-
环境密钥(用于区分开发和生产)
分发是一个配置的设置,定义了如何以及在哪里为特定平台或项目提供OTA更新。
目标平台在分发中定义:
-
iOS
-
安卓
-
Flutter
-
i18next
-
Rails
可以有多个分发,但理想情况下每个项目有一个分发。如果同时使用iOS和Android的分发,两个格式的占位符会自动转换。
回退
如果在项目的语言设置中设置了语言回退,则如果请求的语言存在但键未翻译,将显示所选语言的字符串。
如果使用特定国家的语言(例如:en-GB),但不在发布中,则系统可以回退到该语言的标准版本(例如:en),如果它在项目中存在。如果请求的语言完全找不到,则可以提供项目的默认区域。
回退将无法在 linked keys 上工作。
创建一个分发
要创建一个分发,请按照以下步骤操作:
-
在 Configure 或者如果已经存在一些配置,则点击配置的数量。
框中,点击 页面上的页面打开并显示现有配置。
-
点击 New distribution。 窗口打开。
-
在 General 选项卡中,提供一个 ,该分发关联的 ,所需的 和所需的 。
-
对于 Android 分发,点击 Android 选项卡以选择格式选项,如果需要,将任何翻译(包括 HTML 标签)放入 CDATA 中。
-
选择要与分发关联的项目后,Scheduling 选项卡变为可用。如有需要,使用此选项卡在分发中 set up OTA scheduled releases。
-
-
在 Fallback languages 选项卡中,根据需要选择特定于分发的回退设置。回退选项的优先级按列表中显示的顺序排列。
-
可选地,点击 Translations 选项卡以选择使用最新审校版本的翻译的选项。仅在处理 advanced review workflow 时启用此选项。
-
点击保存。
分发详细信息显示 SDK 所需的 ID。通过从
页面点击分发,可以再次显示详细信息。
要更新翻译,请在分发中创建一个新版本。项目的当前状态已导出并提供给连接的客户端。
要创建一个发布,请按照以下步骤操作:
要设置分发的定期发布计划,请按照以下步骤操作:
-
在
页面,点击所需分发旁边的齿轮图标。
窗口显示。
-
选择 安排发布 选项卡并点击 。
发布调度选项显示。
说明
在 创建新分发 时也可以使用调度选项。
-
在
下拉菜单中,选择发布频率,选择可用选项之一:-
-
选择计划发布的所需工作日。
-
-
提供时间和相关的
。 -
如有必要,为计划发布选择
、 和 。-
仅当项目中启用了分支时,
字段才会显示。选择一个分支会更新地区和语言的列表。
-
-
可选地,在
和 字段中指定应用程序版本。留空以将计划发布应用于所有版本的应用程序。
-
点击保存。
分发内容已更新发布调度信息。
禁用调度将停止分发的自动发布,但配置的设置将被保存。
集成适当的移动SDK或Web库允许通过单击更新翻译,同时还提供度量来衡量使用情况。移动SDK和Web库报告提供了有关活跃应用用户及其应用语言的宝贵见解。此报告集可用于每个分发,数据每天刷新两次。
报告提供活跃用户数量、总体请求、每种语言的请求、每个平台的请求以及未提供的设备语言的报告。
每个分发的报告通过图标在 页面上访问。
集成OTA SDK的技术文档可在每个项目存储库的README文件中找到: