You need to enable JavaScript to run this app.
导航

客户端补丁发布

最近更新时间2023.10.16 11:57:24

首次发布时间2022.11.18 13:29:34

「国际化翻译平台」可通过下发补丁文件, 实现客户端文案热修复需求。通过 「国际翻译平台」 客户端补丁发布文案可以提高客户端产品线上文案质量,最大化降低线上文案修正成本。

注意

  1. 由于 CDN 基建原因,为保证功能正常使用,请于工作时间 10:00-19:00[GMT+8] 通过项目设置启用补丁发布功能。正常启用功能后,文案发布时间不再受限。
  2. 目前 1 个账号支持为 5 个文案项目启用补丁发布功能,如需为更多项目启用,请与我们联系。
    若启用补丁发布过程遇到问题,请发起工单与我们联系。

项目设置

在发布客户端补丁之前,需要先启用补丁发布功能并进行相关配置。登录 「国际翻译平台」 管理端,进入对应项目。选择(项目)【设置】菜单 - 开发设置 - 启用补丁发布,可以选择需要开启补丁发布的空间。系统将自动生成 Access Key空间标识


Access Key: AK 用于SDK初始化,是获取项目文案的凭证。
空间标识: 用于SDK初始化,是SDK侧空间的标识。

发布补丁

发布补丁流程的关键节点包括:开始 - 文案打包 - 内测部署 - 线上部署 - 完成。
平台支持从多个入口进入文案补丁发布页面,用户可按需选择合适的入口

  1. 翻译任务 > 勾选文案(可选)> 发布文案 > 选择空间
  2. 空间 > 勾选文案(可选)> 发布文案
  3. 发布管理Tab > 发布文案 > 选择空间

开始发布

发布人可以对一个项目下的文案进行发布,在项目设置 - 项目安全中,可以选择按角色配置发布权限,或自定义发布人。
关于【发布权限】的设置,请参考《发布权限设置》

在项目下的空间详情页或翻译任务详情页,点击右上角的【发布文案】按钮,选择【补丁发布】Tab,即可开始客户端文案补丁发布。选择【发布空间】,填写【应用版本号】。
注意: 在不同发布操作中填写重复版本号,文案将会合并发布。

填写后,点击【去选择文案】,可以在选择文案页面搜索或筛选文案进行发布,并在右侧栏查看已选发布语种及语种下的文案。

选择文案后,点击【去发布配置】,选择本次发布的操作系统发布地区。接下来,分别配置内测部署与线上部署的部署方式。内测部署支持配置 “按指定设备”“按灰度比例” 两种部署方式;线上部署默认进行 “按灰度工作流” 部署,同时支持配置 “按指定设备” 部署,指定设备(Device ID) 需输入数字。


在发布客户端文案补丁时,发布人还可以在【发布描述】文本框中描述本次发布内容、背景、注意事项等。最后,点击【提交发布】,即可提交本次补丁发布任务,并且会自动进行内测部署,内测部署完成后,发布人需在发布详情点击【部署到线上】,开始线上部署。

文案打包与内测部署

文案自动打包成功后,「国际翻译平台」将自动继续执行内测部署节点。文案打包与内测部署节点若发生失败,用户可发起工单查询原因。

线上部署

当内测部署完毕后,发布人在发布详情在可以点击【部署到线上】按钮,开始线上部署。

权限说明:

  • 发布人有推送至线上部署的操作权限
  • 发布人有回滚发布的权限


线上部署默认使用灰度工作流方式进行线上部署,同时支持发布时配置了使用按指定设备(Device ID)方式 进行线上部署,需要经过 7 个节点:初始化、文案包监测、did发布测试、灰度10%、30%、50%、100%。线上部署过程中,发布人在每一个节点可以自主点击右下方【下一步】按钮进入下一步,或勾选【自动下一步】,自动化发布流程。
线上部署的每个节点都会展示:报错信息(如有)、健康检测信息。
alt

发布结束后,在项目下的【发布管理】菜单,可以筛选并查看“类型”为“补丁发布”的历史发布信息。

发布取消

在文案打包环节,发布人有权限操作取消发布;发布到达内测部署环节后,无法再取消发布,但可以进行发布回滚操作。

发布失败

如果发布人观察到发布过程的关键节点(例如内测部署、线上部署节点)出现红色停滞状态,用户可发起工单查询原因。

发布回滚

在发布文案过程中如果遇到异常情况,发布人有权限操作回滚,点击发布详情页右上角的【回滚】按钮,即可开始回滚。

若发布进度已经进行到推送至内测及之后的节点,此时回滚需要调取回滚接口,逐个阶段回滚资源包,最终回滚到部署前的状态。回滚后,进度条中已经点亮的节点和工单信息仍然保留显示。

查看并管理发布

在项目下,选择【发布管理】菜单,可以筛选并查看“类型”为“补丁发布”的历史发布信息;选择【操作记录】菜单,在“操作类型”中筛选“项目设置更新”,可以查看关于补丁发布的配置操作;