李成熙,腾讯云高级工程师。2014年度毕业加入腾讯AlloyTeam,前后负责过QQ群、花样直播、腾讯文档等项目。2018年加入腾讯云云开发团队。专一于性能优化、工程化和小程序服务。微博 | 知乎 | Githubjavascript
原文连接html
小程序·云开发是微信团队和腾讯云团队共同研发的一套小程序基础能力,简言之就是:云能力将会成为小程序的基础能力。整套功能是基于腾讯云全新推出的云开发(Tencent Cloud Base)所研发出来的一套完备的小程序后台开发方案。前端
小程序·云开发为开发者提供完整的云端流程,简化后端开发和运维概念,无需搭建服务器,使用平台提供的 API 进行核心业务开发,便可实现快速上线和迭代。java
该解决方案目前提供三大基础能力支持:node
存储:在小程序前端直接上传/下载云端文件,在小程序云控制台可视化管理git
数据库:一个既可在小程序前端操做,也能在云函数中读写的文档型数据库github
云函数:在云端运行的代码,微信私有协议自然鉴权,开发者只需编写业务逻辑代码数据库
将来,咱们还会集成更多的服务能力,为小程序提供更强有力的云端支持。npm
上面就是小程序·云开发简单的使用图谱:在小程序端,直接用官方提供的接口,在云函数端,直接用官方提供的 Node SDK,就能够操做你云的资源。之前开发小程序所担心的数据库搭建、文件系统部署,统统没有。json
你只须要有在小程序开发 IDE
里面的 云开发
,开通一下,填写环境 ID
,即可以拥有小程序的云能力!
固然,其实用云开发,并不排斥原有的后台架构,经过下面的架构,你也能够无缝与原有的后台服务兼容,也简化了一些小程序鉴权的逻辑:
接下来,我会分别从小程序端、服务端讲述如何使用这些云资源。
客户端,这里是指在小程序端中。若是要使用云开发能力,请作如下配置:
app.json / game.json
中, 中增长字段 "cloud": true
//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-QgVLVzKu2312121'
}
复制代码
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-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'
}
复制代码
能够在控制台里,看到用户操做的数据,你也能够本身在控制台上添加、更新或删除数据。
若是数据量庞大,能够设置索引提供查询的效率。
数据库也能够经过设置权限,管控每一个 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/Awai
t 本质上是基于 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);
});
};
复制代码
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
因为小程序·云开发是基于腾讯云的云开发开发的功能,所以在腾讯云与小程序两边都有很多的开发者资源,这里供你们参阅读: