构建小程序版本 -凯发app官方网站

更新时间：2024-07-17 17:37:58

订阅更新

我的文档

设置

商家小程序授权给第三方应用后，服务商调用接口帮助商家构建小程序。

说明

：

●

不支持通过 ext 配置静态插件或者启用动态插件。

●

不支持直接在 ext 中配置 tabbar。

通过小程序模板构建商家小程序版本

生成版本

调用

alipay.open.mini.version.upload

（小程序基于模板上传版本）接口，通过模板构建商家小程序版本。

说明

：

无需配置商家小程序的开发配置

，调用构建接口后，商家小程序的开发配置会自动继承第三方应用和模板的开发配置：

●

商家小程序继承第三方应用的接口加签方式、域名白名单、ip 白名单、支付宝网关、应用网关、接口内容加密方式、基础库最低版本等配置。

●

商家小程序继承小程序模板的 h5 域名和 aes 密钥配置。

注意

：如果需要获取手机号，需要给商家小程序设置 aes 密钥，可查看

模板模式接入获取会员手机号

。

●

若商家小程序在调用构建版本接口之前已有开发配置，则调用构建版本接口后，在小程序原有的开发配置基础上合并第三方应用和模板的开发配置，一并生效。

ext 参数说明

为了方便第三方平台的开发者引入 appid 的开发调试工作，需要引入

ext.json

的概念。

调用构建接口时传入 ext 参数，

ext.json

的配置将会被写入商家小程序

app.json

的根目录下。

将商家的标识符（可自行决定采用何种标识，只要可以通过此标识查询出之前记录的该商家对应的

app_auth_token

即可）通过

ext.json

注入商家小程序中，以便小程序模板前端向服务商的服务端发出的请求，都可以带上商家标识符，从而服务端可以查询出与商家对应的

app_auth_token

。

{

"extenable": true,

"ext": {

"shopid": "2018050xxxxxx975978",

"minishopid": "1112xxxxxx9766",

"appid": "201xxxxxx108305"

"extpages": {

"pages/face/index":{

"defaulttitle": "功能演示页面"

}

"window":{

"defaulttitle": "支付宝接口功能演示"

}

ext.json

中的配置字段分为两种：

●

特有的字段

●

同

app.json

相同的字段

extenable

是一个 boolean 类型的字段，用于规定当前的

ext.json

文件是否生效，开发者可以通过修改这个字段来开启和关闭 ext 中的 appid 的结合开发。

ext

字段是开发自定义的数据字段，用于配置商家小程序的个性化内容，例如上文示例。通过

my.getextconfigsync

就可以获得

ext

字段的所有配置。

extpages

是一个对象，对象中的每个 key 应该是该小程序模板

app.json

中定义的页面，每个 key 对应的 value 是 page.json 中所规定的各项配置。当开发者设置这个配置以后，小程序框架会对应的修改相对应的 page 的配置信息。

示例代码

常见报错

报错	凯发app官方网站的解决方案
系统繁忙	检查 biz_content 参数，传入的参数应该为一个 json 字符串，可查看 alipay.open.mini.version.upload（小程序基于模板上传版本）的示例。

查询小程序模板和商家小程序的版本信息

●

小程序模板：调用

alipay.open.mini.version.list.query

（小程序版本列表查询）接口，在 app_auth_token 中传入小程序模板授权给第三方应用的授权令牌，可查询到小程序模板的所有版本的基础信息。

●

商家小程序：调用

alipay.open.mini.version.list.query

（小程序版本列表查询）接口，在 app_auth_token 中传入商家小程序授权给第三方应用的授权令牌，可查询到商家小程序的所有版本的基础信息。

查询商家小程序构建状态

完成构建商家小程序后，需调用

alipay.open.mini.version.build.query

（小程序查询版本构建状态）接口，轮询小程序版本构建状态。

当返回结果中 create_status 为

，则说明小程序版本创建成功。

删除商家小程序版本

只有状态为

开发中

的版本才能被删除，默认最多允许 20 个开发中的版本。若超出，调用

alipay.open.mini.version.delete

（小程序删除版本）接口删除废弃的版本。

体验构建的小程序

当调用

alipay.open.mini.version.build.query

（小程序查询版本构建状态）接口返回参数

create_status

为

后，可调用小程序生成体验版接口，生成体验版小程序供服务商和商家进行检查预览。

操作步骤

生成商家小程序体验版，调用接口

alipay.open.mini.experience.create

（小程序生成体验版）。

查询商家小程序体验版状态，调用接口

alipay.open.mini.experience.query

（小程序体验版状态查询）。

通过接口响应参数

exp_qr_code_url

，获得二维码链接，点击扫码，即可体验商家小程序。

说明

：如果扫体验码提示没有此功能，调用接口

alipay.open.app.members.create

（应用添加成员），添加开发者或体验者。

取消商家小程序体验版，调用接口

alipay.open.mini.experience.cancel

（小程序取消体验版）。

相关问题