新手入门章节将会带领大家如何从零开始将知晓云接入小程序中。
在本章节中,你将会学到以下内容:
-
小程序注册指引
-
知晓云账号注册
-
创建第一个接入知晓云的小程序
在使用知晓云之前,请先确保按照微信官方指引完成小程序注册流程。
开发者在微信公众平台申请到自己的小程序后,接下来就可注册并获取知晓云账号,完成相关信息绑定与服务配置后,即可使用知晓云提供的后端服务。
前往知晓云注册知晓云账号。
成功注册后,页面将跳转至控制台,需要用户进一步完成邮箱激活验证和企业信息设置等步骤。
完成以上步骤,即可进入知晓云 dashboard 页。
danger 如果注册或邮件激活失败,请开发者根据失败提示进行后续操作。如果开发者认为是服务提供方方面导致的失败,请邮件联系
[email protected]
,我们会第一时间处理您的邮件。
为了使用知晓云提供的后端服务,进入 dashboard 后,开发者首先需要为知晓云授权。
知晓云在设置模块提供了一键授权功能,用户只需在应用“导览”页中找到微信小程序平台,点击立即接入,接着在“设置-微信”页中点击立即授权并在新开授权回调页完成授权即可。
至此,我们就完成了微信小程序对知晓云的第三方授权。
{% tabs SDKPluginConfig="SDK 插件版接入(推荐)", SDKFileConfig="SDK 文件版接入" %}
{% content "SDKPluginConfig" %}
插件版 SDK 将占用一个小程序插件名额(同一个小程序同时仅可使用 5 个插件)。
插件版 SDK 1.5.1 以上需小程序基础库 2.1.0 及以上。
下面,我们以我的书架小程序 demo 为例,创建第一个接入知晓云的小程序。
首先,打开微信开发者工具,将先前下载好的演示 demo 的 hello-world
文件夹添加入小程序项目中。
其中 AppID
为小程序的 ID,在微信小程序后台设置 >> 开发设置 中可获取,知晓云也在[设置模块的小程序面板](https://cloud.minapp.com/dashboard/#/app/[[app_id | addSlashPostfixIfNotEmpty]]settings/app/)提供了快速通道获取小程序 ID。
"plugins": {
"sdkPlugin": {
"version": "{{ book.latestVersionWechatPlugin }}",
"provider": "wxc6b86e382a1e3294"
}
}
通过初始化 SDK,知晓云服务可以验证当前的小程序是否是有效合法的,只有通过验证的小程序才能使用 SDK 提供的全部功能。
在知晓云后台 - [设置模块的小程序面板](https://cloud.minapp.com/dashboard/#/app/[[app_id | addSlashPostfixIfNotEmpty]]settings/info/),可获取要接入知晓云服务的小程序 ClientID
, 按照如下方式进行 SDK 初始化:
// app.js
App({
onLaunch: function() {
wx.BaaS = requirePlugin('sdkPlugin')
//让插件帮助完成登录、支付等功能
wx.BaaS.wxExtend(wx.login,
wx.getUserInfo,
wx.requestPayment)
let clientID = '[[client_id]]' // 应用名称: [[app_name]]
wx.BaaS.init(clientID)
}
})
完成知晓云的初始化配置后,开发者就可以根据自身应用的业务逻辑,确定所需的数据表,确定好后即可在知晓云后台 >> 数据管理模块开始数据表的创建工作。
以我的书架为例,在数据管理模块,创建一张名为 bookshelf
的数据表,并添加一个名为 bookName
的数据列。
完成数据表的创建后,我们现在就可以使用知晓云的数据管理模块的功能,对数据进行 CRUD 操作。
创建第一本书
// pages/index.js
Page({
data: {
creatingBookName: '',
},
// 绑定添加书目的提交按钮点击事件,向服务器发送数据
createBook(e) {
let bookName = this.data.creatingBookName // 缓存在 data 对象中的输入框输入的书名
let Books = new wx.BaaS.TableObject('bookshelf') //实例化对应 tableName 的数据表对象
let book = Books.create() // 创建一条记录
// 调用创建数据项接口,进行数据的持久化存储,详见:https://doc.minapp.com/js-sdk/schema/create-record.html
book.set({bookName})
.save()
.then(() => {
//...
})
}
})
info 注意,上述代码可能和
hello-world
源码有一定的差异,但是代码的逻辑和接口的调用方式基本上是一样。
同时,我们可以在数据管理模块看到新增的数据项。
至于更新书名和删除书籍等操作,其接口调用过程大致和创建书籍一样,这里就不再赘述,详见演示 demo的源码。
{% content "SDKFileConfig" %}
完成授权后,使用本地文件版 SDK 的用户需要进行服务器域名配置,以解锁小程序 SDK 服务。SDK 文件下载
登录小程序后台,进入 “设置 - 开发设置”页面,将知晓云提供给开发者的服务器域名配置到微信开发者后台的“服务器域名”配置项中。
下面,我们以我的书架小程序 demo 为例,创建第一个接入知晓云的小程序。
首先,打开微信开发者工具,将先前下载好的演示 demo 的 hello-world
文件夹添加入小程序项目中。
其中 AppID
为小程序的 ID,在微信小程序后台设置 >> 开发设置 中可获取,知晓云也在[设置模块的小程序面板](https://cloud.minapp.com/dashboard/#/app/[[app_id | addSlashPostfixIfNotEmpty]]settings/app/)提供了快速通道获取小程序 ID。
接下来,在 app.js
中引入 SDK js 文件( 如果使用知晓云 SDK 小程序插件则参考插件的[使用文档](/js-sdk/README.md#引入 SDK 并初始化) )。
// app.js
App({
onLaunch() {
// 引入 SDK
require('./sdk-v{{ book.latestVersionWechat }}')
}
})
最后,通过初始化 SDK,知晓云服务可以验证当前的小程序是否是有效合法的,只有通过验证的小程序才能使用 SDK 提供的全部功能。
在知晓云后台 - [设置模块的小程序面板](https://cloud.minapp.com/dashboard/#/app/[[app_id | addSlashPostfixIfNotEmpty]]settings/info/),可获取要接入知晓云服务的小程序 ClientID
, 按照如下方式进行 SDK 初始化:
// app.js
App({
onLaunch() {
// 引入 SDK
require('./sdk-v{{ book.latestVersionWechat }}')
// 初始化 SDK
let clientID = '[[client_id]]' // 应用名称: [[app_name]]
wx.BaaS.init(clientID)
}
})
完成知晓云的初始化配置后,开发者就可以根据自身应用的业务逻辑,确定所需的数据表,确定好后即可在知晓云后台 >> 数据管理模块开始数据表的创建工作。
以我的书架为例,在数据管理模块,创建一张名为 bookshelf
的数据表,并添加一个名为 bookName
的数据列。
完成数据表的创建后,我们现在就可以使用知晓云的数据管理模块的功能,对数据进行 CRUD 操作。
创建第一本书
// pages/index.js
Page({
data: {
creatingBookName: '',
},
// 绑定添加书目的提交按钮点击事件,向服务器发送数据
createBook(e) {
let bookName = this.data.creatingBookName // 缓存在 data 对象中的输入框输入的书名
let Books = new wx.BaaS.TableObject('bookshelf') //实例化对应 tableName 的数据表对象
let book = Books.create() // 创建一条记录
// 调用创建数据项接口,进行数据的持久化存储,详见:https://doc.minapp.com/js-sdk/schema/create-record.html
book.set({bookName})
.save()
.then(() => {
//...
})
}
})
info 注意,上述代码可能和
hello-world
源码有一定的差异,但是代码的逻辑和接口的调用方式基本上是一样。
同时,我们可以在数据管理模块看到新增的数据项。
至于更新书名和删除书籍等操作,其接口调用过程大致和创建书籍一样,这里就不再赘述,详见演示 demo的源码。
{% endtabs %}