灰度发布功能介绍

1. 功能演示

FinClip 特别为您制作了灰度发布功能的介绍与功能操作演示视频，您可以点击这里 (opens new window)查看演示视频。

在本视频中，主要帮助您介绍如下内容：

• 什么是灰度发布
  • 了解灰度发布功能、面向的业务场景
  • 了解如何在App中实现一个真实的、“千人千面”的业务目标
• 如何进行灰度发布的规则配置
  • 了解如何创建企业的自有规则库
  • 了解规则配置页面功能
• 如何创建灰度发布
  • 了解灰度发布的前提
  • 了解如何创建灰度发布
  • 了解高级规则与规则路由

2. 灰度功能说明

2.1 灰度发布的条件

如果小程序要进行灰度发布，需满足以下三个条件才可进行：

• 要发布的小程序版本需审核通过（审核中、审核未通过不允许发布）；
• 版本审核通过后，上架状态要为“待上架”（直接上架就无需会度发布了）；
• 开发版本要高于已上架的开发版本；

2.2 灰度发布的状态

进入灰度发布的列表详情页，可以看到当前小程序所有的灰度发布列表，其中包括“已结束”、“发布中”、“可发布”三种状态：

• “已结束”，可点击「查看发布详情」，查看此灰度发布的细节；
• “发布中”，在灰度结束时间上会有红色的“计划”的标识，并且可以提前点击「结束测试」结束灰度发布；
• “可发布”，点击「创建会度发布」即可进入灰度发布设置页面；

当小程序存在“某个版本已经通过审核，但暂未设置为线上版”时，即存在“可发布”的小程序。
对应详情可在【小程序详情-灰度发布】中查看，如该页面无内容，则说明目前没有符合灰度发布规则的小程序。

2.3 灰度发布时间设置

小程序的某个版本设置完灰度发布计划后，如果在时间右侧会出现“钟表”符号，表明该小程序版本未达到实际开始或结束时间，而当小程序的某个版本已经结束灰度发布测试后，“计划”tag将消失，并更新为实际结束时间。

请您注意，灰度发布计划开始执行时，将无法撤销。

2.4 灰度发布个数限制说明

每个小程序能够创建的灰度发布个数是有上限的，但达到上限时，“创建灰度发布”按钮将不可用。如需要继续创建灰度发布，则需要先停止其他正在发布中的版本。

需要注意的是，发布个数与每个小程序挂钩，小程序之间不会互相占用名额。

2.5 发布备用计划

创建灰度发布时，在【基础规则】模块可以选择备用计划。

备用计划是指：当出现意外或不可知的情况后，用户无法打开指定灰度版本小程序时的应对方案。

该计划目前仅支持选择当前小程序的上架版本，如小程序未上架的，用户打开小程序，会收到“小程序未上架”的弹框通知。

因此，我们建议开发者在创建灰度发布前，先上架小程序基础版本。

3. 功能设置

3.1 创建灰度方案

灰度发布的操作入口为：「小程序管理-我的小程序-灰度发布」

3.1.1 创建灰度发布

进入创建灰度发布的页面后，分别填写此次发布生效时间，发布备注，并上传指定发布规则方案即可。

您可直接点击「指定用户发布」，并按照指定用户 ID 进行发布，也可以配置发布规则与规则路由，命中灰度规则的用户将会在发布生效时间中收到此次灰度版本。

3.1.2 添加发布规则

添加「高级规则」（即通过高级规则控制灰度版本推送给特定人群），可通过点击「添加」新增规则来筛选人群：

• 点击「添加」后，可在弹窗中选择系统预设的一些规则，如网络、安卓运行时版本、iOS运行版本等；
• 此外，系统还支持选择自定义添加的规则，若想了解如何添加自定义规则，可参考后续「规则配置」；
• 选择了规则后需要选择操作类型和资源值。假设选择的规则为网络，则需要选择网络类型的资源值，如WiFi、4G、3G等，并选择操作的类型：是包含这些类型，还是不包含这些类型，抑或是选择正则匹配，输入正则表达式；然后点击确定保存即可；

3.1.3 设置路由规则

因为高级规则可一次设置多条，以满足不同场景的需求，故需要通过规则路由来确定不同规则之间的的逻辑关系：

• 点击「配置方案生效方式-添加」按钮，在弹窗中选择配置规则路由，将必须同时满足的规则选在同一规则路由中；
• 配置了多条规则路由后，还需要选择不同规则路由之间的逻辑关系，然后点击「确定」保存即可；
• 保存后，可以在界面看到当前的规则路由预览，若不符合要求，可以重新「选择」或点击「重置」即可；

确保所有信息填写正确后，点击保「确定」即可成功创建灰度发布。

3.2 查看灰度发布结果

当小程序灰度发布开始后，在操作列会出现「查看」按钮

灰度发布详情页​

• 灰度发布方案内容
• 累计发布时长：本次灰度发布的总生效时间，停止灰度发布后将不再计时
• 灰度版本累计用户数：FinClip SDK根据App生成的唯一UUID，用于标识使用该App的为同一个人。如在统计期间内，用户卸载并重新安装App，将产生重复计数。
• 灰度版本累计打开次数：打开次数指灰度版本小程序每打开一次将被记录一次
• 灰度版本性能异常次数：本次灰度版本小程序在灰度期间出现的性能异常次数综合，包含：启动失败、小程序奔溃

命中情况概览

• 打开次数柱状图：展示灰度期间内，灰度版本小程序打开次数
• 用户数柱状图：展示灰度期间内，使用灰度版本的用户数量

命中用户分析

• 地域分析：在灰度期间内，使用灰度版本小程序的用户，都分布在哪些地区；如无法分析、或未上报地理位置，则将汇总为“未知”
• 终端分析：灰度期间内、灰度版本用户所使用的安卓/iOS分布情况

灰度版本性能分析

• 在发布期间内，灰度版本小程序是否包含启动失败或小程序奔溃
• 如发生，则将在下方展示对应错误日志，以便利开发者进行问题定位

3.3 规则配置

灰度发布中的高级规则，除了系统预设的网络、运行时版本-iOS、运行时版本-安卓等规则外，用户还可以根据需要自定义规则；规则配置的操作入口为：「小程序管理-规则配置」。

1. 在规则配置页面，可以看到当前已配置的所有规则（包括系统预设的），点击「查看」可以看到当前规则设置的资源值详情，如查看网络规则的资源值为：WiFi、5G、4G、3G、2G；
2. 除了系统预设的规则外，其他规则均可以修改或删除；
3. 若需要添加规则，点击「新增规则」进入规则创建页面：

• 首先要添加规则的名称，如性别，以及添加规则的ID，如gender；
• 然后选择规则的类型：字符串、布尔、整数、小数，如设置的规则为性别，则选择字符串；
• 其次要选择操作的类型，即选择该规则对资源值进行的操作类型：若选择了「包含/不包含-单选」，则在设置规则的时候只能设置为包含A或不包含A；若选择了「包含/不包含-多选」，则可设置为包含A、B或不包含A、B；若选择了正则匹配则可以输入正则表达式；
• 最后选择手动输入或批量导入规则的资源值，如手动输入“男,女”，然后点击「预览规则」查看规则详情，确认无误后保存即可；

4. 常见问题

您可以点击 这里 看到关于灰度发布功能的常见问题。