管理后台使用说明

HotFix提供可视化的管理后台，进行日常的应用创建、版本添加、补丁上传及发布等操作。

请注意区分阿里云控制台与HotFix管理后台，阿里云控制台内可以对账号信息等进行编辑更新，也集合了阿里云所有产品管理后台的入口，而HotFix管理后台只是其中一个。

Step1 创建应用

HotFix会同步您所有的阿里云移动应用，并区分操作系统：Android，iOS。

您也可以在HotFix控制台新增一个移动应用。

Step2 获取SDK配置信息

您可以在应用管理页面获取配置SDK所需要的基本信息。包括：

• AppID：用于AppID是阿里云上应用的唯一标识。
• RSA密钥： RSA密钥是保存在客户端本地用于解密patch包过程中使用的解密密钥。（推荐使用chrome浏览器下载）
• AppSecret：用于URL请求时生成合法验签标识的key。

操作步骤：

Step3 创建版本

您可以在HotFix控制台创建版本。（推荐使用chrome浏览器）

• 版本号

  用户自行输入，版本号是为以.分割的多段数字，如1.0.1。版本号必须与用户App内的appVersion相同，如果不相同将导致补丁发布不成功。

操作步骤：

Step4 上传补丁文件

在版本详情页面，您可以上传补丁文件。

操作步骤：

补丁文件名称规范：

• Android：文件名必须为：sophix-patch.jar；
• 如何生成Android补丁文件,见文档Android生成Patch补丁

补丁状态：

• 等待中：补丁上传成功，等待操作。
• 已灰度：补丁正在进行灰度发布。
• 已发布：补丁已全量发布至所有设备。
• 已停止：补丁发布行为已暂停。

Step5 发布补丁

HotFix提供了多种发布方式，方便您根据自身业务需要选择性使用。

5.1 本地测试

HotFix提供了调试工具实现本地测试，方便您在正式发布前，在您的手机本地进行测试。步骤如下：

• 下载安装HotFix 调试工具。
• 使用HotFix 调试工具获取补丁；
• Android调试工具使用说明。

5.2 灰度发布

HotFix提供灰度发布模式，您可以在控制台设置灰度设备数，客户端拉取补丁会消耗该设备数，达到灰度设备数后，灰度补丁自动置为停止状态。

• 设备数：指设备请求更新该补丁的次数，并不等于绝对设备数。

例如：1个设备请求了2次更新该补丁，则会消耗掉2的设备数。

灰度后可以根据自身需要停止本次灰度发布，停止后可以选择：

• 重设灰度发布规则，新的规则中设备数必须大于之前的值。
• 改为全量发布。
• 回滚版本（如果存在历史版本）见 Step7 发布回滚。
  

5.3 全量发布

HotFix提供全量发布模式，选择全量发布后，将对所有安装了当前应用版本（即之前创建应用时所填写的应用版本号）的设备推送该补丁。

与灰度发布类似，在全量发布会可以根据自身需要停止本次全量发布，停止发布后可以选择：

• 继续全量发布。
• 回滚版本（如果存在历史版本），见Step7 发布回滚。

Step6 停止发布

HotFix提供停止发布功能，用户选择停止发布后，系统将停止该补丁的继续发布，但已加载该补丁的设备会依然保持安装该补丁的状态。

Step7 发布回滚

HotFix提供发布回滚功能，用户选择回滚的目标补丁后，所有该应用版本下的设备都会回滚到目标补丁的版本。

使用回滚功能必需要具备一下几个条件：

• 当前的版本已停止发布。
• 该版本之前存在至少一个全量发布的历史版本。

Step8 继续发布

HotFix提供继续发布功能，用户选择继续发布后，将可以重新设置发布规则。

如果当前版本在停止前处于灰度中，继续发布可以：

• 重设灰度发布规则，新的规则中设备数必须大于之前的值。
• 改为全量发布。

如果当前版本在停止如果处于全量发布，继续发布可以：

• 继续全量发布。

Step9 数据统计

HotFix目前提供两种数据信息。

• 成功推送设备数：每当有设备发起一次更新请求，且补丁下载成功，则记为一次成功推送。
• 累计加载设备数：每当有设备成功加载该补丁，则记为一次累计加载。

注：

后台数据可能有少许延迟。

Step10 添加过滤机型

HotFix提供可视化的管理后台，进行发布补丁的过滤机型操作。

本文档主要介绍过滤机型使用的过滤参数。

10.1 系统版本

系统版本是指手机所使用的OS的版本。

在控制台中，有相应的系统版本列表可供选择。如果列表中没有需要自定义，请按如下标准获取系统版本。

android.os.Build.VERSION.RELEASE

例如系统版本结果是：9.0.1

10.2 手机品牌

手机品牌是指手机贴牌商标代表的品牌，需要区别手机制造商，手机制造商可能会生产多个品牌，一个品牌也可能是多个制造商生产。

在控制台中，我们有相应的品牌列表供选择使用。如果需要自定义，请按如下标准获取手机品牌，注意实际过滤时不区分大小写。

android.os.Build.BRAND

例如手机品牌是：OPPO

10.3 手机机型

手机机型是指某个手机品牌下手机具体的型号。

目前由于手机机型庞杂，没有提供选择列表供选择，后续会支持。填写手机机型时请按如下标准，不区分大小写。

android.os.Build.MODEL

例如手机型号是：OPPO R11

【注意】如果想设置全部机型，请在自定义机型里面，输入:all

Step11 补丁一键清除

HotFix提供补丁一键清除功能。开发者可以对指定应用版本下面的所有补丁进行一键清除操作。

开发者操作一键清除后，管理后台的历史补丁将处于已删除状态，开发者不可再对补丁执行除浏览外的任何操作。

如在操作过程中遇到任何疑问，欢迎加入钉钉群：11734260 咨询。