背景
在当前的模板模式下,系统服务商(ISV)通过 alipay.open.mini.version.upload 接口代商家小程序上传版本,从提交上传版本请求,到版本成功创建,根据源码包的大小不同,需要耗时几十秒甚至几分钟;在此期间,系统服务商(ISV)需要等待,并通过 查询版本上传状态接口 轮询商家小程序版本的构建状态,直至轮询接口返回版本创建成功。
为了提升商家小程序的版本上传效率,简化系统服务商(ISV)接入流程,现升级了基于模板上传版本的实现模式。在不改变接口定义的情况下,实现毫秒级的处理能力,系统服务商(ISV)可以快速进入后续的操作,现称这种模式为 配置化上传版本,老的模式为 实例化上传版本。调用上传版本接口后,是由系统判断以何种模式上传版本。
注意:不论是实例化构建模式还是升级后配置化构建模式,都应在调用构建版本的接口后 查询构建状态,查询到构建成功再进行后续操作。
变化
相比实例化上传版本,配置化上传的小程序版本,存在两处不同:
不支持个性化配置。
配置化上传的版本无法回滚至实例化上传的版本。
不支持个性化配置
不支持商家的小程序自定义配置,这些配置包括:
web-view 的 H5 域名白名单
服务器域名白名单
startApp 小程序跳转配置
商家小程序的这些个性化配置会全部被覆盖,仅保留模板级别的配置。例如小程序 A 配置了服务器域名白名单 URLA,模板所属的第三方应用配置了白名单 URLB,通过实例化模式上传的小程序版本,小程序 A 实际生效的服务器域名白名单为 URLA + URLB,但是通过配置化上传的版本,仅仅只有 URLB 生效。
配置化上传的版本无法回滚至实例化上传的版本
从实例化上传版本的小程序,如果直接切换成配置化上传版本,会出现配置化上传的版本无法回滚到实例化上传的版本,但是配置化版本可以回滚到配置化的版本,如下图所示:
常见问题
Q:如果商家配置了个性化配置,但是并不消费,是否有必要添加到模板中?
A:没必要,商家小程序存在个性化配置,但是如果小程序并未使用到这个配置,那么这个配置在配置化上传的版本中实际并不会生效,无需添加到模板中。
Q:能否从配置化迁移回实例化?
A:不支持,商家小程序一旦切换到配置化,将不再支持再迁移回实例化。
Q:迁移成配置化的版本,解除授权后是否会影响从 IDE 上传版本?
A:不影响。
Q:如果商家强烈要求必须有个性化配置,该怎么办?
A:如果系统服务商(ISV)的模板强烈要求必须要走实例化的配置,请联系技术支持人员,一般情况下,如果商家存在个性化配置,直接将商家的个性化配置添加到系统服务商(ISV)的模板中即可,没必要走实例化。