Skip to main content

如何使用 Shiply Android 灰度发布

一、 创建项目和产品​

使用Android灰度发布功能需要现创建项目和对应的Android产品，具体可以参考 平台接入流程 

1.2 接入 Android 应用内升级 SDK​

开发者在自己 App 代码中集成 Shiply 应用内升级 SDK，具体可以参考 Android 应用内升级 SDK 集成 

二、创建灰度发布任务​

点击右上角新建发布按钮，进入新建任务页面，按照页面提示填写相关内容。

alt text

2.1 上传安装包​

alt text

  • 可根据需求上传1-2个安装包，支持64位兼容包。
  • 支持加密安装包，加密包需要手动输入包名/App位数/VersionName/VersionCode
  • 选择用来生成差量包的基准版本后，Shiply后台会生成对应的差量包文件

2.2 填写任务基本信息​

alt text

  • 任务名称： 用于区分不同的升级任务
  • 负责人：只有负责人允许修改任务
  • 审核人：任务发布前需要经过审核人审核
  • 优先级：
    • 分为高中低三个级别
    • 当有多条灰度策略同时下发时，会根据优先级进行匹配，优先级高的未命中时，再匹配优先级低的，直到命中或匹配完成
    • 相同优先级的任务按照任务创建顺序匹配，后创建的优先匹配。
  • 标签：给升级任务添加标签，如开发，运维等，并可设置标签颜色

2.3 填写下发内容​

alt text

  • 更新标题：APP内升级弹窗标题
  • 版本描述：APP内升级弹窗内容
  • 提醒方式：
    • 弹窗、红点、全部（包含弹窗和红点）
    • 总弹窗次数：当前任务允许的最大弹窗次数
    • 弹窗间隔：两次弹窗的最小时间间隔
  • 自定义下发字段：下发给客户端的key/value map,业务方可以使用这些字段做一些自定义逻辑，比如强制更新等

2.4 填写下发条件​

alt text

  • 任务的下发条件
    • 满足当前条件的用户才能拉取到这个任务。任务可以选择条件模版和自定义条件。Shiply提供了丰富的条件规则，每个规则是“且”的关系
    • 应用版本号条件是指APP的VersionName
    • 系统版本与业务方初始化SDK时设置的systemVersion字段对应，建议使用Build.VERSION.SDK_INT的值
  • 防骚扰：配置后，在对同一个用户下发一次后，间隔设定时间（3天）内不会再次下发

2.5 填写放量策略​

alt text

  • 策略类型：
    • 批次灰度：可以指定每个批次的下发上限人数或者激活上限人数，以及各批次的持续时间或者到达上限后的等待时间
    • 平滑灰度：根据目标灰度时长和灰度下发人数均匀下发任务
    • 立即全量：发布后立即对所有符合下发条件的线上用户生效
  • 启动定时：开启后，该条策略会在设定的时间范围内，自动开启灰度，自动停止灰度

2.6 点击发布按钮生成待发布任务​

alt text 点击发布后，任务不会立刻启动，会在任务列表页创建一个待发布任务： alt text

任务列表页面可以查看所有升级任务，包括任务优先级、状态等信息。

三、测试体验​

alt text

点击列表中的任务可以查看该任务的任务详情。点击详情页面右侧开始体验按钮，任务进入体验状态。

alt text 点击编辑按钮，会展示体验弹框。 alt text

  • 体验名单添加：
    • 支持手动输入、txt 文件上传、号码包勾选。体验名单最多可以添加 1000 个体验号码。
    • 体验号码可以选择是否忽略任务中的条件规则，来命中任务。

设置好体验名单后，测试或者开发人员就可以用对应名单来拉取验证当前任务。

四、发布审批​

alt text 验证能正常弹框和升级后，点击发起审批按钮，进入审核状态。

alt text

审核人可以通过和驳回审批。

五、启动发布​

alt text

审核通过后即可启动灰度发布，点击「启动发布」，任务开始正式对外放量。