只要 5 分鐘，讓你立刻擁有自己的小程序 | 知曉雲

Hello，各位知曉程序的讀者們，我是犯迷糊的小羊。目前是 ifanr 的一隻前端攻城獅，同時也是知曉雲團隊的一員。

8 月 8 日，ifanr 旗下品牌——知曉雲（cloud.minapp.com）正式上線，得到業內許多開發者的密切關注和積極支持，在此，我代表知曉雲團隊表示萬分感謝哈。(￣▽￣)~*

「知曉雲」是國內第一個專註於微信小程序開發的 BaaS（Backend as a Service）產品，它能幫開發人員一次性解決後端的麻煩事。

言歸正傳。和許多童鞋一樣，小羊使用知曉雲時，也是第一次開發小程序，開發過程也是百轉曲折。

因此，小羊希望通過這篇文章的分享，和各位童鞋進行思想的碰撞與知識的交流，因為大家的學習歷程是相似的，遇到的困惑也有一定的共通性。

本文結構大致如下：

• 首先，簡明扼要談談如何成為小程序開發者。
• 其次，大體說說如何創建我的第一個小程序。
• 最後，以知曉雲官方的一個 demo 詳細分享一下，如何在小程序中接入和使用知曉雲的 SDK。

如何成為一名小程序開發者？

申請成為小程序開發者，是一件再簡單不過的事兒，僅需 2 步，比把大象放進冰箱還簡單。

第一步，登錄微信公眾平台，註冊成為小程序開發用戶。此過程微信要你依次完成賬號信息、郵箱激活和信息登記等流程。

第二步，完成上述操作後，就能進入小程序管理後台，進入設置模塊，獲取開發小程序的 AppID。恩，現在小羊已經是一枚准小程序開發者啦。

關注「知曉程序」微信公眾號，在微信後台回復「0327」，了解個人註冊小程序詳細步驟。

獲得了「准入資格」後，小羊開始參照小程序官方文檔，下載官方的開發者工具並創建了一個初始化的小程序。

關注「知曉程序」微信公眾號，在微信後台回復「我要用工具」，獲取微信 web 開發者工具使用方法、下載地址。

Well done！小羊的第一個初始化小程序誕生了，喜大普奔。╰(￣▽￣)╭

接下來，拿瓶益力多一邊吮吸一邊看看小程序官方的簡易教程文檔，熟悉一下小程序代碼組織方式和開發特性。

關注「知曉程序」微信公眾號，在微信後台回復「小程序文檔」，獲取小程序官方簡易教程和技術文檔。

有了開發工具和基礎知識積累，好吧，可以表演 freestyle 咯。

問題又來了：選擇什麼類型的小程序開發呢？

當時小羊開發的第一個小程序，是作為知曉雲的 demo 給各位童鞋熟悉產品介面使用的，因此小羊心目中的小程序應該是精簡的。

• 「簡」是像小羊這樣的小白開發者一看就懂。
• 「精」是儘可能在有限的代碼中，體現知曉雲功能的強大性。

於是，我整了個經典的 TodoMVC 的小程序——「我的書架」。

「我的書架」這個 demo 基本將知曉雲的核心模塊之一——數據管理的 CRUD 操作基本予以展示，通過這個 demo 能夠讓各位童鞋學會常見的數據增刪改查功能。

在正式使用知曉雲的 SDK 前，首先確保走完以下 2 個流程：

第一步，在知曉雲創建的應用後，完成小程序的授權。

目前，知曉雲在註冊模塊和設置模塊都有提供小程序授權操作，二者的授權流程大體一致。在這裡，我們演示設置模塊的小程序操作。

首先，點擊應用標籤，進入應用的管理面板。

進入管理面板後，切換到設置模塊並進入小程序設置 tab 頁，點擊授權小程序按鈕即可完成授權。

第二步，授權成功後，在「小程序後台」配置安全域名。

2. 裝載 SDK

接下來，看看知曉雲的 SDK 的使用說明文檔。老夫掐指一算，將 SDK 的接入小程序的方法和數據表操作看了一遍，約莫花費 10 分鐘。

關注「知曉程序」微信公眾號，在微信後台回復「知曉雲」，獲取知曉雲 SDK 下載地址，以及知曉雲相關文檔。

畢竟 demo 只涉及數據操作嘛，所以要做到有的放矢，要啥看啥。

下載知曉雲提供的 SDK 後，將其引入小程序的 app.js 中，並通過在前面的設置模塊的小程序設置 tab 頁中獲取當前應用的 ClientID。

// app.js
App({
onLaunch: function {
// 引入 BaaS SDK
require("./utils/sdk-v1.0.10.js")
// 從 BaaS 後台獲取 ClientID
let clientId = "xxx" // 從 baas 後台獲取
// initialize
wx.BaaS.init(clientId)
}
})

3. 設計數據結構和創建數據表

完成上述操作後，小羊就可以使用 SDK 提供的各種介面，接下來思考一下「我的書架」將用到什麼數據及其結構。

由於是第一個 demo ，本著精簡的原則，小羊在此就只設計了一個 bookName的欄位

Tips：知曉雲的數據管理模塊會為每張數據表自動創建 id，create_by，create_at，update_at和acl等欄位。

根據文檔提示，在使用知曉雲的數據管理模塊時，需要首先提供存放數據的 tableID。因此，首先要在知曉雲開發者平台創建數據表從而獲取 tableID。

獲取 tableID 後，小羊將其放在了 pages/index/index.js 文件的 data 對象上，以供後面各種數據操作介面的參數調用。

// pages/index/index.js
Page({
data: {
tableID: 747, // 從 https://cloud.minapp.com/dashboard/ 管理後台的數據表中獲取
}
})

開始使用知曉雲的 SDK

小羊在這裡不會細談「我的書架」是如何編寫的，因為不同的童鞋的對這個 demo 的實現方式可能不一。

在這裡，小羊只談談在哪些控制項當中使用到知曉雲提供的介面，來實現小羊的需求。

小羊的需求很簡單，「我的書架」首要功能就是可以添加一本書。

翻查了文檔，發現創建一條記錄很簡單，只需要調用 wx.BaaS.createRecord介面，並傳入特定數據結構的參數即可。

// create a book
let tableID = this.data.tableID
let bookName = this.data.creatingBookName
if (!bookName) return
let data = {
bookName: bookName,
}
let objects = {
tableID,
data
}
// create a record
wx.BaaS.createRecord(objects).then((res) => {
// some code here...
}, (err) => {})

有時，小羊手抖，在輸入書目的時候填寫了錯別字，那麼理應提供一個更新記錄的功能吧；

知曉雲提供了 wx.BaaS.updateRecord介面，讓更新數據 so easy。

let tableID = 747
let recordID = 88
let bookName = "黑客與畫家"
let data = {
bookName: bookName,
}
let objects = {
tableID,
recordID,
data
}
wx.BaaS.updateRecord(objects)
.then((res) => {
// some code here...
}, (err) => { })

最後，當小羊的書架不再存在某本書時，必然需要一個刪除操作。通過調用 wx.BaaS.deleteRecord，就可以實現一條記錄的刪除操作。

let tableID = 747
let recordID = 88
let objects = {
tableID,
recordID
}
wx.BaaS.deleteRecord(objects)
.then((res) => {
// some code here...
}, (err) => {})

後記

以上就是小羊用知曉雲烹調出的第一個小程序——「我的書架」，最主要就是用到了知曉雲的數據管理功能模塊。

當然，知曉雲還提供作為 BaaS 產品的基礎文件上傳和數據統計功能等，同時具備貼切小程序的特性功能，譬如微信支付和富文本編輯功能。

除了「我的書架」 demo 外，知曉雲官方還提供這些 demo：

• lbs-demo，用於演示稍微複雜的業務實現。
• payment-demo，用於展示 SDK 的在線支付的特性支持。

這些代碼已開源在 GitHub 上，有興趣的童鞋可以 star 或是 fork 一下。

關注「知曉程序」微信公眾號，在微信後台回復「源碼」，獲取本項目源碼地址。

Anyway，耐著性子聽完小羊的聒噪的童鞋還有問題的話，可以第一時間諮詢知曉雲團隊的溫柔、可愛的曉雲妹子（微信號：minsupport），她會為你一一解答哈。

小雲妹子註：如果你看著這篇文章仍然不知道怎麼操作的話，可以添加我時備註「SDK」，我會把你拉入新手群，由小羊同學親自教你如何快速接入 SDK 噢。

實踐證明，用了知曉雲，王者農藥小羊多 A 了幾局，可以有空看看中國有嘻哈，學幾段 freestyle 啦。

關注「知曉程序」公眾號，在微信後台回復「開發」，獲取小程序開發技巧精選文章。

喜歡這篇文章嗎？立刻分享出去讓更多人知道吧！