全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 钉钉智能硬件

管理后台使用说明

更新时间:2017-08-21 15:29:06

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

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

Step1 创建应用

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

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

新建App


Step2 获取SDK配置信息

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

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

操作步骤:管理入口

keys


Step3 创建版本

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

  • 版本号

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

操作步骤:管理入口

详情页面入口

版本号


Step4 上传补丁文件

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

操作步骤:管理入口

详情

patch232

补丁文件名称规范:

补丁状态:

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


Step5 发布补丁

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


5.1 本地测试

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


5.2 灰度发布

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

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

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

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

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

5.3 全量发布

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

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

  • 继续全量发布。
  • 回滚版本(如果存在历史版本),见Step7 发布回滚


Step6 停止发布

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


Step7 发布回滚

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

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

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


Step8 继续发布

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

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

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

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

  • 继续全量发布。


Step9 数据统计

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

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

注:

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


Step10 添加过滤机型

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

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

10.1 系统版本

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

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

  1. android.os.Build.VERSION.RELEASE

例如系统版本结果是:9.0.1


10.2 手机品牌

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

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

  1. android.os.Build.BRAND

例如手机品牌是:OPPO


10.3 手机机型

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

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

  1. android.os.Build.MODEL

例如手机型号是:OPPO R11

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


Step11 补丁一键清除

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

patch232

开发者操作一键清除后,app用户在下一次打开应用时,HotFix SDK将清除本地所有补丁,回滚至该应用版本的无补丁状态!请谨慎操作。

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

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

本文导读目录