1: 开发准备:
- 基础库:2.1.0(插件包含页面)
- 参考文档
- 小程序开发文档-开放范围及服务类目 developers.weixin.qq.com/miniprogram…
- 插件调用 API 的限制 developers.weixin.qq.com/miniprogram…
注意事项
- 小程序账
- 一个小程序账号只能申请一个插件,一个插件也只能有一个appid。
- 申请小程序插件的名称和头像设置完毕之后不能修改.
- 小程序开发者无需重新注册帐号,可直接在小程序管理后台开通插件功能,完成基本信息填写后完成开通。
- 注意不要使用已存在的小程序的文件夹名称,会影响现在的小程序功能。
- 服务类目, 审核
- 插件开发完毕之后和小程序一样需要填写服务类目, 审核, 审核通过之后才能发布, 其他小程序才能接入。
- 接入需要小程序在第三方服务---添加插件—查找插件中搜索需要的插件, 然后添加, 添加完毕需要插件提供方同意才能允许接入。
- 一般为24个小时的等待时间.
- 请求服务器域
- 插件比小程序能调用的接口要少一些, 具体见插件使用api列表, 组件列表,
- 插件可以设置自己的请求服务器域名, 与小程序的请求域名相互独立, 可以为小程序提供完整的一套功能
- 开发和调试
- 开发者可在开发者工具内上传代码并在小程序插件开发助手内完成插件的开发和调试- - 请注意:插件暂不支持在体验版中体验
- 小程序插件不允许插件直接调用部分API
- 使用wx.login和wx.getUserInfo接口,需要使用插件功能页的形式来获取登录的code和用户信息, 所以 需要在插件使用者的小程序app.json中加入 "functionalPages": true 插件需要一个按钮来跳转到该页面来获取这些信息
- 插件的请求域名列表与小程序相互独立;
- 一些 API 不允许插件调用(这些函数不存在于 wx 对象下)。
- 插件开通入口:小程序管理后台-小程序插件
2: 目录结构
- plugin 目录:插件代码目录。
- miniprogram 目录:放置一个小程序,用于调试插件。
- doc 目录:用于放置插件开发文档。
- 这个文件用于书写插件文档,引用图片时必须以相对路径引用 doc 目录下的本地图片,不能使用网络图片或非 doc 目录下的图片。以下是相对路径的引用示例:
- 使用编辑器下方的上传按钮可以上传插件文档,上传的内容包括 doc 目录下的 README.md 和图片。
组件使用没有问题; 全页面组件的打开方式和传参数实现;
3:小程序插件(普通插件)
本地开发
- 接入小程序功能,设置小程序名称和头像
- 设置小程序token:
- 完善基本信息------待完善
- 插件开发文档编辑、上传
- 设置服务器域名
- 上传开发版小程序插件--获取开发版本号
- 本地miniprogram目录申请使用开发版本号预览插件,调试,小程序后端同意;
- 提前用demomoni的标准版项目发布"functionalPages":true,的插件所有者小程序;
- 发布插件(所有version更改为线上版本)
- 第三方小程序申请引用插件;
- 按照小程序插件开发文档引用相关页面和API;
发布与审核
插件引用
1.使用须知
组件和页面:
- 组件:插件内部或是暴露给小程序页面使用;
- 页面:插件内部跳转或是在小程序当前页面内使用navigator跳转;
开发版小程序引用了开发版插件,此时这个小程序就不能上传发布了。必须要将插件版本设为正式版本之后,小程序才可以正常上传、发布
1.1 小程序后台添加插件
使用插件的第一步,您需要先前往自己的小程序管理后台,在“设置-第三方服务-插件管理”中,通过插件的appid查找插件并添加。
1.2 声明插件
接着,则需要在使用到该插件的小程序的app.json文件当中声明插件,代码示例如下:
{
...,
"plugins": {
"hello-plugin": {
"version": "dev-插件开发时的最新版本号",
"provider": "插件的appid"
}
},
...
}
并在引用本插件的的页面对应的json文件,比如index.json中引入插件
{
...,
"usingComponents": {
"hello-list": "plugin://hello-plugin/hello-component"
},
...
}
接着在页面对应的wxml文件,比如index.wxml当中使用标签