附录：模板构建升级指南 -凯发app官方网站

小程序三方业务概览

模板开发指南

模板开发模式接入流程

模板模式知识点导航

step-1：服务商入驻

step-2 : 开发小程序模板

step-3 : 准备商家资质

step-4 : 商家创建&授权小程序

step-5：签约开放能力

step-6 : 构建&提审小程序

其他功能

三方开放能力

代开发指南

三方业务 api

faq

更新时间：2023-07-28 17:43:43

订阅更新

我的文档

设置

背景

在当前的模板模式下，服务商（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

的模板强烈要求必须要走实例化的配置，请联系凯发app官方网站的技术支持人员，一般情况下，如果商家存在个性化配置，直接将商家的个性化配置添加到 isv 的模板中即可，没必要走实例化。

相关问题