【小程序 + 云开发】体重记录小程序 上手笔记

刚刚提交的小程序审核通过了，把笔记发出来。 前一段看到朋友圈里总是有人用txt记录体重，就特别想写一个记录体重的小程序， 现在小程序的云开发有云函数、数据库，真的挺好用，很适合个人开发者，服务器域名什么都不用管，云开发让你完全不用操心这些东西。

先看看页面效果图吧：

1. 全局变量 globalData
2. npm 的使用
3. 云函数
4. 数据库操作
5. async 的使用
6. 分享的配置
7. antV使用
8. tabBar地址跳转
9. 切换页面刷新

1.全局变量 globalData

首次进入后，要存储openId给其他页面使用，使用globalData共享。

<!--app.js 设置 globalData.openid --> 
App({
  onLaunch: function () {

    this.globalData = {}

    wx.cloud.init({})

    wx.cloud.callFunction({
      name: 'login',
      data: {},
      success: res => {
        this.globalData.openid = res.result.openid
        wx.switchTab({
          url: '/pages/add/add',
          fail: function(e) {}
        })
      }, 
      fail: err => { 
     
      }
    })

  }
})

<!--其他页面引用-->
const app = getApp()  // 获得实例
app.globalData.openid // 直接引用即可
复制代码

2.npm 的使用

1. 进入小程序源码miniprogram目录，创建package.json文件（使用npm init一路回车）
2. npm i --save 我们要安装的npm包
3. 设置微信开发者工具 构建npm
4. package.json增加"miniprogram": "dist"打包目录字段，如果不设置的话上传和预览不成功，提示文件包过大。

cd miniprogram
npm init 
npm i @antv/f2-canvas --save   // 我用到了f2，可以换成其他包
复制代码

设置微信开发者工具

最后，务必添加miniprogram字段

{
  "name": "21Day",
  "version": "1.1.0",
  "miniprogram": "dist",
  "description": "一个21天体重记录的app",
  "license": "MIT",
  "dependencies": {
    "@antv/f2-canvas": "~1.0.5",
    "@antv/wx-f2": "~1.1.4"
  },
  "devDependencies": {}
}
复制代码

3.云函数

官方解释云函数即在云端（服务器端）运行的函数，服务端是node.js，都是JavaScript。官方有数据库的操作，但是更新的操作强制要求使用云函数, 另外，如果云函数中使用了npm包，记得在所在云函数文件夹右键上传并部署，不然运行失败。

上一个例子，更新体重的云函数

// 云函数
const cloud = require('wx-server-sdk')
const moment = require('moment')

cloud.init(
  { traceUser: true }
)

const db = cloud.database()
const wxContext = cloud.getWXContext()

exports.main = async (event, context) => {
  // event 入参参数
  delete event.userInfo
  try {
    return await db.collection('list').where({
      _openid:wxContext.OPENID,
      date:moment().format('YYYY-MM-DD')
    })
    .update({
      data: {
      	...event
      },
    })
  } catch(e) {
    console.error(e)
  }
}
复制代码

小程序端调用

wx.cloud.callFunction({
     name: 'add',
     data: {
      ...Param
     },
     success: res => {
        wx.showToast({
          title: '新增记录成功',
        })
     },
     fail: err => { 
        wx.showToast({
          icon: 'none',
          title: '新增记录失败'
        })
     }
   })
复制代码

4.数据库操作

其实是接入的MongoDB，封装了一部分api出来，详细的就看官方文档把，有区分服务端和小程序段。

const db = wx.cloud.database()

// 查询数据
db.collection('list').where({
    _openid: app.globalData.openid,
    date: moment().subtract(1, 'days').format('YYYY-MM-DD'),
}).get({
    success: function (res) {
        // do someThing
    }
})
复制代码

5.async 的使用

<!--事例-->
const regeneratorRuntime = require('../../lib/runtime.js')
onLoad: async function (options) {

    // 获取当天数据
    await this.step1()

    // 时间类型设置
    let nowHour = moment().hour(),timeType
    nowHour > 12 ? timeType = 'evening' : timeType = 'morning'
    this.setData({timeType})
  }
复制代码

6.分享的配置

分享很简单，有区分右上角的直接分享和点击按钮分享

onShareAppMessage: function (res) {
        
      // 右上角分享
      let ShareOption = {
        title: '21天体重减肥记录',
        path: '/pages/index/index',
      } 
      
      // 按钮分享
      if(res.from == "button"){
        ShareOption = {
            title: '来呀 看看我的减肥记录呀',
            path: '/pages/detail/detail?item=' + app.globalData.openid,
          } 
      }
      
      return ShareOption
  }
复制代码

分享后，他人点击页面，跳转到对应pages地址，从onLoad的options中拿入参请求数即可

onLoad: function (options) {
    const db = wx.cloud.database()
    let This = this
    let resault = {}
    db.collection('list').where({
      _openid: options.item
    }).get({
      success: function (res) {
        resault = res.data
        This.setData({
          resault:resault
        })

      }
    })
  },
复制代码

7.antV使用

上边第二小节有提到antV的安装，就不再赘述，直接说一下再页面中引用。

说下使用，需要设置一个全局变量储存图表的实例，然后在钩子函数内容使用changeData方法修改数据。

index.json中引入包名

{
  "usingComponents": {
  	"ff-canvas": "@antv/f2-canvas"
  }
}
复制代码

// 引入F2
import F2 from '@antv/wx-f2';

// 设置实例全局变量（务必）
let chart = null;
function initChart(canvas, width, height, F2) { // 使用 F2 绘制图表
  let data = [
    // { timestamp: '1951 年', step: 38 },
  ];

  chart = new F2.Chart({
    el: canvas,
    width,
    height
  });

  chart.source(data, {
    step: {
      tickCount: 5
    },
    timestamp: {
      tickCount: 8
    },

  });


  chart.axis('timestamp', {
    label(text, index, total) {
      const textCfg = {};
      if (index === 0) {
        textCfg.textAlign = 'left';
      }
      if (index === total - 1) {
        textCfg.textAlign = 'right';
      }
      return textCfg;
    }
  });

  chart.axis('step', {
    label(text) {
      return {
        text: text / 1000 + 'k步'
      };
    }
  });

  chart.tooltip({
    showItemMarker: false,
    onShow(ev) {
      const { items } = ev;
      items[0].name = null;
      items[0].name = items[0].title;
      items[0].value = items[0].value + '步';
    }
  });
  chart.area().position('timestamp*step').shape('smooth').color('l(0) 0:#F2C587 0.5:#ED7973 1:#8659AF');
  chart.line().position('timestamp*step').shape('smooth').color('l(0) 0:#F2C587 0.5:#ED7973 1:#8659AF');
  chart.render();
  return chart;
}

// 生命周期函数
onLoad(){
    // 使用changeData赋值
    chart.changeData(stepInfoList)
}
复制代码

8.tabBar地址跳转

如果要跳转的地址不在app.json的tabBar内可以使用wx.navigateTo，如果在死活跳不过去，要使用wx.switchTab方法跳转。

wx.switchTab({
  url: '/pages/add/add',
  fail: function(e) {}
})

wx.navigateTo({
  url: '../deployFunctions/deployFunctions',
})
复制代码

9.切换页面刷新

切换几个tabBar的时候，需要刷新数据。 在onShow方法中再调用一下onLoad方法就可以了。

onShow: function () {
    this.onLoad()
}
复制代码

感受

1. 很适合个人开发者，想开发一个小程序，除了时间，完全没有其他费用
2. 报错提示不友好，有时候不执行不报错，只能一行一行debug。
3. 审核超快，几个小时就审核通过了。
4. lodash不支持，据说要修改点东西，就没鼓捣。
5. git也配置上了，真的是方便，再感叹一下，不过语法真的是。。。。不想用。

后记

不知道自己能更几个版本，不过跟着练习呗，空了就更新。 立个flag，写下list 哈哈。

• v1.0
  1. 挑战邀请页
• v2.0
  1. 每日一句减肥知识
  2. 社交奖励
  3. 签到后鼓励语句
  4. 朋友圈图片分享
• v3.0
  1. 排行榜
  2. 好习惯发表
  3. 等级区分

码字码到手酸，为自己加油。