摘要：整套功能是基于騰訊云全新推出的云開發(fā)所研發(fā)出來的一套完備的小程序后臺開發(fā)方案。數(shù)據(jù)庫分為小程序端和服務(wù)端兩部分，小程序端擁有嚴(yán)格的調(diào)用權(quán)限控制，開發(fā)者可在小程序內(nèi)直接調(diào)用進行非敏感數(shù)據(jù)的操作。

李成熙，騰訊云高級工程師。2014年度畢業(yè)加入騰訊AlloyTeam，先后負責(zé)過QQ群、花樣直播、騰訊文檔等項目。2018年加入騰訊云云開發(fā)團隊。專注于性能優(yōu)化、工程化和小程序服務(wù)。微博 | 知乎 | Github

原文鏈接

小程序·云開發(fā)是微信團隊和騰訊云團隊共同研發(fā)的一套小程序基礎(chǔ)能力，簡言之就是：云能力將會成為小程序的基礎(chǔ)能力。整套功能是基于騰訊云全新推出的云開發(fā)(Tencent Cloud Base)所研發(fā)出來的一套完備的小程序后臺開發(fā)方案。

小程序·云開發(fā)為開發(fā)者提供完整的云端流程，簡化后端開發(fā)和運維概念，無需搭建服務(wù)器，使用平臺提供的 API 進行核心業(yè)務(wù)開發(fā)，即可實現(xiàn)快速上線和迭代。

該解決方案目前提供三大基礎(chǔ)能力支持：

存儲：在小程序前端直接上傳/下載云端文件，在小程序云控制臺可視化管理

數(shù)據(jù)庫：一個既可在小程序前端操作，也能在云函數(shù)中讀寫的文檔型數(shù)據(jù)庫

云函數(shù)：在云端運行的代碼，微信私有協(xié)議天然鑒權(quán)，開發(fā)者只需編寫業(yè)務(wù)邏輯代碼

未來，我們還會集成更多的服務(wù)能力，為小程序提供更強有力的云端支持。

上面就是小程序·云開發(fā)簡單的使用圖譜：在小程序端，直接用官方提供的接口，在云函數(shù)端，直接用官方提供的 Node SDK，就可以操作你云的資源。以前開發(fā)小程序所擔(dān)憂的數(shù)據(jù)庫搭建、文件系統(tǒng)部署，通通沒有。

你只需要有在小程序開發(fā) IDE 里面的 云開發(fā)，開通一下，填寫環(huán)境 ID，便可以擁有小程序的云能力！

當(dāng)然，其實用云開發(fā)，并不排斥原有的后臺架構(gòu)，通過下面的架構(gòu)，你也可以無縫與原有的后臺服務(wù)兼容，也簡化了一些小程序鑒權(quán)的邏輯：

接下來，我會分別從小程序端、服務(wù)端講述如何使用這些云資源。

客戶端，這里是指在小程序端中。如果要使用云開發(fā)能力，請做以下配置：

在 app.json / game.json 中， 中增加字段 "cloud": true

project.config.json 中增加了字段 cloudfunctionRoot 用于指定存放云函數(shù)的目錄

初始化云開發(fā)能力：

//app.js
App({
  onLaunch: function () {
    wx.cloud.init({
        traceUser: true // 用戶信息會顯示在云開發(fā)控制臺的用戶面板中
    });
  }
});

小程序端初始化能力文檔

在用戶管理中會顯示使用云能力的小程序的訪問用戶列表，默認(rèn)以訪問時間倒敘排列，訪問時間的觸發(fā)點是在小程序端調(diào)用 wx.cloud.init 方法，且其中的 traceUser 參數(shù)傳值為 true。

如果你想在云函數(shù)中，操作文件、數(shù)據(jù)庫和云函數(shù)資源，你可以使用我們提供的服務(wù)端 SDK 進行操作。首先，進入到你的某個云函數(shù)中，安裝以下依賴包：

npm i --save tcb-admin-node

在云函數(shù)中初始化

// 初始化示例
const app = require("tcb-admin-node");

// 初始化資源
// 云函數(shù)下不需要secretId和secretKey。
// env如果不指定將使用默認(rèn)環(huán)境
app.init({
  secretId: "xxxxx",
  secretKey: "xxxx", 
  env: "xxx"
});

//云函數(shù)下使用默認(rèn)環(huán)境
app.init()

//云函數(shù)下指定環(huán)境
app.init({
  env: "xxx"
});

服務(wù)端初始化文檔

云開發(fā)提供存儲空間、上傳文件、下載文件、CDN加速文件訪問等能力,開發(fā)者可以在小程序端與服務(wù)端通過 API 使用這些能力。

// 選擇圖片
wx.chooseImage({
    success: dRes => {
        // 上傳圖片
        const uploadTask = wx.cloud.uploadFile({
            cloudPath: `${Date.now()}-${Math.floor(Math.random(0, 1) * 10000000)}.png`, // 隨機圖片名
            filePath: dRes.tempFilePaths[0], // 本地的圖片路徑
            success: console.log,
            fail: console.error
        });
    },
    fail: console.error,
});

小程序端存儲文檔

const app = require("tcb-admin-node");
app.init();

app.uploadFile({
    cloudPath: "cover.png",
    fileContent: fs.createReadStream(`${__dirname}/cover.png`)
}).then((res) => {
    console.log(res);
}).catch((err) => {
    console.error(err);
});;

上傳好的文件，就會出現(xiàn)在控制臺中，如下圖。你可以在控制臺里刪除、下載或者查看圖片的詳情。

你還可以控文件整體的權(quán)限，這里還有一些具體的介紹。

服務(wù)端存儲文檔

小程序云提供文檔型數(shù)據(jù)庫 ( document-oriented database )，數(shù)據(jù)庫包含多個集合（相當(dāng)于關(guān)系型數(shù)據(jù)中的表），集合近似于一個 JSON 數(shù)組，數(shù)組中的每個對象就是一條記錄，記錄的格式是 JSON 文檔。

每條記錄都有一個 _id 字段用以唯一標(biāo)志這條記錄、一個 _openid 字段用以標(biāo)志記錄的創(chuàng)建者，即小程序的用戶。開發(fā)者可以自定義 _id，但不可在小程序端自定義（在服務(wù)端可以） _openid 。_openid 是在文檔創(chuàng)建時由系統(tǒng)根據(jù)小程序用戶默認(rèn)創(chuàng)建的，開發(fā)者可使用其來標(biāo)識和定位文檔。

數(shù)據(jù)庫 API 分為小程序端和服務(wù)端兩部分，小程序端 API 擁有嚴(yán)格的調(diào)用權(quán)限控制，開發(fā)者可在小程序內(nèi)直接調(diào)用 API 進行非敏感數(shù)據(jù)的操作。對于有更高安全要求的數(shù)據(jù)，可在云函數(shù)內(nèi)通過服務(wù)端 API 進行操作。云函數(shù)的環(huán)境是與客戶端完全隔離的，在云函數(shù)上可以私密且安全的操作數(shù)據(jù)庫。

數(shù)據(jù)庫 API 包含增刪改查的能力，使用 API 操作數(shù)據(jù)庫只需三步：獲取數(shù)據(jù)庫引用、構(gòu)造查詢/更新條件、發(fā)出請求。切記，在操作數(shù)據(jù)庫前，請先在控制臺中創(chuàng)建 collection。

const db = wx.cloud.database();

// 插入數(shù)據(jù)
db.collection("photo").add({
    data: {
        photo: "cloud://tcb-xxx/05ca1d38f86f90d66d4751a730379dfa6584dde05ab4-Ma9vMN_fw658.jpg",
        title: "風(fēng)景"
    }
});

// 提取數(shù)據(jù)
db.collection("photo").get().then((res) => {
    let data = res.data;
    console.log(data);
});

// 輸出
// 在小程序端， _openid 會自動插入到數(shù)據(jù)庫中
{
    photo: "cloud://tcb-xxx/05ca1d38f86f90d66d4751a730379dfa6584dde05ab4-Ma9vMN_fw658.jpg",
    title: "風(fēng)景",
    _openid: "oLlMr5FICCQJV-QgVLVzKu2312121"
}

小程序端數(shù)據(jù)庫文檔

const app = require("tcb-admin-node");
app.init();
const db = app.database();

db.collection("photo").limit(10).get().then((res) => {
    console.log(res);
}).catch((err) => {
    console.error(err);
});

// 輸出
// 因為是在服務(wù)端，其它用戶的也可以提取出來
{
    photo: "cloud://tcb-xxx/05ca1d38f86f90d66d4751a730379dfa6584dde05ab4-Ma9vMN_fw658.jpg",
    title: "風(fēng)景",
    _openid: "oLlMr5FICCQJV-QgVLVzKu4312121"
}
{
    photo: "cloud://tcb-xxx/0dc3e66fd6b53641e328e091ccb3b9c4e53874232e6bf-ZxSfee_fw658.jpg",
    title: "美女",
    _openid: "DFDFEX343xxdf-QgVLVzKu3312121"
}
{
    photo: "cloud://tcb-xxx/104b27e339bdc93c0da15a47aa546b6e9c0e3359c315-L8Px2Y_fw658.jpg",
    title: "動物",
    _openid: "DFDFEX343xxdf-QgVLVzKu3412121"
}

服務(wù)端數(shù)據(jù)庫文檔

可以在控制臺里，看到用戶操作的數(shù)據(jù)，你也可以自己在控制臺上添加、更新或刪除數(shù)據(jù)。

如果數(shù)據(jù)量龐大，可以設(shè)置索引提供查詢的效率。

數(shù)據(jù)庫也可以通過設(shè)置權(quán)限，管控每個 collection。

云函數(shù)是一段運行在云端的代碼，無需管理服務(wù)器，在開發(fā)工具內(nèi)一鍵上傳部署即可運行后端代碼。

開發(fā)者可以在云函數(shù)內(nèi)獲取到每次調(diào)用的上下文（appid、openid 等），無需維護復(fù)雜的鑒權(quán)機制，即可獲取天然可信任的用戶登錄態(tài)（openid）。

wx.cloud.callFunction({
    name: "addblog", // 云函數(shù)名稱
    data: { // 傳到云函數(shù)處理的參數(shù)
        title: "云開發(fā) TCB",
        content: "存儲、數(shù)據(jù)庫存、云函數(shù)"
    }
}).then(res => {
    console.log(res)
}).catch((err) => {
    console.error(err);
});

小程序端云函數(shù)文檔

const app = require("tcb-admin-node");
app.init();

app.callFunction({
    name: "addblog", // 云函數(shù)名稱
    data: { // 傳到云函數(shù)處理的參數(shù)
        title: "云開發(fā) TCB",
        content: "存儲、數(shù)據(jù)庫存、云函數(shù)"
    }
}).then((res) => {
    console.log(res);
}).catch((err) => {
    console.error(err);
});

服務(wù)端云函數(shù)文檔

上傳好之后的云函數(shù)，都會在這里羅列出來。

每次調(diào)用云函數(shù)，都可以在這里看到日志，還可以構(gòu)造測試的參數(shù)，用于調(diào)試。

大部份的接口，目前都支持兩種寫法，分別是Promise 和 Async/Await，本節(jié)以 callFunction 作為例子，在云函數(shù)中介紹這兩種寫法。 Async/Await 本質(zhì)上是基于 Promise 的一種語法糖，它只是把 Promise 轉(zhuǎn)換成同步的寫法而已。

const app = require("tcb-admin-node");
app.init();

exports.main = (event, context, callback) => {
    app.callFunction({
        name: "addblog", // 云函數(shù)名稱
        data: { // 傳到云函數(shù)處理的參數(shù)
            title: "云開發(fā) TCB",
            content: "存儲、數(shù)據(jù)庫存、云函數(shù)"
        }
    }).then((res) => {
        console.log(res);
        callback(null, res.data);
    }).catch((err) => {
        callback(err);
    });
};

const app = require("tcb-admin-node");
app.init();

exports.main = async (event, context) => {
    let result = null;

    try {
        result = await app.callFunction({
            name: "addblog", // 云函數(shù)名稱
            data: { // 傳到云函數(shù)處理的參數(shù)
                title: "云開發(fā) TCB",
                content: "存儲、數(shù)據(jù)庫存、云函數(shù)"
            }
        });
    }
    catch (e) {
        return e;
    }

    return result;
};

在云函數(shù)里使用，由于是 Node 8.9 或以上的環(huán)境，因此天然支持 Async/Await 詰法，但在小程端要使用的話，需要額外引入 Polyfill，比如這個開源的項目：regenerator

由于小程序·云開發(fā)是基于騰訊云的云開發(fā)開發(fā)的功能，因此在騰訊云與小程序兩邊都有不少的開發(fā)者資源，這里供大家參閱讀：

騰訊云開發(fā)者資源及文檔

騰訊云云開發(fā)平臺官方 Github

微信小程序·云開發(fā)文檔