初始化云开发能力:
在用户管理中会显示使用云能力的小程序的访问用户列表,默认以访问时间倒叙排列,访问时间的触发点是在小程序端调用?wx.cloud.init
?方法,且其中的?traceUser
?参数传值为?true
。
服务端
如果你想在云函数中,操作文件、数据库和云函数资源,你可以使用我们提供的服务端 SDK 进行操作。首先,进入到你的某个云函数中,安装以下依赖包:
npm i --save tcb-admin-node
在云函数中初始化
const app = require('tcb-admin-node'<span style="color: #008000">//<span style="color: #008000"> 初始化资源<span style="color: #008000">
//<span style="color: #008000"> 云函数下不需要secretId和secretKey。<span style="color: #008000">
//<span style="color: #008000"> env如果不指定将使用默认环境
<span style="color: #000000">app.init({
secretId: 'xxxxx'<span style="color: #000000">,secretKey: 'xxxx'<span style="color: #000000">,env: 'xxx'<span style="color: #000000">
});
<span style="color: #008000">//<span style="color: #008000">云函数下使用默认环境
<span style="color: #000000">app.init()
<span style="color: #008000">//<span style="color: #008000">云函数下指定环境
<span style="color: #000000">app.init({
env: 'xxx'<span style="color: #000000">
});
存储
云开发提供存储空间、上传文件、下载文件、CDN加速文件访问等能力,开发者可以在小程序端与服务端通过?API
?使用这些能力。
小程序端
=>
const uploadTask =-${Math.floor(Math.random(0,1) * 10000000)}.png`,
filePath: dRes.tempFilePaths[0],
服务端
const app = require('tcb-admin-node'app.uploadFile({
cloudPath: "cover.png"<span style="color: #000000">,fileContent: fs.createReadStream(${__dirname}</span>/cover.png
)
}).then((res) =><span style="color: #000000"> {
console.log(res);
}).<span style="color: #0000ff">catch((err) =><span style="color: #000000"> {
console.error(err);
});;
控制台
上传好的文件,就会出现在控制台中,如下图。你可以在控制台里删除、下载或者查看图片的详情。
你还可以控文件整体的权限,这里还有一些具体的介绍。
数据库
小程序云提供文档型数据库 ( document-oriented database ),数据库包含多个集合(相当于关系型数据中的表),集合近似于一个 JSON 数组,数组中的每个对象就是一条记录,记录的格式是 JSON 文档。
每条记录都有一个?_id
?字段用以唯一标志这条记录、一个?_openid
?字段用以标志记录的创建者,即小程序的用户。开发者可以自定义?_id
,但不可在小程序端自定义(在服务端可以)?_openid
?。_openid
?是在文档创建时由系统根据小程序用户默认创建的,开发者可使用其来标识和定位文档。
数据库?API
?分为小程序端和服务端两部分,小程序端?API
?拥有严格的调用权限控制,开发者可在小程序内直接调用?API
?进行非敏感数据的操作。对于有更高安全要求的数据,可在云函数内通过服务端?API
?进行操作。云函数的环境是与客户端完全隔离的,在云函数上可以私密且安全的操作数据库。
数据库?API
?包含增删改查的能力,使用?API
?操作数据库只需三步:获取数据库引用、构造查询/更新条件、发出请求。切记,在操作数据库前,请先在控制台中创建?collection
。
小程序端
const db =
<span style="color: #008000">//<span style="color: #008000"> 插入数据
db.collection('photo'<span style="color: #000000">).add({
data: {
photo: 'cloud://tcb-xxx/05ca1d38f86f90d66d4751a730379dfa6584dde05ab4-Ma9vMN_fw658.jpg'<span style="color: #000000">,title: '风景'<span style="color: #000000">
}
});
<span style="color: #008000">//<span style="color: #008000"> 提取数据
db.collection('photo').get().then((res) =><span style="color: #000000"> {
let data =<span style="color: #000000"> res.data;
console.log(data);
});
<span style="color: #008000">//<span style="color: #008000"> 输出<span style="color: #008000">
//<span style="color: #008000"> 在小程序端, _openid 会自动插入到数据库中
<span style="color: #000000">{
photo: 'cloud://tcb-xxx/05ca1d38f86f90d66d4751a730379dfa6584dde05ab4-Ma9vMN_fw658.jpg'<span style="color: #000000">,title: '风景'<span style="color: #000000">,_openid: 'oLlMr5FICCQJV-QgVLVzKu1212341'<span style="color: #000000">
}
服务端
const app = require('tcb-admin-node'
=db.collection('photo').limit(10).get().then((res) =><span style="color: #000000"> {
console.log(res);
}).<span style="color: #0000ff">catch((err) =><span style="color: #000000"> {
console.error(err);
});
<span style="color: #008000">//<span style="color: #008000"> 输出<span style="color: #008000">
//<span style="color: #008000"> 因为是在服务端,其它用户的也可以提取出来
<span style="color: #000000">{
photo: 'cloud://tcb-xxx/05ca1d38f86f90d66d4751a730379dfa6584dde05ab4-Ma9vMN_fw658.jpg'<span style="color: #000000">,_openid: 'oLlMr5FICCQJV-QgVLVzKu1342121'<span style="color: #000000">
}
{
photo: 'cloud://tcb-xxx/0dc3e66fd6b53641e328e091ccb3b9c4e53874232e6bf-ZxSfee_fw658.jpg'<span style="color: #000000">,title: '美女'<span style="color: #000000">,_openid: 'DFDFEX343xxdf-QgVLVzKu12452121'<span style="color: #000000">
}
{
photo: 'cloud://tcb-xxx/104b27e339bdc93c0da15a47aa546b6e9c0e3359c315-L8Px2Y_fw658.jpg'<span style="color: #000000">,title: '动物'<span style="color: #000000">,_openid: 'DFDFEX343xxdf-QgVLVzKu1342121'<span style="color: #000000">
}
服
控制台
可以在控制台里,看到用户操作的数据,你也可以自己在控制台上添加、更新或删除数据。
如果数据量庞大,可以设置索引提供查询的效率。
数据库也可以通过设置权限,管控每个?collection
。
云函数
云函数是一段运行在云端的代码,无需管理服务器,在开发工具内一键上传部署即可运行后端代码。
开发者可以在云函数内获取到每次调用的上下文(appid
、openid
?等),无需维护复杂的鉴权机制,即可获取天然可信任的用户登录态(openid
)。
小程序端
'addblog',
data: {
title: '云开发 TCB''存储、数据库存、云函数'=>((err) =>
服务端
const app = require("tcb-admin-node"app.callFunction({
name: 'addblog',content: '存储、数据库存、云函数'<span style="color: #000000">
}
}).then((res) =><span style="color: #000000"> {
console.log(res);
}).<span style="color: #0000ff">catch((err) =><span style="color: #000000"> {
console.error(err);
});
服
控制台
上传好之后的云函数,都会在这里罗列出来。
每次调用云函数,都可以在这里看到日志,还可以构造测试的参数,用于调试。
语法糖
大部份的接口,目前都支持两种写法,分别是Promise 和 Async/Await,本节以?callFunction
作为例子,在云函数
中介绍这两种写法。?Async/Awai
t 本质上是基于?Promise
?的一种语法糖,它只是把?Promise
?转换成同步的写法而已。
Promise
const app = require("tcb-admin-node"exports.main = (event,context,callback) =><span style="color: #000000"> {
app.callFunction({
name: 'addblog',<span style="color: #008000">//<span style="color: #008000"> 云函数名称
data: { <span style="color: #008000">//<span style="color: #008000"> 传到云函数处理的参数
title: '云开发 TCB'<span style="color: #000000">,content: '存储、数据库存、云函数'<span style="color: #000000">
}
}).then((res) =><span style="color: #000000"> {
console.log(res);
callback(<span style="color: #0000ff">null<span style="color: #000000">,res.data);
}).<span style="color: #0000ff">catch((err) =><span style="color: #000000"> {
callback(err);
});
};
Async/Await
const app = require("tcb-admin-node"
exports.main = async (event,context) =><span style="color: #000000"> {
let result = <span style="color: #0000ff">null<span style="color: #000000">;
</span><span style="color: #0000ff">try</span><span style="color: #000000"> {
result </span>=<span style="color: #000000"> await app.callFunction({
name: </span>'addblog',<span style="color: #008000">//</span><span style="color: #008000"> 云函数名称</span>
data: { <span style="color: #008000">//</span><span style="color: #008000"> 传到云函数处理的参数</span>
title: '云开发 TCB'<span style="color: #000000">,content: </span>'存储、数据库存、云函数'<span style="color: #000000">
}
});
}
</span><span style="color: #0000ff">catch</span><span style="color: #000000"> (e) {
</span><span style="color: #0000ff">return</span><span style="color: #000000"> e;
}
</span><span style="color: #0000ff">return</span><span style="color: #000000"> result;
};
在云函数里使用,由于是?Node 8.9
?或以上的环境,因此天然支持?Async/Await
?诘法,但在小程端要使用的话,需要额外引入?Polyfill
,比如这个开源的项目:
开发者资源
由于小程序·云开发是基于腾讯云的云开发开发的功能,因此在腾讯云与小程序两边都有不少的开发者资源,这里供大家参阅读: