小程序云开发小计

前言

最近申请了个人小程序，来做一些记录，最初打算使用localstorage存在本地就齐活儿了，可是要接定时推送，就选择了云开发。之前用的云开发是团队搭建过的，这次尝试自己从头来一遍，熟悉一下整个流程，顺便蹚蹚雷。

技术栈：uniapp v3

开发

第一步

首先肯定是开通服务，开发者工具里点击云开发，里面会有开通提示，一步一步走下去就能正常开通了。

image.png

设置云函数路径

在manifest.json里设置"cloudfunctionRoot": "cloudfunctions/"，云函数可以写在这里，函数名称为文件夹，内容结构为config.json、index.js、package.json，具体内容见下面图示例
config.json是声明函数的配置信息，比如接口权限、定时触发器等；
index.js名称可以修改，是云函数执行入口；
package.json就是云函数的具体信息和依赖，执行入口可以在里面修改。

image.png

新建云函数

这里需要注意的是，uniapp项目在本地新建的文件夹是没有办法同步到云函数列表去的。云函数的新建可以在云开发后台，也可以在开发者工具里，点击右键有新建云函数。如果是在后台建的函数，可以点击同步云函数列表。

image.png

uniapp在编译的时候，cloudfunctions文件夹是不会编译到小程序的路径里去的，这就导致一开始的时候不知道该怎么去新建函数。如果此时在开发者工具里新建cloudfunctions文件夹，也是可用的，只是文件夹被建在了dist下面，无法同步代码，因此大聪明选择了cp -rf cloudfunctions/ dist/dev/mp-weixin/cloudfunctions把它整个copy过去，###口袋空空大口大口###这时候开发者工具里就有我建好的云函数了。如果文件是新增的没有部署过，需要右键选择云函数增量上传，发布部署就可以调用了。

image.png

\color{red}{云函数修改之后，一定要重新上传部署，否则是无法执行更新的。}

调用云函数

云函数在调用之前需要先初始化，否则会报错Error: errCode: -1 | errMsg: Cloud API isn't enabled, please call wx.cloud.init first 请先调用 wx.cloud.init() 完成初始化后再调用其他云 API。。

wx.cloud.init({
  env: 'XXXXXX'
});

// 执行云函数
wx.cloud.callFunction({
    name: 'funcitonname', // 对应云函数的文件夹名称
    data: 'params', // 传参
    success: res => {
        console.log('云函数调用成功,返回数据res：', res);
    },
    fail: err => {
        console.error('云函数调用失败', err);
    },
});

通知

通过小程序订阅消息subscribeMessage.send来实现，需要在小程序里授权订阅消息requestSubscribeMessage，详见文档。

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

cloud.init({ env: cloud.DYNAMIC_CURRENT_ENV }); // 使用当前云环境

// 云函数入口函数
exports.main = async event => {
    await cloud.openapi.subscribeMessage.send({
        touser: openid,
        page: 'pages/index/index',
        data: {
            thing1: {
                value: goods.data[0].name
            },
            date3: {
                value: goods.data[0].expire
            }
        },
        miniprogram_state: 'formal', 
        templateId: 'templateid'
      });
    }

    return 'success';
};

定时器

通知实现了之后，就是定时推送了，我希望实现的是每天早上10点发推送，这里用到了云函数的定时触发器，根据文档介绍，修改一下配置。

// config.json
{
    "permissions": {
        "openapi": []
    },
    "triggers": [
        {
            "name": "expireNoticeTrigger",
            "type": "timer",
            "config": "0 0 10 * * * *"
        }
    ]
}

然而，只是这样的话，并不会如我们所期待的那样定时执行。因为触发器需要单独上传，config.json右键选择上传触发器就可以正常执行了。

image.png

结语

到此处，需求基本实现，云开发并没有想象的复杂，但是开发过程中还是有很多的细节点需要注意。至于云函数的内容，就是通过数据库做一些基础的crud，官方文档介绍的比较详细，有需要的可以看看。