小程序实战:云函数开发及本地调试(意见反馈实例)

本次实例开发意见反馈模块,功能非常简单,用户填写意见保存到云数据库同时可查看历史数据。

功能说明

云开发/云函数

开发者可以使用云开发开发微信小程序、小游戏,无需搭建服务器,即可使用云端能力。

云开发为开发者提供完整的原生云端支持和微信服务支持,弱化后端和运维概念,无需搭建服务器,使用平台提供的 API 进行核心业务开发,即可实现快速上线和迭代,同时这一能力,同开发者已经使用的云服务相互兼容,并不互斥。

云函数云开发其中一项基础能力,在云端运行的代码,微信私有协议天然鉴权,开发者只需编写自身业务逻辑代码。详细内容请见云函数文档

云开发有免费版,足以应付个人开发者的需求。

好了,废话少说,开始干活!

创建云环境

  1. 点击微信开发工具左上角云开发按钮进入云开发控制台并开通
  2. 填写云环境名称,支付方式选择预付费:个人账户扣款
  3. 配额选择资源均衡型+基础版1 0元/月
  4. OK

云开发创建

云资源配额

至此云资源创建完成,可以在小程序中调用(若只有一个云资源则调用时无需指定资源名称), 在项目目录创建cloudfunctions目录后开发工具将识别该文件夹为云资源目录并加载环境,如需修改目录名称可在project.config.json中修改cloudfunctionRoot属性的值(wepp-tools 项目使用 cloud 作为云资源目录)。

提交反馈

对于存在用户输入的页面,需要做内容安全检查,否则小程序可能无法过审

页面设计

<van-panel>
    <van-cell slot="header" title="意见标题">
        <van-icon name="question-o" size="20px" dot />
    </van-cell>
    <van-field model:value="{{ title }}" border="{{ true }}" custom-style="background:#fcfcfc;" />
</van-panel>
<van-panel title="描述信息" desc="详细的描述能让我们更好理解">
    <van-field
        model:value="{{ detail }}"
        type="textarea"
        placeholder="请输入详细内容"
        autosize = "{{ {maxHeight:180, minHeight:100} }}" custom-style="background:#fcfcfc;"
        border="{{ true }}"
    />
</van-panel>

意见反馈首页

新建内容检测云函数

  1. 右键云资源目录选择新建 Node.js 云函数
  2. 每个云函数单独目录,包含config.jsonindex.jspackage.json 三个基础文件(见下图)

云函数结构

config.json中声明用到的 api

"permissions": {
    "openapi": [
        "security.msgSecCheck"
    ]
}

index.js中编写云函数的逻辑代码

// 云函数入口文件
const cloud = require('wx-server-sdk')
cloud.init()

const db = cloud.database()
//表名,使用该表前需要先在云控制台新建(集合)
let TABLE = "issue"

// 云函数入口函数
exports.main = async (event, context) => {
    let { action } = event
    let { OPENID, APPID } = cloud.getWXContext()

    //录入新意见
    if(action === "save"){
        let { title, detail } = event
        console.log("录入新反馈:", title, detail)
        
        //内容安全检查
        try{
            const msgCheckRe = await cloud.openapi.security.msgSecCheck({
                content: title+detail
            })
            console.debug("内容检测结果:", msgCheckRe)
            if(msgCheckRe.errCode == 0){
                let data = {
                    openId: OPENID,
                    title,
                    detail,
                    createOn: getDateTime(),
                    reply: "",
                    replyOn:""
                }
                
                const insertRe = await db.collection(TABLE).add({ data })
                return insertRe
            }
            return msgCheckRe
        } catch (err){
            return err
        }
    }
    //查看历史数据
    else if(action === 'history') {
        return await db.collection(TABLE).where({openId: OPENID}).orderBy("createOn", "desc").limit(PAGE_SIZE).get()
    }
    else
        return {
            errCode: -1,
            errMsg:"无效的操作"
        }
}

题外话

云函数个数

免费版云函数数量上限为 50(详见配额说明),且用且珍惜,所以我将某个模块下所有云函数集中为一个,通过参数action区分操作。

关于资源使用量

云函数有资源使用量一说。资源使用量 = 函数配置内存 * 运行计费时长。用户资源使用量,是由函数配置内存,乘以函数运行时的计费时长得出,其中配置内存转换为 GB 单位,计费时长由毫秒(ms)转换为秒。故资源使用量的计算单位为 GBs。例如,配置为 256MB(默认值) 的函数,单次运行了 1760 ms,计费时长为 1800 ms,则单次运行的资源使用量为 (256/1024)*(1800/1000) = 0.45 GBs。针对函数的每次运行,均会计算资源使用量,按月汇总求和作为当月的资源使用量。

免费云服务每月配额40万 GBs,如果资源紧张可以适当调整云函数的运行内存🤣。

调用云函数

// app.js   封装了全局函数
/**
 * 调用云函数
 * @param {*} name         云函数名称
 * @param {*} data          参数
 * @param {*} callBack 
 */
callCloud  (name, data, callBack){
    if(!cloudInited) {
        wx.cloud.init()
        cloudInited = true
        console.debug(`初始化云开发环境...`)
    }

    console.debug(`开始执行云函数调用 name=${name} ...`)
    wx.cloud.callFunction({
        name,
        data,
        success: (res)=>{
            console.debug(`来自云函数${name}的调用结果:`, res.result)
            callBack(res.result)
        },
        fail: err=>{
            console.error("云函数调用失败", err.errCode, err.errMsg)
            console.log(err)
        }
    })
}

// issue.js
// 保存用户输入的反馈信息
onSave (){
    let {title, detail} = this.data
    if(!title)  return util.warn(`标题不能为空`)
    
    this.setData({working: true})
    getApp().callCloud("issue", {action:"save", title, detail}, res=>{
        if(res.errCode == 87014){
            util.warn(`检测到违法违规内容`)
        }else if("_id" in res){
            util.warn(`反馈提交成功`)
            this.setData({title:"", detail:""})
        }
        this.setData({working: false})
    } )
}

查看历史反馈

getApp().callCloud("issue", {action:"history"}, res=>{
    this.setData({historyLoaded: true, issues: res.data})
})

查看历史

云函数本地调试

新增的云函数在本地(能够通过console.log输出信息)多方位测试符合预期再发布到云环境,对于已经有线上版本的云函数更是如此

在云函数右键菜单选择开启云函数本地调试即可进入本地调试,若 npm 依赖未安装工具会给出提示,点击确认可完成安装(若安装失败可尝试手动执行npm i)。

打开本地调试面板后,可在右侧看到有两种请求方式:

  1. 模拟器触发 此时模拟器中运行的小程序所发送的云函数调用将转到本地云函数
  2. 手动触发 手动填写参数并触发云函数(方便测试)

请求方式


往期文章

  1. 微信小程序开发基础(胎儿体重测算工具实例)

扫码或微信搜索集成工具集体验小程序 关注公众号
扫码(微信搜索集成工具集)体验小程序 / 关注公众号
  • 1
    点赞
  • 6
    收藏
    觉得还不错? 一键收藏
  • 打赏
    打赏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

集成显卡

码字不易,需要您的鼓励😄

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付:¥1
获取中
扫码支付

您的余额不足,请更换扫码支付或充值

打赏作者

实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值