# 接入指南

## 微信小程序接入指南

### 引入 SDK 并初始化

使用知晓云 SDK 小程序插件，相对于引入 SDK js 文件方式，省去了下载 SDK 文件和配置服务器域名操作，同时可以更加方便的切换不同版本的 SDK。

#### 添加知晓云 SDK 小程序插件

在[小程序的管理后台](https://mp.weixin.qq.com/)【设置】-【第三方服务】-【插件管理】中添加插件，根据知晓云 SDK 小程序插件的 AppID 「**wxc6b86e382a1e3294**」搜索到我们的插件，添加后等待审核，审核通过即可使用。

#### 在项目配置中声明使用知晓云 SDK 小程序插件

> **info** 插件版 sdk 1.5.1 以上需小程序基础库 2.1.0 及以上。

在项目的配置文件 `app.json` 中对插件进行引入声明：

```js
"plugins": {
  "sdkPlugin": {
    "version": "{{ book.latestVersionWechatPlugin }}",
    "provider": "wxc6b86e382a1e3294"
  }
}
```

目前知晓云 SDK 小程序插件提供如下版本：

| 插件版 SDK 版本 | 对应 js 文件版 SDK 版本 |
| ---------- | ---------------- |
| 0.1.0      | v1.2.0           |
| 1.3.0 及之后  | 与文件版的版本号同步       |

#### 初始化 SDK

\{{ sdkInit.renderIntoPlatform('wechat') \}}

在\[知晓云后台 - 我的应用]\(https://cloud.minapp.com/dashboard/#/app/\[\[app\_id | addSlashPostfixIfNotEmpty]]settings/info/)页面获取要接入知晓云服务的小程序 ClientID, 按照如下方式进行 SDK 初始化:

```js
//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)
  }
})
```

#### 下载并导入 SDK

a. [下载最新版 SDK 到本地](../download-sdk)

b. 将下载解压后得到的 SDK js 文件放在小程序项目目录中

```js
// app.js
import './sdk-v{{ book.latestVersionWechat }}.js'

App({
  onLaunch() {
    ...
  }
})
```

#### 初始化 SDK

\{{ sdkInit.renderIntoPlatform('wechat') \}}

在\[知晓云后台 - 我的应用]\(https://cloud.minapp.com/dashboard/#/app/\[\[app\_id | addSlashPostfixIfNotEmpty]]settings/info/)页面获取要接入知晓云服务的小程序 ClientID, 按照如下方式进行 SDK 初始化:

```js
// app.js

App({
  onLaunch() {
    // 引入 SDK
    require('./sdk-v{{ book.latestVersionWechat }}')
     let clientID = '[[client_id]]'
     wx.BaaS.init(clientID)
  }
})
```

#### 完成服务器域名配置

在[这里](../../../newbies#小程序第三方授权以及服务器域名配置)可查看详细的配置方法。

#### 从 npm 上安装并使用 SDK 包

a. 安装

```
npm install minapp-sdk  // npm
yarn add minapp-sdk  // yarn
```

b. [构建 npm](https://developers.weixin.qq.com/miniprogram/dev/devtools/npm.html)

c. 引入

```js
// app.js

App({
  onLaunch() {
    // require SDK
    require('minapp-sdk')
  }
})
```

#### 初始化 SDK

\{{ sdkInit.renderIntoPlatform('wechat') \}}

在\[知晓云后台 - 我的应用]\(https://cloud.minapp.com/dashboard/#/app/\[\[app\_id | addSlashPostfixIfNotEmpty]]settings/info/)页面获取要接入知晓云服务的小程序 ClientID, 按照如下方式进行 SDK 初始化:

```js
// app.js

App({
  onLaunch() {
    // 引入 SDK
    require('minapp-sdk')
    let clientID = '[[client_id]]'
    wx.BaaS.init(clientID)
  }
})
```

#### 完成服务器域名配置

在[这里](../../../newbies#小程序第三方授权以及服务器域名配置)可查看详细的配置方法。

### 使用 SDK

通过 `wx.BaaS.init(clientID)` 成功初始化 SDK 后，即可使用 SDK 完成数据操作，内容操作等功能了。如下，在控制台创建一张表（参考[控制台操作-数据表](https://github.com/ifanrx/hydrogen-js-sdk-doc/blob/master/js-sdk/dashboard/schema.md) 一节），获取其 tableName ，并插入一条数据。

```js
let tableName = 'product'
let Product = new wx.BaaS.TableObject(tableName)
let product = Product.create()

let apple = {
  name: 'apple',
  price: 1,
  desc: ['good'],
  amount: 0
}

product.set(apple).save().then(res => {
  console.log('成功插入数据：', res)
}, err => {
  // err
})
```

更多内容，可查看以下功能模块介绍：

* [数据表](../schema)
* [内容库](../content)
* [支付](https://github.com/ifanrx/hydrogen-js-sdk-doc/blob/master/js-sdk/wechat/payment/README.md)
* [模板消息](template-message)
* [微信加密数据解密](wechat-decrypt)
