新手入门

新手入门章节将会带领大家如何从零开始将知晓云接入小程序中。

在本章节中，你将会学到以下内容：

  • 小程序注册指引

  • 知晓云账号注册

  • 创建第一个接入知晓云的小程序

小程序注册指引

在使用知晓云之前，请先确保按照微信官方指引完成小程序注册流程。

知晓云账号注册

开发者在微信公众平台申请到自己的小程序后，接下来就可注册并获取知晓云账号，完成相关信息绑定与服务配置后，即可使用知晓云提供的后端服务。

注册并完成相关信息绑定

前往知晓云注册知晓云账号。

成功注册后，页面将跳转至控制台，需要用户进一步完成邮箱激活验证和企业信息设置等步骤。

完成以上步骤，即可进入知晓云 dashboard 页。

如果注册或邮件激活失败，请开发者根据失败提示进行后续操作。如果开发者认为是服务提供方方面导致的失败，请邮件联系 mincloud@ifanr.com，我们会第一时间处理您的邮件。

小程序第三方授权

为了使用知晓云提供的后端服务，进入 dashboard 后，开发者首先需要为知晓云授权。

知晓云在设置模块提供了一键授权功能，用户只需在应用“导览”页中找到微信小程序平台，点击立即接入，接着在“设置-微信”页中点击立即授权并在新开授权回调页完成授权即可。

开通微信小程序平台开通微信小程序平台

一键授权一键授权

至此，我们就完成了微信小程序对知晓云的第三方授权。

插件版 SDK 将占用一个小程序插件名额（同一个小程序同时仅可使用 5 个插件）。

插件版 SDK 1.5.1 以上需小程序基础库 2.1.0 及以上。

第一个接入知晓云的小程序

下面，我们以我的书架小程序 demo 为例，创建第一个接入知晓云的小程序。

1、 知晓云的初始化配置

首先，打开微信开发者工具，将先前下载好的演示 demo 的 hello-world 文件夹添加入小程序项目中。

创建小程序项目创建小程序项目

其中 AppID 为小程序的 ID，在微信小程序后台设置 >> 开发设置 中可获取，知晓云也在设置模块的小程序面板提供了快速通道获取小程序 ID。

开发者 ID开发者 ID

在 app.json 中加入插件的引用声明

  2. "plugins": {
  3.   "sdkPlugin": {
  4.     "version": "3.6.0",
  5.     "provider": "wxc6b86e382a1e3294"
  6.   }
  7. } 
  8.  

添加插件引用添加插件引用

在 app.js 文件中完成 SDK 的初始化

通过初始化 SDK，知晓云服务可以验证当前的小程序是否是有效合法的，只有通过验证的小程序才能使用 SDK 提供的全部功能。

在知晓云后台 - 设置模块的小程序面板，可获取要接入知晓云服务的小程序 ClientID, 按照如下方式进行 SDK 初始化:

复制 clientID复制 clientID

  1. // app.js
  2. App({
  3.   onLaunch: function() {
  4.     wx.BaaS = requirePlugin('sdkPlugin')
  5.     //让插件帮助完成登录、支付等功能
  6.     wx.BaaS.wxExtend(wx.login,
  7.      wx.getUserInfo,
  8.      wx.requestPayment)
  10.     let clientID = '[[client_id]]'  // 应用名称: [[app_name]]
  11.     wx.BaaS.init(clientID)
  12.   }
  13. })

2、创建数据表

完成知晓云的初始化配置后，开发者就可以根据自身应用的业务逻辑，确定所需的数据表，确定好后即可在知晓云后台 >> 数据管理模块开始数据表的创建工作。

以我的书架为例，在数据管理模块，创建一张名为 bookshelf 的数据表，并添加一个名为 bookName 的数据列。

创建表创建表

添加列添加列

3、SDK 数据操作接口使用示例

完成数据表的创建后，我们现在就可以使用知晓云的数据管理模块的功能，对数据进行 CRUD 操作。

创建第一本书

  1. // pages/index.js
  2. Page({
  3.   data: {
  4.     creatingBookName: '',
  5.   },
  7.   // 绑定添加书目的提交按钮点击事件，向服务器发送数据
  8.   createBook(e) {
  9.     let bookName = this.data.creatingBookName // 缓存在 data 对象中的输入框输入的书名
  10.     let Books = new wx.BaaS.TableObject('bookshelf') //实例化对应 tableName 的数据表对象
  11.     let book = Books.create() // 创建一条记录
  13.   // 调用创建数据项接口，进行数据的持久化存储，详见：https://doc.minapp.com/js-sdk/schema/create-record.html
  14.     book.set({bookName})
  15.       .save()
  16.       .then(() => {
  17.         //...
  18.       })
  19.   }
  20. })

注意，上述代码可能和 hello-world 源码有一定的差异，但是代码的逻辑和接口的调用方式基本上是一样。

同时，我们可以在数据管理模块看到新增的数据项。

bookshelf 数据表bookshelf 数据表

至于更新书名和删除书籍等操作，其接口调用过程大致和创建书籍一样，这里就不再赘述，详见演示 demo的源码。

完成授权后，使用本地文件版 SDK 的用户需要进行服务器域名配置，以解锁小程序 SDK 服务。SDK 文件下载

知晓云服务器域名知晓云服务器域名

知晓云服务器域名知晓云服务器域名

登录小程序后台，进入 “设置 - 开发设置”页面，将知晓云提供给开发者的服务器域名配置到微信开发者后台的“服务器域名”配置项中。

小程序服务器域名配置小程序服务器域名配置

第一个接入知晓云的小程序

下面，我们以我的书架小程序 demo 为例，创建第一个接入知晓云的小程序。

1、 知晓云的初始化配置

首先，打开微信开发者工具，将先前下载好的演示 demo 的 hello-world 文件夹添加入小程序项目中。

创建小程序项目创建小程序项目

其中 AppID 为小程序的 ID，在微信小程序后台设置 >> 开发设置 中可获取，知晓云也在设置模块的小程序面板提供了快速通道获取小程序 ID。

开发者 ID开发者 ID

接下来，在 app.js 中引入 SDK js 文件（ 如果使用知晓云 SDK 小程序插件则参考插件的使用文档 ）。

  2. // app.js
  4. App({
  5.   onLaunch() {
  6.     // 引入 SDK
  7.     require('./sdk-v3.7.0')
  8.   }
  9. })
  10.  

最后，通过初始化 SDK，知晓云服务可以验证当前的小程序是否是有效合法的，只有通过验证的小程序才能使用 SDK 提供的全部功能。

在知晓云后台 - 设置模块的小程序面板，可获取要接入知晓云服务的小程序 ClientID, 按照如下方式进行 SDK 初始化:

  2. // app.js
  3. App({
  4.   onLaunch() {
  5.     // 引入 SDK
  6.     require('./sdk-v3.7.0')
  8.     // 初始化 SDK
  9.     let clientID = '[[client_id]]'  // 应用名称: [[app_name]]
  10.     wx.BaaS.init(clientID)
  11.   }
  12. })
  13.  

2、创建数据表

完成知晓云的初始化配置后，开发者就可以根据自身应用的业务逻辑，确定所需的数据表，确定好后即可在知晓云后台 >> 数据管理模块开始数据表的创建工作。

以我的书架为例，在数据管理模块，创建一张名为 bookshelf 的数据表，并添加一个名为 bookName 的数据列。

创建表创建表

添加列添加列

3、SDK 数据操作接口使用示例

完成数据表的创建后，我们现在就可以使用知晓云的数据管理模块的功能，对数据进行 CRUD 操作。

创建第一本书

  1. // pages/index.js
  2. Page({
  3.   data: {
  4.     creatingBookName: '',
  5.   },
  7.   // 绑定添加书目的提交按钮点击事件，向服务器发送数据
  8.   createBook(e) {
  9.     let bookName = this.data.creatingBookName // 缓存在 data 对象中的输入框输入的书名
  10.     let Books = new wx.BaaS.TableObject('bookshelf') //实例化对应 tableName 的数据表对象
  11.     let book = Books.create() // 创建一条记录
  13.   // 调用创建数据项接口，进行数据的持久化存储，详见：https://doc.minapp.com/js-sdk/schema/create-record.html
  14.     book.set({bookName})
  15.       .save()
  16.       .then(() => {
  17.         //...
  18.       })
  19.   }
  20. })

注意，上述代码可能和 hello-world 源码有一定的差异，但是代码的逻辑和接口的调用方式基本上是一样。

同时，我们可以在数据管理模块看到新增的数据项。

bookshelf 数据表bookshelf 数据表

至于更新书名和删除书籍等操作，其接口调用过程大致和创建书籍一样，这里就不再赘述，详见演示 demo的源码。