- 微信云开发计费调整公告
各位微信云开发用户: 感谢大家一直以来对微信云开发的支持。由于云计算成本整体上升,为了继续为各位用户提供稳定可靠的服务,微信云开发将于 2022 年 08 月 18 日,对计费方式进行如下变更,部分指标价格将有所上浮。 新计费模式下,新用户免费使用 1 个月后,统一使用 “基础套餐+按量付费” 模式:购买带有一定配额的基础套餐后,超出套餐配额部分再按照实际使用量付费。 基础套餐 [图片] *新用户首月免费配额:与基础套餐一致,可满足大部分情况下的开发体验需求 *5 折折扣有效期至少延续至 2022 年底,后续折扣如有变化将另行通知 按量付费 [图片] 【指标说明】 1、调用次数:合并原多项指标统一计价,具体为 “云存储上传操作”、“云存储下载操作”;“数据库读操作”、“数据库写操作” 及新增指标 “云函数调用操作”; 2、容量:合并原多项指标统一计价,具体为 “存储空间" 及 "数据库容量"; 3、云函数日志服务:本次新增计费指标,建议通过优化日志存储策略降低该指标费用。 新用户手动触发确认开始使用后,将拥有 1 个月免费权益,体验期间的环境配额与基础套餐相同,可选择是否进行超额按量付费。 现有用户可以在「微信开发者工具-云开发控制台」或「微信云服务助手小程序」查询过往用量情况后,使用 价格计算器 预估新价格。 在计费方式升级生效之日(2022.08.08)起,对现有用户均提供至少 1 个月的操作缓冲期,期间会推送提醒及提供切换入口,用户可自由选择是否切换新的计费方式,超时未切换的云开发环境将会停服释放。缓冲期内切换成功的用户将会获得额外代金券。 对于当前月调用次数 >100 万次的帐号,本次调整将不直接生效,后续将由专业架构师联系或独立推送指引切换到合适配额的企业旗舰版本。 自本公告发布之日起,对于原已购预付费套餐、资源包的用户,仍然可正常使用原已购资源,直至原约定套餐到期或用完。现有旧预付费套餐不再支持续费超过一个月,现有旧资源包不再支持新购。 微信云开发将继续为各位用户提供简单易用安全的专业 Serverless 开发服务,感谢大家的支持。 Q&A 1、此次调整,意味着我的费用会增加吗? 是的,由于云计算整体成本的持续上升,为了能够长期给各位开发者提供低门槛的开发服务,我们对于部分计费指标进行了价格调整,在调整后大部分的开发者费用会一定程度的上浮。 2、我如何预估调整之后的费用是多少呢? 新计费生效后,在缓冲期内,开发者可查看新指标下的用量情况,或者根据过往用量,使用 价格计算器 估算调整之后的费用。 我们根据测算,为大部分开发者提供基础套餐配额以满足线上服务,如你的实际用量没有超过基础配额,也没有使用扩展功能,那么每月消费即为 19.9 元。 3、我需要在哪里操作切换新计费呢? [图片] 微信云服务助手小程序码 在计费方式升级生效之日(2022.08.08)起,开发者可前往「微信开发者工具-云开发控制台」或「微信云服务助手小程序」进行操作切换。按照过往的计费信息下发惯例,我们通过「微信公众平台公众号」向管理员推送计费变更信息与切换入口。 4、现在的环境是否可以继续使用呢? 新计费生效后,已购买的预付费套餐可正常使用至原到期时间,已购买资源包的按量付费环境可正常使用至原资源包到期时间,均不会存在直接失效或自动退费的情况。在切换到新计费方案后,原有环境即可持续正常使用。 5、如果超时切换会有什么影响呢? 若原环境到期且超出切换缓冲时间,则该环境将进入停服释放流程,数据不可找回,请开发者及时操作。 6、以上新计费方案生效后,我有多长时间可以决定是否继续使用云开发呢? 对于当前月调用次数 <100 万次的帐号,从公告发布日至新方案生效后的一个月,期间可进行是否继续使用的决策;计费方式升级生效之日(2022.08.08)起,我们也会通过上述 Q&A 3 说明的方式中提供切换入口与下发消息,此时你仍然有至少 1 个月的缓冲期做出决定。对于当前月调用次数 >100 万次的帐号,将有专业架构师联系指引切换到合适配额的企业旗舰版本,期间产生的消耗仍然按旧方案计费。我们会为大额消耗用户提供适当优惠,同时对于不希望继续使用云开发的此类帐号提供不低于 3 个月的缓冲时间。如有其他问题,可前往「微信开发者工具-云开发控制台-帮助-工单」主动联系我们。 7、我自行测算预估后觉得新方案有点贵,有什么好建议吗? 本次调整,价格上涨指标为 “调用次数”、“容量”和“CDN 流量”,建议相应进行技术优化,减少不必要的多次调用或存储内容,可有效控制费用;此外新增计费指标为日志服务,可在「微信开发者工具-云开发控制台-云函数-日志」中查看日志使用情况,并优化日志使用逻辑,避免上报大量冗余的日志信息导致不必要的费用支出。 若评估后认为新的费用方案已不适用于你的业务,可在上述充足的缓冲期内自行选择迁移业务至更合适的服务。 微信云开发团队 2022年7月4日
2022-08-08 - [填坑手册]小程序web-view组件实战与踩坑
[图片] 首先,根据官网文档可以知道 只有非个人 的小程序才可以使用web-view组件,如果你的个人开发者,可以跳过这篇文章。 [图片] 一、使用web-view以及它的好处 1、己方账号(第三方)与小程序openId/UnionId的关联绑定,实现免登陆 比如你是某门户网站S,你要识别自己小程序上的用户与网站用户的关系,你可以通过三种方法绑定关系,公众号,小程序源生,小程序web-view内嵌跳转三种方法 2、内嵌H5的富文本,减少重复开发 比如你是门户网站,社区,以往有大量的新闻和帖子,里面带了各种css样式的富文本,小程序源生是无法直接读取的,需要大量转化,这时候直接内嵌这些H5新闻,大大降低开发成本 3、热更新,减少发布审核 某些需要经常更新的内容、公告、活动页,内嵌H5可以减少频繁提交小程序审核 二、小程序功能赋权 为H5提供各种小程序才有的功能,比如录音,扫一扫等。 注意事项 多场景判断,建议使用官方API: wx.miniProgram.getEnv H5唤醒一些小程序API有一定的延时,0.3~1秒 请调用小程序专用的JSSDK,同一个jssdk,但是webview的功能收到限制,和之前微信打开H5有所不同 小程序自动获取加载H5的title H5中iframe的url必须也是业务域名 web-view一定是撑满全屏的,自定义顶部菜单,悬浮的都没用 三、小程序和H5之前的互相通讯 1、 从小程序 ==>> h5 小程序控制H5,可以直接用src路径传参的形式,比如 [代码]<!-- 小程序端 HTML --> <web-view src="//URL?a=param1&b=param2"></web-view> [代码] 避免在链接中带有中文字符,在 iOS 中会有打开白屏的问题,建议加一下 encodeURIComponent。 2、 从 H5 ==>> 小程序 [图片] 这里我们知道bindmessage是小程序用来监听H5的推送的内容,但是这里不大不小的坑!就是它的三个出发场景: 小程序后退:使用接口名 wx.miniProgram.navigateTo,wx.miniProgram.navigateBack,wx.miniProgram.switchTab 等切换小程序页面/场景的API时候都会出发 分享:这个就是当你点分享小程序的时候,会接受到H5之前发送的postMessage 组件销毁,web-view组件销毁,类似 wx.miniProgram.redirectTo 都会触发。 [代码]<!-- 小程序端 HTML --> <web-view bindmessage="handleGetMessage" src="{{openUrl}}"></web-view> [代码] [代码]// 小程序端 JS --> Page({ /** * 页面的初始数据 */ data: { openUrl: "", }, /** * 获取请求数据 */ handleGetMessage: function (e) { console.log(e.detail.data); } }, }) [代码] [代码]<!-- h5端 HTML和JS --> <script type="text/javascript" src="https://res.wx.qq.com/open/js/jweixin-1.3.2.js"></script> <script> wx.miniProgram.postMessage({ data: { link: "//test.com", title: "一起学习,一起进步" } }); //wx.miniProgram.redirectTo({ // url:"/pages/inner/index?source=123" //}) wx.miniProgram.navigateBack({delta: 1}) </script> [代码] 注意事项 那些H5控制小程序的跳转路径必须是“/”开头,如 “/pages/xxx/xxx”,且路径必须在app.json里有,地址错误的话,有时不报错。 postMessage的json必须是data开始,不然接收不到数据。 [图片] 四、bindmessage接收到消息有3个重要特性(重点) 接收可以是H5之前几分钟前发送postMessage,不一定是即刻发出的。 之前发出的 postMessage的DATA信息会累加,当触发bindmessage接收的时候是一个数组。 [图片] 当bindmessage 再次 接收到数据,之前发送的数据不会被清空,将累加一起返回,获取时要判断好数组的角标 [图片] 五、Tips 1、在IDE工具中如何调试H5 [图片] 可以在 web-view 组件上通过右键 - 调试,打开 web-view 组件的调试。 2、内嵌H5缓存问题 web-view加载的H5具有很重的缓存,如果需要调试,可以通过在url后面加时间戳的方式解决。 3、小程序关闭,H5背景音乐仍然在播放问题 小程序已经关闭,但是H5自带的背景音乐仍然在手机后台播放的问题。这里可以利用一个属性: visibilitychange:页面可见性状态 简单的说,浏览器标签页被隐藏或显示的时候会触发visibilitychange事件。 [代码]var statusBeforeHide = true; //初始化页面的状态 var music = document.getElementById("xxx"); // 更改音乐播放状态 function setChangeMusic() { if (document[hiddenProperty]) { // 页面隐藏 if (statusBeforeHide) { music.pause(); // 暂停 } } else { // 页面显示 if (statusBeforeHide) { music.play() //如果statusBeforeHide是true, 继续播放 } } } let hiddenProperty = ('hidden' in document) ? 'hidden' : ('webkitHidden' in document) ? 'webkitHidden' : ('mozHidden' in document) ? 'mozHidden' : null; if (hiddenProperty) { let visibilityChangeEvent = hiddenProperty.replace(/hidden/i, 'visibilitychange'); let onVisibilityChange = () => { //console.log('visibilityChange'); setChangeMusic(); }; document.addEventListener(visibilityChangeEvent, onVisibilityChange); } else { console.log("不支持这个api"); } [代码] 总结,web-view还是非常实用的组件,且用且珍惜~ 往期回顾: 小程序自定义头部导航栏“完美”解决方案 小程序Canvas生成海报(一) 小程序新版订阅消息+云开发实战与跳坑
2021-09-13 - 关于补充小程序、插件用户隐私保护指引说明
为进一步规范开发者的用户个人信息处理行为,保障用户合法权益,小程序、插件中涉及处理用户个人信息的开发者,无论是通过调用涉及用户个人信息的相关接口,还是自行收集用户个人信息,在提交代码版本前,均需补充相应用户隐私保护指引,具体如下: 一、 如小程序、插件有涉及收集用户个人信息(包含通过接口形式收集、通过非接口的形式收集)开发者需在【小程序管理后台-设置-功能设置-用户隐私保护指引】(如果是第三方开发者代开发小程序可通过接口进行配置)/【小程序管理后台-功能-小程序插件-基本设置-用户隐私保护说明】针对具体使用目的与用途进行说明填写,并补充完整隐私指引内容。 二、针对隐私指引说明内容,有如下要求: 1、隐私指引说明内容需与代码包内引用相关接口一致; 2、隐私指引说明内容文字表述需清晰、完整、告知用户处理相应信息的目的与用途; 3、在代码提审环节将对以上要求进行核验,如未满足相应要求,则无法通过代码版本审核,将影响开发者后续版本提审。 平台预计于11月1日对相关接口进行隐私指引说明审核,请开发者及时补充完善隐私指引说明,避免影响相关服务及用户体验。 微信团队 2021年10月29日
2023-09-26 - 关于微信安卓端网页字体适配的通知
为了提供给用户更好的阅读体验,微信安卓版 7.0.10 版本起,网页的字体会跟随微信设置里的字体大小更改而变化。 若调整字体变大或变小后,部分未适配网页的排版会出现显示错乱,建议未进行适配的开发者尽快完成对“ 字体大小” 的适配。 查看网页在字体不同大小下展示效果的方法: 方法1:"设置">"通用">“字体大小">进行字体大小修改后查看对应网页显示效果。 方法2:在微信内访问对应网页右上角”…">底部菜单栏选择调整字体">进行字体大小修改后查看对应网页显示效果。 另外,对于现有的显示问题,我们提供以下方案让开发者临时将字体还原标准大小。同时,开发者可以在页面中提示用户在右上角”…”更多菜单中修改字体到合适的大小。 下列方案可以将字体还原标准大小,但我们仍然建议后续做字体适配来提高用户的阅读体验。 『字体还原标准大小』方案: 我们提供了一个 JSAPI 用于设置字体大小,只需将字体大小等级设置为 2 (标准)即可,代码示例如下: document.addEventListener("WeixinJSBridgeReady", function () { WeixinJSBridge.invoke("setFontSizeCallback", { fontSize: '2' }); }, false); 此外,若页面是用 rem 单位进行排版的(目前该做法更容易导致页面不可用),可以反向重置 font-size 的数值达到还原字体标准大小的目的,此方法在效果上也比较理想。代码示例如下: // 以下代码思路来源网络。同时代码放在 body 标签开头位置效果最佳 var $dom = document.createElement('div'); $dom.style = 'font-size: 10px'; document.body.appendChild($dom); // 计算出放大后的字体 var scaledFontSize = parseInt(window.getComputedStyle($dom, null).getPropertyValue('font-size')); document.body.appendChild($dom); // 计算原字体和放大后字体的比例 var scaleFactor = 10 / scaledFontSize; // 取 html 元素的字体大小 var originRootFontSize = parseInt(window.getComputedStyle(document.documentElement, null).getPropertyValue('font-size')); // 由于设置 font-size 后实际会变大,故 font-size 需设置为更小一级 document.documentElement.style.fontSize = originRootFontSize * scaleFactor * scaleFactor + 'px';
2020-01-14 - 云函数时区问题解决方案
我在之前写文章整理过关于云函数时区的问题,具体见下面链接,今天不讨论多个方案,只推荐一个亲测可行的稳定方案 https://developers.weixin.qq.com/community/develop/article/doc/000c887a83874009534a4712a5b813 所谓云函数时区问题是指: 云函数中的时区为 UTC+0,不是 UTC+8,在云函数中使用时间时需特别注意。也就是是说,现在是2020-05-25 15:00:00,但是在云函数端new Date()打印的是2020-05-25 07:00:00 https://developers.weixin.qq.com/miniprogram/dev/wxcloud/guide/functions/notice.html 具体解决方案 如果需要默认 UTC+8,可以配置函数的环境变量,设置 TZ 为 Asia/Shanghai。 注意事项 这里需要注意的是:设置环境变量和上传云函数的顺序问题,一定要在设置环境变量之后,重新部署云函数,并且部署完成之后要缓个几分钟测试, 该方案亲测可用
2020-05-25 - 微信小程序联表查询、跨时间段查询
需求分析 注意:小程序端不支持 lookup,所以我们退而求其次,交由云开发端实现这一功能。 联表查询 时间段匹配 分页 代码 闲言碎语不要讲咱们直接上干货: [代码]/** 函数前一定要写上 async */ /** * 请求参数 * @param {Date} startTime 查询开始时间 * @param {Date} endTime 查询结束时间 * @param {Number} limit 每页条目 * @param {Number} offset 页码 */ let { startTime, endTime, limit = 20, offset = 1 } = ctx._req.event; // 这个我使用了 tcb-router 包,你可以替换成自己获取请求参数的方法。 let matched = true; // 默认添加项 if (startTime && endTime) { // 这里要将小程序端请求的date类型再new date一下。 startTime = new Date(startTime); endTime = new Date(endTime); /** 时间转码(必需) */ let startTimeJson = $.dateFromString({ dateString: startTime.toJSON() }); /** 时间转码(必须) */ let endTimeJson = $.dateFromString({ dateString: endTime.toJSON() }); matched = $.and([$.gte(['$due', startTimeJson]), $.lte(['$due', endTimeJson])]); } ctx.body = await cloud.database().collection('xxx') .aggregate() .lookup({ from: 'billTag', localField: 'tagId', foreignField: '_id', as: 'tag', }) .addFields({ matched }) .match({ matched: true }) .sort({ due: -1, createTime: -1 }) .skip(offset * limit) .limit(limit) .end() .then(res => { log.log({ state: 'success', ...res }); return res; }) .catch(err => { log.error({ state: 'error', ...err }); return err; }); [代码] 参考链接 [1] 如何使用数据库聚合match过滤$.and? - 微信开放社区 https://developers.weixin.qq.com/community/develop/doc/000860ca140fd87ab5e8bd7075b400 [2] 云开发 聚合阶段 match无法根据时间查询? - 微信开放社区 https://developers.weixin.qq.com/community/develop/doc/000caa1ef70b98d59869e25c454400
2020-07-02 - 小程序·云开发之数据库自动备份丨云开发101
小程序云开发之数据库自动备份 小程序云开发提供了方便的云数据库供我们直接使用,云开发使用了腾讯云提供的云数据库,拥有完善的数据保障机制,无需担心数据丢失。但是,我们还是不可避免的会担心数据库中数据的安全,比如不小心删除了数据集合,写入了脏数据等。 还好,云开发控制台提供了数据集合的导出,导入功能,我们可以手动备份数据库。不过,总是手动备份数据库也太麻烦了点,所有重复的事情都应该让代码去解决,下面我们就说说怎么搞定云开发数据库自动备份。 通过查阅微信的文档,可以发现云开发提供了数据导出接口databaseMigrateExport [代码]POST https://api.weixin.qq.com/tcb/databasemigrateexport?access_token=ACCESS_TOKEN [代码] 通过这个接口,结合云函数的定时触发功能,我们就可以做数据库定时自动备份了。梳理一下大致的流程: 创建一个定时触发的云函数 云函数调用接口,导出数据库备份文件 将备份文件上传到云存储中以供使用 1. 获取 access_token 调用微信的接口需要 access_token,所以我们首先要获取 access_token。通过文档了解到使用 auth.getAccessToken 接口可以用小程序的 appid 和 secret 获取 access_token。 [代码]// 获取 access_token request.get( `https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=${appid}&secret=${secret}`, (err, res, body) => { if (err) { // 处理错误 return; } const data = JSON.parse(body); // data.access_token } ); [代码] 2. 创建数据库导出任务 获取 access_token 后,就可以使用 [代码]databaseMigrateExport[代码] 接口导出数据进行备份。 [代码]databaseMigrateExport[代码] 接口会创建一个数据库导出任务,并返回一个 job_id,这个 job_id 怎么用我们下面再说。显然数据库的数据导出并不是同步的,而是需要一定时间的,数据量越大导出所要花费的时间就越多,个人实测,2W 条记录,2M 大小,导出大概需要 3~5 S。 调用 [代码]databaseMigrateExport[代码] 接口需要传入环境 Id,存储文件路径,导出文件类型(1 为 JSON,2 为 CSV),以及一个 query 查询语句。 因为我们是做数据库备份,所以这里就导出 JSON 类型的数据,兼容性更好。需要备份的数据可以用 query 来约束,这里还是很灵活的,既可以是整个集合的数据,也可以是指定的部分数据,这里我们就使用 [代码]db.collection('data').get()[代码] 备份 data 集合的全部数据。同时我们使用当前时间作为文件名,方便以后使用时查找。 [代码]request.post( `https://api.weixin.qq.com/tcb/databasemigrateexport?access_token=${accessToken}`, { body: JSON.stringify({ env, file_path: `${date}.json`, file_type: '1', query: 'db.collection("data").get()' }) }, (err, res, body) => { if (err) { // 处理错误 return; } const data = JSON.parse(body); // data.job_id } ); [代码] 3. 查询任务状态,获取文件地址 在创建号数据库导出任务后,我们会得到一个 job_id,如果导出集合比较大,就会花费较长时间,这时我们可以使用 databaseMigrateQueryInfo 接口查询数据库导出的进度。 当导出完成后,会返回一个 [代码]file_url[代码],即可以下载数据库导出文件的临时链接。 [代码]request.post( `https://api.weixin.qq.com/tcb/databasemigratequeryinfo?access_token=${accessToken}`, { body: JSON.stringify({ env, job_id: jobId }) }, (err, res, body) => { if (err) { reject(err); } const data = JSON.parse(body); // data.file_url } ); [代码] 获取到文件下载链接之后,我们可以将文件下载下来,存入到自己的云存储中,做备份使用。如果不需要长时间的保留备份,就可以不用下载文件,只需要将 job_id 存储起来,当需要恢复备份的时候,通过 job_id 查询到新的链接,下载数据恢复即可。 至于 job_id 存在哪,就看个人想法了,这里就选择存放在数据库里。 [代码]await db.collection('db_back_info').add({ data: { date: new Date(), jobId: job_id } }); [代码] 4. 函数定时触发器 云函数支持定时触发器,可以按照设定的时间自动执行。云开发的定时触发器采用的 [代码]Cron[代码] 表达式语法,最大精度可以做的秒级,详细的使用方法可以参考官方文档:定时触发器 | 微信开放文档 这里我们配置函数每天凌晨 2 点触发,这样就可以每天都对数据库进行备份。在云函数目录下新建 [代码]config.json[代码]文件,写入如下内容: [代码]{ "triggers": [ { "name": "dbTrigger", "type": "timer", "config": "0 0 2 * * * *" } ] } [代码] 完整代码 最后,贴出可以在云函数中使用的完整代码,只需要创建一个定时触发的云函数,并设置好相关的环境变量即可使用 appid secret backupColl:需要备份的集合名称,如 ‘data’ backupInfoColl:存储备份信息的集合名称,如 ‘db_back_info’ 注意,云函数的默认超时时间是 3 秒,创建备份函数时,建议将超时时间设定到最大值 20S,留有足够的时间查询任务结果。 [代码]/* eslint-disable */ const request = require('request'); const cloud = require('wx-server-sdk'); // 环境变量 const env = 'xxxx'; cloud.init({ env }); // 换取 access_token async function getAccessToken(appid, secret) { return new Promise((resolve, reject) => { request.get( `https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=${appid}&secret=${secret}`, (err, res, body) => { if (err) { reject(err); return; } resolve(JSON.parse(body)); } ); }); } // 创建导出任务 async function createExportJob(accessToken, collection) { const date = new Date().toISOString(); return new Promise((resolve, reject) => { request.post( `https://api.weixin.qq.com/tcb/databasemigrateexport?access_token=${accessToken}`, { body: JSON.stringify({ env, file_path: `${date}.json`, file_type: '1', query: `db.collection("${collection}").get()` }) }, (err, res, body) => { if (err) { reject(err); } resolve(JSON.parse(body)); } ); }); } // 查询导出任务状态 async function waitJobFinished(accessToken, jobId) { return new Promise((resolve, reject) => { // 轮训任务状态 const timer = setInterval(() => { request.post( `https://api.weixin.qq.com/tcb/databasemigratequeryinfo?access_token=${accessToken}`, { body: JSON.stringify({ env, job_id: jobId }) }, (err, res, body) => { if (err) { reject(err); } const { status, file_url } = JSON.parse(body); console.log('查询'); if (status === 'success') { clearInterval(timer); resolve(file_url); } } ); }, 500); }); } exports.main = async (event, context) => { // 从云函数环境变量中读取 appid 和 secret 以及数据集合 const { appid, secret, backupColl, backupInfoColl } = process.env; const db = cloud.database(); try { // 获取 access_token const { errmsg, access_token } = await getAccessToken(appid, secret); if (errmsg && errcode !== 0) { throw new Error(`获取 access_token 失败:${errmsg}` || '获取 access_token 为空'); } // 导出数据库 const { errmsg: jobErrMsg, errcode: jobErrCode, job_id } = await createExportJob(access_token, backupColl); // 打印到日志中 console.log(job_id); if (jobErrCode !== 0) { throw new Error(`创建数据库备份任务失败:${jobErrMsg}`); } // 将任务数据存入数据库 const res = await db.collection('db_back_info').add({ data: { date: new Date(), jobId: job_id } }); // 等待任务完成 const fileUrl = await waitJobFinished(access_token, job_id); console.log('导出成功', fileUrl); // 存储到数据库 await db .collection(backupInfoColl) .doc(res._id) .update({ data: { fileUrl } }); } catch (e) { throw new Error(`导出数据库异常:${e.message}`); } }; [代码] 如果你有关于使用云开发CloudBase相关的技术故事/技术实战经验想要跟大家分享,欢迎留言联系我们哦~比心! [图片]
2019-10-12 - 云开发的数据库权限机制解读丨云开发101
在使用云开发进行开发时,数据库权限是一个让不少人困扰的部分,四种数据库权限,到底是什么意思?其各自的权限、应用场景都是什么?大多数人对于这个机制,还是模糊的。为了帮助大家进行更好的开发,在涉及到具体的代码之前,我们先来了解一下云开发的数据库权限机制。 一、为什么会有权限系统? 云开发和其他常见的开发模式有一处很大的不同就是,其数据库是可以在小程序端直接进行查询,而无需通过服务端提供的特定 API 接口来完成数据查询。这样就会出现一个问题,这个数据到底谁能查?谁不能查?能查到数据的人,能修改数据么? 在传统的应用开发模式中,权限的控制由服务端的后端接口完成,但是,在云开发的模式中,已经不存在传统的后端,因此,我们需要将权限控制进行向前移,但前端的代码因为无法保证安全(前端的数据可能被篡改,不可信),因此,我们需要将权限控制放在一个更加安全的地方,在经过多方权衡后,最终,云开发数据库就变成了云开发控制台中的一个选项。 二、云开发权限系统中的环境与角色 在云开发的权限中,我们会看到一些词,比如创建者、所有人、管理端,这些词应该如何理解呢? 其实这里在命名上是有一些问题的,管理端和创建者、所有人并不是一个好的对比,如果将管理端更名为管理员,会更容易理解。 [图片] 从权限的层面上来看,从管理端到创建者再到所有人,权限是依次收紧的。 管理端,或者叫管理员,其实便是指云开发中的云函数环境的执行权限。因为是在云函数中执行,安全系数较高,因而获得了最高的权限,也就是所谓的管理端权限。这个权限包括了对于所有的数据进行增、删、改、查的能力。 创建者,则指的是创建某条数据的用户,一般来说,是指在小程序端创建数据的用户。数据和用户之间的绑定是基于数据中的 [代码]_openid[代码] 来实现的,程序在执行中,当前用户的 openid 与数据的[代码]_openid[代码]一致时,就认为这个用户是数据的创建者。 所有人,指的是除了管理员以外的用户,这个用户一般而言,也是指小程序端的用户。数据和用户之间并不具备直接的关联关系。用户仅能通过数据库权限配置后的开放读取到用户。 三、关于四个不同的权限 云开发的数据库权限共四种,分别是: 1. 仅创建者可写,所有人可读 2. 仅创建者可读写 3. 仅管理端可写,其他人可读 4. 仅管理端可读写 这四种权限各自对应着不同的场景,接下来,我们借一些例子,来看一看四种权限的不同应用场景。 仅创建者可写,所有人可读 这种权限是我们使用最多的权限,特别是一些涉及到UGC的场景,我们一定会需要这个权限,因为我们的需求是产生的内容所有人均可读,写的层面则允许数据的创建者可写。 举个例子,如果你做了一个类似朋友圈的应用,那么你一定希望你的用户发的朋友圈可以被其他用户看到,但不能被其他用户修改,不然就乱套了。 仅创建者可读写 这种权限一般应用在一些用户的个人隐私信息的场景中。这些信息希望用户自己可以读取,但其他用户无法读取,此时,我们便需要仅创建者可读写。 举个例子,如果你做了个人相册的功能,那么你一定希望这个相册是只有你自己能看,而不是被所有人可以看到,因此,你需要选择仅创建者可读写,而不是仅创建者可写,所有人可读。 仅管理端可写,其他人可读 如果描述这个权限的特性,那么就是管理员可以修改,其他人只能看。最适合的场景莫过于各种需要由开发者、平台方管控的东西,比如新闻应用的轮播图列表、商城首页的活动信息等等。这些数据的关键在于所有人都可以看到,同时,所有人也只能看到,不能修改,只能有管理员修改。 举个例子,如果你做了一个电商小程序,那么在你的小程序中,你一定希望首页的推广 Banner 由你自己控制,而不是由用户自行控制,基于这样的考虑,你就需要仅管理端可写,其他人可读的权限。 仅管理端可读写 仅管理端可读写,你可以理解为只有云函数中有资格获取这个数据,其他的环境均不允许。这个权限在某些特定的场景下非常有用,举个例子,你的小程序的一些运行日志,你希望在云端可以查看,同时,这个日志不对普通用户展现,这个时候就可以设置为仅管理端可读写。 举个例子,如果你做了一个电商小程序,那么内部的统计数据就需要设置为仅管理端可读写,这样可以确保你的运营数据不会被普通用户所读取,尽可能避免信息的泄露。 四、常见问题 为什么没有所有人可读写的权限? 所有人可读写的数据库应用场景并不多见,而且大多数时候、可以通过管理端完成绕过。不过,如果你真的有了这样的场景,不妨思考一下,你的需求到底是什么?是不是因为你的数据库结构的不合理导致的需要所有人可读写? 所有人可读写数据会造成非常多的问题,比如数据原子化、数据锁等问题,因此,在你实现数据所有人可读写时,一定要考虑场景。 能不能实现更加细粒度的权限控制呢? 当然是可以的,实际上,云开发的数据库中每一条由小程序段完成添加的数据都有一个字段 _openid,我们在进行数据库查询时,系统会自动替我们完成这个字段的对比,如果对比不上,再去查询对应集合的权限控制,看是否给予了非创建者可读写的权限。 你自己在实现时,可以在数据创建时,根据业务需求,在数据中加入对应的字段,然后数据查询时,基于字段中的条件进行对比。 如果你对于云开发有任何问题,都欢迎你在文章留言出留下你的疑问,我们将一一解答。 更多云开发使用技巧及 Serverless 行业动态,扫码关注我们~ [图片]
2019-09-17 - 用云开发数据库实现列表触底自动加载功能丨云开发101
云开发数据库之触底自动加载 在前面的两篇文章中,我们简单的谈了谈云开发数据库与传统数据库的差异,以及云开发数据库中的权限机制,今天我们来分享一些实用的代码,快速帮助大家完成自己的小程序的部分功能。 微信小程序实现触底自动加载 在开发小程序类信息流类型的应用时,我们经常会有一个需求,就是当用户将列表滑动到列表的底部时,自动加载新的数据中,从而实现无限下拉,获得一个更好的体验。 大部分用户在进行传统应用开发时,能够实现类似的功能,但在进行云开发相关的开发时,就迷茫了。在云开发中,同样可以实现类似的功能,这一部分,我们就来看一看这部分的实现细节。 原理说明 在小程序中,触底自动加载的功能是基于页面的 [代码]onReachBottom[代码] 事件完成的,当触发此生命周期函数时,则说明小程序已经滑动到页面的底部,需要进行数据的加载。 在使用云开发进行数据加载时,我们可以通过在数据库查询语句中加入 [代码]skip(20)[代码] 来完成跳过所查询数据的前 20 条,从第 21 条开始查询,这样就得出了第二次加载的数据。 这里的 20 是因为云开发数据库 API 单次只能加载 20 条数据,如果你希望其每次只加载10条,可以在代码中加入一个 [代码]limit(10)[代码] 来实现 因此,如果实现页面的触底自动加载的功能,只需要在页面的 [代码]onReachBottom[代码] 中使用 [代码]skip[代码] 进行数据查询,并将该数据附加到原有的数据中,即可完成数据的触底自动加载功能。 实现代码 首先, 我们需要在 Page 实例中定义 [代码]onReachBottom[代码] 事件,并定义一个 [代码]loadData[代码] 函数,用于数据加载,后续,我们可以在 [代码]onLoad[代码] 和 [代码]onReachBottom[代码] 中调用 [代码]loadData[代码] 函数。 [代码]Page({ data:{ items:[] // 用于放置数据的数组。 }, onLoad:function(opt){ // 页面加载完成后,调用此函数 }, onReachBottom:function(){ // 页面滑动触底后,调用此函数 }, loadData:function(){ // 加载数据所用函数 } }) [代码] 为了确保调用时能够不写重复代码,我们可以在 onLoad 和 onReachBottom 中都调用 loadData 方法,从而减少重复代码量,则我们得到的代码如下。 [代码]Page({ data: { items: [] // 用于放置数据的数组。 }, onLoad: function (opt) { this.loadData() }, onReachBottom: function () { this.loadData }, loadData: function () { // 加载数据所用函数 } }) [代码] 这样,我们就完成了 Page 中的基础代码的编写,接下来我们来编写 loadData 中的代码,实现数据的加载。 对于 loadData 函数,我们需要它首先获取到当前已有数据(默认初始化进入页面时,默认数据为空),然后基于已有数据的长度,进行跳过查询,从而查询当前从未查询的数据。 在获取到新的数据以后,使用 Array 的 [代码]concat[代码] 方法,将新的数据拼接进入到老的数据中,从而获得了一个更大的数组,完成数据的新增。具体代码实例如下: [代码]loadData: function () { let old_data = this.data.items; const db = wx.cloud.database(); db.collection('items').where({ done: false, }).skip(old_data.length).get().then(res => { this.setData({ items:old_data.concat(res.data.data) }) }) } [代码] 最终,我们得到的 Page 实例的代码如下 [代码]Page({ data: { items: [] }, onLoad: function (opt) { this.loadData() }, onReachBottom: function () { this.loadData }, loadData: function () { let old_data = this.data.items; const db = wx.cloud.database(); db.collection('items').where({ done: false, }).skip(this.data.items.length).get().then(res => { this.setData({ items:old_data.concat(res.data.data) }) }) } }) [代码] 在完成了 Page 实例的代码以后,我们需要调整页面结构的代码,从而确保我们的数据在进行循环时,不会因为新增数据导致数据错位。这需要我们使用一个唯一的 Key 作为 [代码]wx:key[代码] 的值,具体的实现代码如下: [代码]<view wx:for="{{items}}" wx:key="_id"> {{item}} </view> [代码] 这段代码实现了使用云开发所自带的 ObjectId 作为 [代码]wx:key[代码] 的的值,从而确保我们的数据更新完成以后,不会出现数据错位的情况。 这样,我们就完成了触底自动加载的功能。 参考文献: 小程序 Page 构造器说明:https://developers.weixin.qq.com/miniprogram/dev/reference/api/Page.html 更多云开发使用技巧及 Serverless 行业动态,扫码关注我们~ [图片]
2019-09-24 - 云开发常用数据结构设计剖析丨云开发101
云开发常用数据结构设计 在使用云开发进行产品开发的时候,我们常常需要思考,我们的应用的数据结构应该如何设计,今天我们来看一些在进行应用开发时常见的一些场景的数据结构,来帮助你更好的理解云开发,以及不同场景下云开发的应用。 场景一:用户个人信息表 功能:判断用户是否注册/留存用户信息以备查询 在绝大多数场景下,用户信息都是我们需要保存的信息,或者我们需要判断一个用户是否注册时,我们会使用用户个人信息表来做判断。这个时候,我们可以借助用户个人信息表来完成功能。 [图片] 在完成这部分功能时,我们需要创建一个名为 [代码]profiles[代码] 的集合,用于存储用户的信息,同时,我们需要将 profiles 集合设置为仅创建者可读写,这样可以确保后续我们功能可以实现。 判断用户是否注册 由于我们将 [代码]profiles[代码] 集合设置为仅创建者可读写,因此,当用户在执行数据查询时,仅能查到自己创建的数据,因此,当我们需要实现判断用户是否注册时,只需要对集合内的数据进行查询,便可知道用户是否创建过数据。 基于这样的机制,我们可以让用户在注册时在 [代码]profiles[代码] 表中创建一个数据,这样在后续判断用户是否注册时,只需要查询是否创建数据,便可以知道用户是否已经注册。 [图片] 这里我们举个例子,当数据库中有 [代码]_openid[代码] 分别为 [代码]aa[代码]、[代码]bb[代码]、[代码]cc[代码] 的三条记录,如果当前用户的 openId 为 aa,则它执行 [代码]db.collection('profiles').count()[代码]时,得到的结果是 1 ,则表示这个用户已经注册了。如果当前用户的 openId 为 dd,因为权限是仅能查询自己创建的数据,因此,在执行 [代码]db.collection('profiles').count()[代码]时,得到的结果是0。 对于结果为 1 的,就视为该用户已经注册;对于结果为 0 的,就视为该用户未注册。 新用户注册时的操作 由于我们是基于 count 的结果来判断用户是否注册,因此,就要求我们在完成用户注册(获取用户基本信息,如头像、昵称)时,在 [代码]profiles[代码] 表中添加一个数据,从而用于后续的判断。 则在开发时,我们需要注意,在使用 getUserInfo 相关的组件和接口完成数据的获取后,我们需要在 [代码]profiles[代码] 表中添加一条数据,具体的代码可以参考下方的代码 [代码]Page({ bindGetUserInfo:function(userInfo){ const db = wx.cloud.database() db.collection('profiles').count().then(res => { if (res.total === 0){ db.collection('profiles').add({ data:userInfo }).then(res => { // 完成数据新增,即,完成注册的步骤 }) } }) } }) [代码] 这样我们就完成判断用户注册的最核心的部分,你如果需要在自己的应用中判断用户是否已经完成注册的流程,可以借助这样的方式,完成这部分的需求。 场景二:文章/视频/内容表 一般来说,我们的小程序中会或多或少加入一些内容方面的内容,有的是由官方发布的,有的是由用户发布的,根据发布者的不同,我们可以设计两种不同的表结构 仅能由官方发布的内容/文章/视频 对于仅限于官方发布的,我们可以考虑创建一个集合,名为 [代码]contents[代码],并将其权限设置为仅管理端可写,其他人可读,这样我们所添加的数据仅能在云函数中进行修改,而不能在小程序由普通用户修改,这样就可以确保我们的数据的修改必须经过云函数的确认,在云函数中,我们可以进行权限的判断,比如,某几个特定的人有权限修改数据。 由用户发布的内容/文章/视频 对于一些 UGC 的应用,我们需要用户产生内容时,可以考虑创建一个集合,名为 [代码]contents[代码] ,并将其权限设置为仅创建者可写,所有人可读,这样就可以实现用户自行发布的内容,可以被其他所有用户查看。同时,数据的创建者可以对数据进行修改。 场景三:用户评论表 当我们涉及到一些内容时,就常常会涉及到用户的评论的功能,在进行开发时,评论的存放位置也会让很多人迷茫,到底应该将评论放在文章的子级,还是要放在一个单独的集合中? 这一部分关键在于: 你是否有需求将所有的评论进行排序等操作 你是否有需求在用户个人的信息中显示其所有评论 如果你有上述两个中任何一个或多个需求,那么你都需要新建一个 collection,将所有评论都放在集合中,并将其对应的内容的 _id 放在评论中,用以后续的查询。 如果你没有上述需求,则可以考虑将评论放在文章/视频条目中的子属性中,随着文章/视频一同查询出来。 总结 这篇文章我们分享了一些常见场景下的数据库结构设计,如果你还对其他场景下的数据库结构设计不慎明了,可以在文章下方留言,我们后续更新文章来说明。 更多云开发使用技巧及 Serverless 行业动态,扫码关注我们~ [图片]
2019-09-24 - useExtendedLib.weui=true时,usingComponents中组件路径怎么写?
[图片] [图片] [图片]
2020-05-09 - 如何使用数据库聚合match过滤$.and
我需要在云函数中查询数据库,聚合计算一个人的某月1-31号的消费金额: [代码]let queryFeeSum = await db[代码][代码] [代码][代码].collection([代码][代码]'lunch'[代码][代码])[代码][代码] [代码][代码].aggregate()[代码][代码] [代码][代码].match({[代码][代码] [代码][代码]eno: eno,[代码][代码] [代码][代码]date: $.and([$.gte([[代码][代码]'$date'[代码][代码], dateNumRange.begin]), $.lte([[代码][代码]'$date'[代码][代码], dateNumRange.end])])[代码][代码] [代码][代码]})[代码][代码] [代码][代码].group({[代码][代码] [代码][代码]_id: [代码][代码]null[代码][代码],[代码][代码] [代码][代码]fee: $.sum([代码][代码]'$goodsPrice'[代码][代码])[代码][代码] [代码][代码]})[代码][代码] [代码][代码].end()[代码]date是数值型:它的值是8位整数,如20190701、20190728 上面的 $.and 语句按文档中的写法,聚合这个功能也是官方开发出来不久,找不到相关帮助文档。 运行报错,查看日志提示: {"errorCode":1,"errorMessage":"user code exception caught","stackTrace":"errCode: -502001 database request fail | errMsg: [FailedOperation] (BadValue) unknown operator: $and; "} 请问一下,为什么提示操作失败,无效的值、未知的操作器$and。
2019-07-28 - 云开发 聚合阶段 match无法根据时间查询
如图,同样根据时间查询,where里面可以执行,match内执行报错;仅服务端,客户端无此BUG,SDK版本如下。 另外,请提供事务能力,否则有很多业务场景操作没法回滚 [图片] [图片] [图片]
2019-11-05