前提
为了给多个餐饮商家提供自己的小程序,并且支持商家DIY小程序首页、订单、购物车、我的等页面。需要我们给出一套解决方案。如果按照传统开发模式:一个小程序一个工程。待客户量上来之后,代码的组织与管理,将会是一个灾难。所以我开始调研三方开发,以支持多个客户的小程序定制化需求。
三方开发 = 服务平台(web端) + 小程序通用模板(微信端)
三方服务脑图
下从图可知,我们需要设计开发的部分,主要是三方服务平台的搭建
和小程序通用模板的开发
这两块。其中涉及到的一些重点流程,我会在下面展开。
- 三方服务平台: 自建的web端工程,提供小程序的授权、配置、提审、发布、装修等功能;
- 小程序通用模板: 自建的模板小程序,提供读取ext.json文件、拉取装修数据、拉取业务数据等功能;
小程序授权、发布流程
image.png服务平台(web端)
创建小程序
- 首先需要客户先注册好自己的小程序
获取预授权码
- 后台通过微信提供的API启动票据推送服务,获取
component_verify_ticket
; - 后台通过票据获取令牌
component_access_token
,有效期2小时,快过期时记得刷新; - 通过令牌获取预授权码
pre_auth_code
客户扫码授权
- web端需要开发一个授权的按钮,用户点击后,向后端发起请求,获取微信授权URL,并跳转到URL对应授权页面;
- 客户扫码进行授权成功后,页面会根据传入的
redirect_uri
自动返回对应页面。并将authorization_code
等信息作为query
。 - 最后拿刚刚得到的授权码获取接口调用令牌(authorizer_access_token),此令牌很重要,用于后面代码上传、提审、发布等接口。
配置小程序
授权完成后,我们在web端就可以通过后台包装的小程序列表接口,获取到已授权的小程序列表,如下图:
image.png这样就为客户在web端配置小程序提供了入口。注意此处配置小程序的过程,其实是生成extJson,并通代码上传接口,上传代码的过程。
extJson中的配置信息分两种:
- 特有字段
-
extEnable
:配置 ext.json 是否生效 -
extAppid
:授权给第三方平台的小程序ID -
ext
:开发自定义的数据字段 - ...
-
- 与 app.json 相同的字段
- window
- tabbar
- ...
目前我们主要关注特有字段中的 ext
字段。我司在web端配置小程序页面(这部分需要各位根据需求自己DIY了),设置的tabbar
标题图片、小程序肤色、版本等信息,都被保存在这个字段中:
保存配置后,通过代码上传接口将刚刚extJson
信息上传到微信后台服务。这样微信会自动生成ext.json
文件,并根据 小程序模板(这个后面再讲) 的templateID
和user_version
,将ext.json
与小程序模板进行绑定。
这样我们通过扫描生成的体验二维码,在小程序模板启动时,通过调用wx.getExtConfigSync
方法读取到ext.json
文件中的ext
部分信息。从而拿到肤色、tabbar等相关数据。(注意此处不需要走完提审、发布流程!!!)
提审、发布小程序
配置完小程序后,点击列表上的提审、发布按钮,对刚刚生成的配置信息(extJson)
进行提审、发布等操作。
审核通过并发布后,我们就可以通过在微信端搜索小程序名称,找到刚刚发布的小程序啦。(以上前提是三方平台已经全网发布审核通过,微信模板小程序代码也已经添加到模板库。详情见下面的小程序模板部分)
小程序装修
配置完小程序后,客户就可以在web端对小程序的部分页面进行装修。
由于目前的需求是首页
、我的
两个页面需要装修,所以我们在web端模拟出这两个页面。客户可以在上面对页面的模块进行添加、删除、修改样式等操作。
生成的装修数据保存在后端,在小程序启动时拉取装修数据,解析并渲染页面即可。
小程序模板(微信端)
基于Taro框架开发
注册三方资质
- 根据文档内容,在微信开放平台,创建第三方平台账号;
- 再注册一个小程序,获取 appid,并将其作为模板小程序进行后面的开发;
- 在第三方平台 - 开发配置中,绑定刚刚注册好的模板小程序账号;
开发小程序模板
这部分就是基于上面第二部申请的小程序,进行正常的小程序开发。
需要注意在小程序启动时:
- 需要调用
wx.getExtConfigSync
方法读取到ext.json
文件中的ext
部分信息; - 调用后台接口,获取装修数据,在页面渲染时作为样式信息使用;
所以封装组件时,要考虑好如何支持 Web 端配置的 小程序装修数据
和 ext.json
中的tabbar
样式数据 ,此处各位自由发挥蛤 ~
小程序模板发布
编译完小程序后,在微信开发者工具中点击上传
代码将会上传到第三方平台的草稿箱,是否继续?
此处与普通小程序开发不一样了!!!这里直接把模板代码上传到微信三方平台。
你可以在三方平台的草稿箱中查看刚刚上传的模板小程序。也可以将其添加到小程序模板库,即可看到生成的 templateID
。
调试
本地调试
由于模拟器无法获取微信平台上的 ext.json
文件。所以需要自己创建一个 ext.json
文件,放在项目根目录dist下。这样在模拟器启动时,就可以通过 wx.getExtConfigSync 方法获取其中的内容啦
参考文档
微信三方平台:上文所有内容,文档中均有详细说明!
网友评论