初始化雲開發能力：
//app.js
App({
onLaunch: function () {
wx.cloud.init({
traceUser: true // 用戶信息會顯示在雲開發控制台的用戶面板中
});
}
});
小程式端初始化能力文檔
在用戶管理中會顯示使用雲能力的小程式的訪問用戶列表，預設以訪問時間倒敘排列，訪問時間的觸發點是在小程式端調用 wx.cloud.init 方法，且其中的 traceUser 參數傳值為 true。
服務端
如果你想在雲函數中，操作文件、資料庫和雲函數資源，你可以使用我們提供的服務端 SDK 進行操作。首先，進入到你的某個雲函數中，安裝以下依賴包：
npm i --save tcb-admin-node
在雲函數中初始化
// 初始化示例
const app = require('tcb-admin-node');
// 初始化資源
// 雲函數下不需要secretId和secretKey。
// env如果不指定將使用預設環境
app.init({
secretId: 'xxxxx',
secretKey: 'xxxx',
env: 'xxx'
});
//雲函數下使用預設環境
app.init()
//雲函數下指定環境
app.init({
env: 'xxx'
});
服務端初始化文檔
存儲
雲開發提供存儲空間、上傳文件、下載文件、CDN加速文件訪問等能力,開發者可以在小程式端與服務端通過 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);
});;
控制台
上傳好的文件，就會出現在控制臺中，如下圖。你可以在控制台里刪除、下載或者查看圖片的詳情。
你還可以控文件整體的許可權，這裡還有一些具體的介紹。
服務端存儲文檔
資料庫
小程式雲提供文檔型資料庫 ( document-oriented database )，資料庫包含多個集合（相當於關係型數據中的表），集合近似於一個 JSON 數組，數組中的每個對象就是一條記錄，記錄的格式是 JSON 文檔。
每條記錄都有一個 _id 欄位用以唯一標誌這條記錄、一個 _openid 欄位用以標誌記錄的創建者，即小程式的用戶。開發者可以自定義 _id，但不可在小程式端自定義（在服務端可以） _openid 。_openid 是在文檔創建時由系統根據小程式用戶預設創建的，開發者可使用其來標識和定位文檔。
資料庫 API 分為小程式端和服務端兩部分，小程式端 API 擁有嚴格的調用許可權控制，開發者可在小程式內直接調用 API 進行非敏感數據的操作。對於有更高安全要求的數據，可在雲函數內通過服務端 API 進行操作。雲函數的環境是與客戶端完全隔離的，在雲函數上可以私密且安全的操作資料庫。
資料庫 API 包含增刪改查的能力，使用 API 操作資料庫只需三步：獲取資料庫引用、構造查詢/更新條件、發出請求。切記，在操作資料庫前，請先在控制臺中創建 collection。
小程式端
const db = wx.cloud.database();
// 插入數據
db.collection('photo').add({
data: {
photo: 'cloud://tcb-xxx/05ca1d38f86f90d66d4751a730379dfa6584dde05ab4-Ma9vMN_fw658.jpg',
title: '風景'
}
});
// 提取數據
db.collection('photo').get().then((res) => {
let data = res.data;
console.log(data);
});
// 輸出
// 在小程式端， _openid 會自動插入到資料庫中
{
photo: 'cloud://tcb-xxx/05ca1d38f86f90d66d4751a730379dfa6584dde05ab4-Ma9vMN_fw658.jpg',
title: '風景',
_openid: 'oLlMr5FICCQJV-QgVLVzKu1212341'
}
小程式端資料庫文檔
服務端
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);
});
// 輸出
// 因為是在服務端，其它用戶的也可以提取出來
{
photo: 'cloud://tcb-xxx/05ca1d38f86f90d66d4751a730379dfa6584dde05ab4-Ma9vMN_fw658.jpg',
title: '風景',
_openid: 'oLlMr5FICCQJV-QgVLVzKu1342121'
}
{
photo: 'cloud://tcb-xxx/0dc3e66fd6b53641e328e091ccb3b9c4e53874232e6bf-ZxSfee_fw658.jpg',
title: '美女',
_openid: 'DFDFEX343xxdf-QgVLVzKu12452121'
}
{
photo: 'cloud://tcb-xxx/104b27e339bdc93c0da15a47aa546b6e9c0e3359c315-L8Px2Y_fw658.jpg',
title: '動物',
_openid: 'DFDFEX343xxdf-QgVLVzKu1342121'
}
服務端資料庫文檔
控制台
可以在控制台里，看到用戶操作的數據，你也可以自己在控制臺上添加、更新或刪除數據。
如果數據量龐大，可以設置索引提供查詢的效率。
資料庫也可以通過設置許可權，管控每個 collection。
雲函數
雲函數是一段運行在雲端的代碼，無需管理伺服器，在開發工具內一鍵上傳部署即可運行後端代碼。
開發者可以在雲函數內獲取到每次調用的上下文（appid、openid 等），無需維護複雜的鑒權機制，即可獲取天然可信任的用戶登錄態（openid）。
小程式端
wx.cloud.callFunction({
name: 'addblog', // 雲函數名稱
data: { // 傳到雲函數處理的參數
title: '雲開發 TCB',
content: '存儲、資料庫存、雲函數'
}
}).then(res => {
console.log(res)
}).catch((err) => {
console.error(err);
});
小程式端雲函數文檔
服務端
const app = require("tcb-admin-node");
app.init();
app.callFunction({
name: 'addblog', // 雲函數名稱
data: { // 傳到雲函數處理的參數
title: '雲開發 TCB',
content: '存儲、資料庫存、雲函數'
}
}).then((res) => {
console.log(res);
}).catch((err) => {
console.error(err);
});
服務端雲函數文檔
控制台
上傳好之後的雲函數，都會在這裡羅列出來。
每次調用雲函數，都可以在這裡看到日誌，還可以構造測試的參數，用於調試。
語法糖
大部份的介面，目前都支持兩種寫法，分別是Promise 和 Async/Await，本節以 callFunction作為例子，在雲函數中介紹這兩種寫法。 Async/Await 本質上是基於 Promise 的一種語法糖，它只是把 Promise 轉換成同步的寫法而已。
Promise
const app = require("tcb-admin-node");
app.init();
exports.main = (event, context, callback) => {
app.callFunction({
name: 'addblog', // 雲函數名稱
data: { // 傳到雲函數處理的參數
title: '雲開發 TCB',
content: '存儲、資料庫存、雲函數'
}
}).then((res) => {
console.log(res);
callback(null, res.data);
}).catch((err) => {
callback(err);
});
};
Async/Await
const app = require("tcb-admin-node");
app.init();
exports.main = async (event, context) => {
let result = null;
try {
result = await app.callFunction({
name: 'addblog', // 雲函數名稱
data: { // 傳到雲函數處理的參數
title: '雲開發 TCB',
content: '存儲、資料庫存、雲函數'
}
});
}
catch (e) {
return e;
}
return result;
};
在雲函數里使用，由於是 Node 8.9 或以上的環境，因此天然支持 Async/Await 詰法，但在小程端要使用的話，需要額外引入 Polyfill，比如這個開源的項目：regenerator
開發者資源
由於小程式·雲開發是基於騰訊雲的雲開發開發的功能，因此在騰訊雲與小程式兩邊都有不少的開發者資源，這裡供大家參閱讀：
