发布管理是客户端升级新版本的配置后台,支持用户创建多任务、多维度的升级配置。
关于此任务
iOS 发布管理的功能包括以下方面:
增加升级资源并提示 App 的下载二维码(仅限 企业分发)。
创建、修改新版本资源包的任务。
对已添加的发布包创建多种类型的发布任务,例如白名单灰度、时间窗灰度、正式发布。同一版本的升级包可以有多个发布任务。
支持多种条件的升级过滤,例如城市、机型、设备系统版本、网络、发布包版本。
添加发布包
进入 mPaaS 控制台,完成以下步骤:
在左侧导航栏,点击 实时发布 > 发布管理,页面显示发布管理列表。
点击 + 添加发布包,在弹出的窗口中完成以下设置:
平台:选择 iOS。
发布类型:分为 AppStore、企业分发 与 TestFlight,详见下方的说明。
AppStore:针对从 AppStore 下载的 App 提示升级。
企业分发:针对在企业内部分发的 App 提示升级。
TestFlight:针对即将发布到 AppStore 的新版本做上线前的灰度验证。
点击 确定,完成添加,新添加的发布包会出现在页面的最上方。
在发布管理列表,点击发布包前的加号图标()查看升级包的发布任务:
如果升级包未发布过,当前包的状态为 待发布,并且没有任何发布任务。
如果升级包发布过,当前包的状态为最新任务的发布状态,并且有相关的发布任务。
AppStore
要使用 AppStore 发布,您需要先在苹果官方 App Store 中上架您的 App。
当您选择 AppStore 为发布类型时,您需要输入以下信息:
appstore 地址:您的 App 在 App Store 上的地址。
版本号:发布包的版本号。此版本号需与 iOS 工程 info.plist 文件中的
Product Version
字段保持一致。发布描述(选填):发布包的描述信息。
企业分发
当您选择 企业分发 为发布类型时,您需要选择或输入以下信息:
上传图标(可选):可上传
.jpg
或.png
格式的图片作为图标。发布包:从本地选择发布包进行上传,只支持
.ipa
格式。bundleId(选填):您的 App 的 bundleId,若不填则使用在代码配置页面下载配置文件时填写的 bundleId。
版本号:发布包的版本号。此版本号需与 iOS 工程 info.plist 文件中的
Product Version
字段保持一致。发布描述(选填):发布包的描述信息。
下载验证:如开启该开关,则用户在扫描二维码后,需要通过验证码验证才能下载发布包。
说明添加 企业分发 类型的发布包后,在发布包列表页的 二维码 列中会生成一个下载
.ipa
发布包的二维码,扫描该二维码后,即可将发布包安装至手机。
TestFlight
要使用 TestFlight 测试功能,您必须已在 App Store Connect 中创建并启用了公开链接。
只有在版本 ≥ 10.1.32 的客户端中才可使用 TestFlight。
您输入的 包失效时间 与 测试人员上限 必须与您在 App Store Connect 中设置的一致。
当您选择 TestFlight 为发布类型时,您需要输入以下信息:
公开链接地址:您在 App Store Connect 中创建的公开链接地址,需保证此链接是启用状态。
包失效时间:TestFlight 包的失效时间,需与您在 App Store Connect 中设置的一致。
测试人员上限:参与测试的人员上限,需与您在 App Store Connect 中设置的一致。
版本号:发布包的版本号。此版本号需与 iOS 工程 info.plist 文件中的
Product Version
字段保持一致。发布描述(选填):发布包的描述信息。
创建发布任务
对已添加的发布包创建发布任务,支持为同一版本的发布包同时创建多个发布任务。单个升级包最多支持同时发布 10 个任务。
发布任务下发规则:
当客户端请求匹配到多个发布任务时,优先下发高版本任务。
当同一个发布包版本命中多个发布任务时,按照任务类型,发布任务的下发优先级从高到低为:正式 > 白名单(灰度)> 时间窗(灰度)。
若发布包版本相同,任务类型也相同,则以最新发布的任务为准。例如,在控制台上发布了一个 5.0 版本的白名单任务 A,针对 4.0 版本进行单次升级;接着又发布了一个白名单任务 B,针对 4.0 版本做强制升级。这两个任务同时存在,当 4.0 版本的客户端请求升级时,首先下发任务 B,在任务 B 终止或者暂停后,下发任务 A。
当一个版本同时发布灰度任务和正式任务时,列表发布状态显示为“正式发布”,当暂停或结束正式任务后,发布状态显示为“灰度发布”。如果所有任务都结束了,则显示“已结束发布”。
操作步骤如下:
找到要创建发布任务的发布包。
在右侧的 操作 列中,点击 创建发布任务。
在 创建发布任务 页面中,选择或输入以下信息:
发布类型:分为 灰度 与 正式。
灰度:在正式发布前,进行小规模发布以验证新包的功能是否达到预期,发布对象是部分用户。
正式:正式发布版本,发布对象是全部用户。
说明TestFlight 与 企业分发 类型的发布包仅支持 灰度 发布。TestFlight 发布页面不展示 发布类型 选项,企业分发 类型的发布包固定为 灰度 类型,且不可选择。
升级模式:分为 单次、多次 与 强制升级。
单次:在 App 启动后根据静默策略提示升级。
说明静默策略指弹出升级提示后,用户点击取消后一段时间内处于“静默”状态,不再提醒升级。默认静默时间为 3 天,可自定义。如需自定义静默时间,可参考 发布新版本。
多次:在 App 每次启动后均提示升级。
强制升级:在 App 每次启动后提示升级并且无法关闭提示窗。
说明TestFlight 类型的发布包无 强制升级,只有 单次 与 多次。
发布模型(仅限 灰度 发布):分为 白名单灰度 和 时间窗灰度。
当选择 白名单灰度 时,您可在下方配置白名单。
说明您可在白名单管理中配置白名单。具体操作步骤,参见 白名单管理。
当选择 时间窗灰度 时,您可在下方选择时间窗的 结束时间 以及 灰度人数。
说明企业分发 类型的发布包无 时间窗灰度,只有 白名单灰度。
升级提示信息(选填):升级时所显示的信息。
发布描述(选填):本次发布的描述信息。
高级规则(仅限 灰度 发布):点击 添加,您可在弹出的窗口中选择 包含 或 不包含 特定的 城市、机型、网络 等信息,并选择与 类型 对应的 资源值。
设置完毕后,点击 确定,即可开始发布。您可点击发布包左侧的加号图标()来查看刚刚创建的发布任务。
相关操作
上传符号表。在发布管理列表,您可对已添加的发布包上传符号表。
一个
.ipa
发布包对应一个符号表文件。只支持
dSYM
格式的符号表,且需要将文件压缩成.tgz
格式上传。
变更升级包的发布任务。在发布管理列表,点击发布包前的加号图标()查看升级包的发布任务。
点击 暂停,暂停发布任务。暂停后,如要继续进行该任务,点击 继续。
点击 结束,终止发布任务。结束后,您不能再对任务做任何操作。