小程序·云開發(fā)是微信團(tuán)隊(duì)和騰訊云團(tuán)隊(duì)共同研發(fā)的一套小程序基礎(chǔ)能力,簡言之就是:云能力將會(huì)成為小程序的基礎(chǔ)能力。整套功能是基于騰訊云全新推出的云開發(fā)(Tencent Cloud Base)所研發(fā)出來的一套完備的小程序后臺(tái)開發(fā)方案。
小程序·云開發(fā)為開發(fā)者提供完整的云端流程,簡化后端開發(fā)和運(yùn)維概念,無需搭建服務(wù)器,使用平臺(tái)提供的 API 進(jìn)行核心業(yè)務(wù)開發(fā),即可實(shí)現(xiàn)快速上線和迭代。
該解決方案目前提供三大基礎(chǔ)能力支持:
未來,我們還會(huì)集成更多的服務(wù)能力,為小程序提供更強(qiáng)有力的云端支持。

上面就是小程序·云開發(fā)簡單的使用圖譜:在小程序端,直接用官方提供的接口,在云函數(shù)端,直接用官方提供的 Node SDK,就可以操作你云的資源。以前開發(fā)小程序所擔(dān)憂的數(shù)據(jù)庫搭建、文件系統(tǒng)部署,通通沒有。
你只需要有在小程序開發(fā) IDE 里面的 云開發(fā),開通一下,填寫環(huán)境 ID,便可以擁有小程序的云能力!


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

接下來,我會(huì)分別從小程序端、服務(wù)端講述如何使用這些云資源。
客戶端,這里是指在小程序端中。如果要使用云開發(fā)能力,請做以下配置:
在 app.json / game.json 中, 中增加字段 "cloud": true
project.config.json 中增加了字段 cloudfunctionRoot 用于指定存放云函數(shù)的目錄
初始化云開發(fā)能力:
//app.js
App({
onLaunch: function () {
wx.cloud.init({
traceUser: true // 用戶信息會(huì)顯示在云開發(fā)控制臺(tái)的用戶面板中
});
}
});
|
小程序端初始化能力文檔
在用戶管理中會(huì)顯示使用云能力的小程序的訪問用戶列表,默認(rèn)以訪問時(shí)間倒敘排列,訪問時(shí)間的觸發(fā)點(diǎn)是在小程序端調(diào)用 wx.cloud.init 方法,且其中的 traceUser 參數(shù)傳值為 true。
如果你想在云函數(shù)中,操作文件、數(shù)據(jù)庫和云函數(shù)資源,你可以使用我們提供的服務(wù)端 SDK 進(jìn)行操作。首先,進(jìn)入到你的某個(gè)云函數(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ā)提供存儲(chǔ)空間、上傳文件、下載文件、CDN加速文件訪問等能力,開發(fā)者可以在小程序端與服務(wù)端通過 API 使用這些能力。
// 選擇圖片
wx.chooseImage({
success: dRes => {
// 上傳圖片
const uploadTask = wx.cloud.uploadFile({
cloudPath: `${Date.now()}-${Math.floor(Math.random(0, 1) * 10000000)}.png`, // 隨機(jī)圖片名
filePath: dRes.tempFilePaths[0], // 本地的圖片路徑
success: console.log,
fail: console.error
});
},
fail: console.error,
});
|
小程序端存儲(chǔ)文檔
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);
});;
|
上傳好的文件,就會(huì)出現(xiàn)在控制臺(tái)中,如下圖。你可以在控制臺(tái)里刪除、下載或者查看圖片的詳情。
你還可以控文件整體的權(quán)限,這里還有一些具體的介紹。

服務(wù)端存儲(chǔ)文檔
小程序云提供文檔型數(shù)據(jù)庫 ( document-oriented database ),數(shù)據(jù)庫包含多個(gè)集合(相當(dāng)于關(guān)系型數(shù)據(jù)中的表),集合近似于一個(gè) JSON 數(shù)組,數(shù)組中的每個(gè)對象就是一條記錄,記錄的格式是 JSON 文檔。
每條記錄都有一個(gè) _id 字段用以唯一標(biāo)志這條記錄、一個(gè) _openid 字段用以標(biāo)志記錄的創(chuàng)建者,即小程序的用戶。開發(fā)者可以自定義 _id,但不可在小程序端自定義(在服務(wù)端可以) _openid 。_openid 是在文檔創(chuàng)建時(shí)由系統(tǒng)根據(jù)小程序用戶默認(rèn)創(chuàng)建的,開發(fā)者可使用其來標(biāo)識(shí)和定位文檔。
數(shù)據(jù)庫 API 分為小程序端和服務(wù)端兩部分,小程序端 API 擁有嚴(yán)格的調(diào)用權(quán)限控制,開發(fā)者可在小程序內(nèi)直接調(diào)用 API 進(jìn)行非敏感數(shù)據(jù)的操作。對于有更高安全要求的數(shù)據(jù),可在云函數(shù)內(nèi)通過服務(wù)端 API 進(jìn)行操作。云函數(shù)的環(huán)境是與客戶端完全隔離的,在云函數(shù)上可以私密且安全的操作數(shù)據(jù)庫。
數(shù)據(jù)庫 API 包含增刪改查的能力,使用 API 操作數(shù)據(jù)庫只需三步:獲取數(shù)據(jù)庫引用、構(gòu)造查詢/更新條件、發(fā)出請求。切記,在操作數(shù)據(jù)庫前,請先在控制臺(tái)中創(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 會(huì)自動(dòng)插入到數(shù)據(jù)庫中
{
photo: 'cloud://tcb-xxx/05ca1d38f86f90d66d4751a730379dfa6584dde05ab4-Ma9vMN_fw658.jpg',
title: '風(fēng)景',
_openid: 'oLlMr5FICCQJV-QgVLVzKu1212341'
}
|
小程序端數(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);
});
// 輸出
// 因?yàn)槭窃诜?wù)端,其它用戶的也可以提取出來
{
photo: 'cloud://tcb-xxx/05ca1d38f86f90d66d4751a730379dfa6584dde05ab4-Ma9vMN_fw658.jpg',
title: '風(fēng)景',
_openid: 'oLlMr5FICCQJV-QgVLVzKu1342121'
}
{
photo: 'cloud://tcb-xxx/0dc3e66fd6b53641e328e091ccb3b9c4e53874232e6bf-ZxSfee_fw658.jpg',
title: '美女',
_openid: 'DFDFEX343xxdf-QgVLVzKu12452121'
}
{
photo: 'cloud://tcb-xxx/104b27e339bdc93c0da15a47aa546b6e9c0e3359c315-L8Px2Y_fw658.jpg',
title: '動(dòng)物',
_openid: 'DFDFEX343xxdf-QgVLVzKu1342121'
}
|
服務(wù)端數(shù)據(jù)庫文檔
可以在控制臺(tái)里,看到用戶操作的數(shù)據(jù),你也可以自己在控制臺(tái)上添加、更新或刪除數(shù)據(jù)。
如果數(shù)據(jù)量龐大,可以設(shè)置索引提供查詢的效率。

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

云函數(shù)是一段運(yùn)行在云端的代碼,無需管理服務(wù)器,在開發(fā)工具內(nèi)一鍵上傳部署即可運(yùn)行后端代碼。
開發(fā)者可以在云函數(shù)內(nèi)獲取到每次調(diào)用的上下文(appid、openid 等),無需維護(hù)復(fù)雜的鑒權(quán)機(jī)制,即可獲取天然可信任的用戶登錄態(tài)(openid)。
wx.cloud.callFunction({
name: 'addblog', // 云函數(shù)名稱
data: { // 傳到云函數(shù)處理的參數(shù)
title: '云開發(fā) TCB',
content: '存儲(chǔ)、數(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: '存儲(chǔ)、數(shù)據(jù)庫存、云函數(shù)'
}
}).then((res) => {
console.log(res);
}).catch((err) => {
console.error(err);
})
|
服務(wù)端云函數(shù)文檔
上傳好之后的云函數(shù),都會(huì)在這里羅列出來。

每次調(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: '存儲(chǔ)、數(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: '存儲(chǔ)、數(shù)據(jù)庫存、云函數(shù)'
}
});
}
catch (e) {
return e;
}
return result;
};
|