微信小程序开发入门教程（一）---hello world

由于无法备案网站，前期做了个微信小程序（开发版）就搁置了，几乎忘了开发过程。现在重新梳理，做个记录。

一、最基本的小程序前端例子hello

1、下载安装  微信开发者工具  官网： https://developers.weixin.qq.com/miniprogram/dev/devtools/devtools.html  

2、运行后首先提示扫码，在手机上确认登录（我以前注册过微信公众平台，如果你未注册过的话，可能需要先去注册）。登录后，页面显示了我之前做的几个小程序项目。排第一个的是一个加号（+），用来新建项目。

3、点上步的加号（+），新建项目名称写的是：hello  ； 目录 我设的是：E:wxDEVhello；AppId 我点选的是：测试号；开发模式：小程序；后端服务：默认不使用云服务；语言：javascript ; 然后点：新建

4、在 微信开发者工具 界面上，点三个横点（…）弹出E:wxDEVhello硬盘目录，里面就是小程序前端代码了。点预览（眼睛形状）图标，会弹出二维码，用手机扫码后，可以在手机上测试使用小程序了。（在手机微信中的微信页面，向下滑动，会出现最近使用过的小程序）

5、但那些代码表示什么呢？手册在：https://developers.weixin.qq.com/miniprogram/dev/framework/  下面分析一下E:wxDEVhello中的代码文件

5.1、sitemap.json  文件中有个链接：https://developers.weixin.qq.com/miniprogram/dev/framework/sitemap.html；看了一下，是控制微信爬虫，即是否允许页面内容被用户搜索到

5.2、project.config.json  项目配置文件:https://developers.weixin.qq.com/miniprogram/dev/devtools/projectconfig.html   如：可以设置为小程序插件项目。

5.3、app.wxss    https://developers.weixin.qq.com/miniprogram/dev/framework/view/wxss.html 相当于CSS样式表文件。

5.4、app.json  https://developers.weixin.qq.com/miniprogram/dev/framework/config.html#%E5%85%A8%E5%B1%80%E9%85%8D%E7%BD%AE  小程序配置，又分为全局配置和页面配置。如：有哪些页面，页面标题、颜色等

5.5、app.js https://developers.weixin.qq.com/miniprogram/dev/framework/app-service/app.html 注册小程序APP实例，大概相当于程序入口的main函数吧。

6、目录utils下有util.js 大概是引入外部 js文件；参考：https://www.cnblogs.com/wangting888/p/9701658.html

7、目录pages下有两个目录，index和logs,每个目录表示一个小程序页面。其中，后缀为.wxml的相当于html页面，其它类似前面介绍的，分别是样式表、配置和js代码文件。参考：https://developers.weixin.qq.com/miniprogram/dev/framework/view/wxml/

二、只有前端是不够的，没条件搭服务器怎么办？好在微信开发者工具提供了强大的云开发能力，参考上面步骤，新建项目helloyun（云端是node.js语言）

1、参考上面第3步新建小程序项目，项目名称：helloyun  ;  目录：E:wxDEVhelloyun ; AppID:只能选择自己注册的AppID,测试号无法云开发；开发模式：小程序；后端服务：小程序云开发；然后点 新建。云开发的例子已生成。可以点预览，并在手机上查看了。手机上小程序本身就相当于教程，其中介绍了两种操作云端数据库（或函数、调用）的办法：一是前端操作数据库；二是在cloudfunctions目录中新建云函数，使用wx-derver-sdk

参考：https://developers.weixin.qq.com/miniprogram/dev/wxcloud/basis/getting-started.html

2、云开发项目的目录看似更简洁，E:wxDEVhelloyun目录结构如下：

－－cloudfunctions（目录）

－－miniprogram（目录）

－project.config.json

－README.md

3、miniprogram对应的小程序前端（与本文第一部分类似），对应云端的是cloudfunctions目录（2019年8月8日生成的云开发项目，与以前用旧版开发工具生成的目录结构不一样了），新版的 E:wxDEVhelloyuncloudfunctions 目录下有4个目录：

－callback

－echo

－login

－openapi

4、先从手机的云开发QuickStart入手，点上传图片，然后拍照上传。根据上传后的提示，打开开发者工具，点云开发，进入云开发控制台（确认你是否已开通了云开发功能），在 存储 下，可以看到刚上传的my-image.jpg。

我们还是从前端入手分析，在开发者工具中， 查看E:wxDEVhelloyunminiprogrampagesindexindex.wxml  的代码。找到 上传图片 字样。对应的bindtap是

doUpload。在同目录的E:wxDEVhelloyunminiprogrampagesindexindex.js 中，找到doUpload，可看出上传照片最主要的是用wx.chooseImage和

wx.cloud.uploadFile。

5、多次拍照上传，会发现上传照片会被覆盖，于是在上一步的doUpload函数中加个随机数，由原来的：

const cloudPath = 'my-image' + filePath.match(/.[^.]+?$/)[0]  改为：

const cloudPath = 'my-image'+ Math.random() + filePath.match(/.[^.]+?$/)[0]   

然后上传的图片就不会被覆盖了。

我们还可以在云存储中新建目录 如：goods   然后将代码改为：

const cloudPath = 'goods/my-image' + Math.random() + filePath.match(/.[^.]+?$/)[0]  ，

编译，预览，你会发现图片上传到了云存在的goods目录下。

6、上手云数据库 https://developers.weixin.qq.com/miniprogram/dev/wxcloud/guide/database/getting-started.html

在  云开发控制台 的  数据库  中创建  goods 集合名称。设置权限为所有人可读。

为了方便测试，在E:wxDEVhelloyunminiprogrampagesindexindex.wxml 的最后一个</view>之前，加以下代码

<view class="uploader">
<button class="uploader-text" bindtap="mydbadd">数据库add</button>
</view>

同时，在E:wxDEVhelloyunminiprogrampagesindexindex.js的最后一个})之前，加以下代码（也就是E:wxDEVhelloyunminiprogrampagesdatabaseGuidedatabaseGuide.js中的代码）

//my测试数据库add
  mydbadd: function() {
    const db = wx.cloud.database()
    db.collection('goods').add({
      data: {
        count: 1
      },
      success: res => {
        // 在返回结果中会包含新创建的记录的 _id
        this.setData({
          counterId: res._id,
          count: 1
        })
        wx.showToast({
          title: '新增记录成功',
        })
        console.log('[数据库] [新增记录] 成功，记录 _id: ', res._id)
      },
      fail: err => {
        wx.showToast({
          icon: 'none',
          title: '新增记录失败'
        })
        console.error('[数据库] [新增记录] 失败：', err)
      }
    })
  },

编译，点击  数据库add按钮  后，会看到后台数据库中新增了一条记录（确保已在后台数据库中设置了goods集合）。开发者工具 控制台console中也有相应的提示。

7、上手云函数 https://developers.weixin.qq.com/miniprogram/dev/wxcloud/guide/functions/getting-started.html

在开发者工具中的 cloudfunctions目录 点鼠标右键，可以新建、上传、同步云函数（也可直接在）。从云开发控制台中可以看到我以前写的几个云函数，忘了是干什么用的，可以同步到本地查看。同步下来后，在开发者工具中的相应目录图标会变成一朵云。

在项目根目录找到 project.config.json 文件，可以看到已经有了cloudfunctionRoot 字段（如果没有，就按官方教程增加）

然后在开发者工具中的 cloudfunctions目录 点鼠标右键，增加名为sum的云函数，会在 cloudfunctions目录下生成sum目录及E:wxDEVhelloyuncloudfunctionssumindex.js

让我们在index.js中的返回值中增加一句：sum: event.a + event.b，即，将index.js的代码修改如下：

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

cloud.init()

// 云函数入口函数
exports.main = async (event, context) => {
  const wxContext = cloud.getWXContext()

  return {
    event,
    openid: wxContext.OPENID,
    appid: wxContext.APPID,
    unionid: wxContext.UNIONID,
    sum: event.a + event.b,
  }
}

为了省事，我直接修改了上面第6步的    mydbadd函数代码

//my测试数据库add
  mydbadd: function() {
    const db = wx.cloud.database()
    db.collection('goods').add({
      data: {
        count: 1
      },
      success: res => {
        // 在返回结果中会包含新创建的记录的 _id
        this.setData({
          counterId: res._id,
          count: 1
        })
        wx.showToast({
          title: '新增记录成功',
        })
        console.log('[数据库] [新增记录] 成功，记录 _id: ', res._id)
      },
      fail: err => {
        wx.showToast({
          icon: 'none',
          title: '新增记录失败'
        })
        console.error('[数据库] [新增记录] 失败：', err)
      }
    })
    wx.cloud.callFunction({
      // 云函数名称
      name: 'sum',
      // 传给云函数的参数
      data: {
        a: 1,
        b: 2,
      },
    })
      .then(res => {
        console.log(res.result) // 3
      })
      .catch(console.error)
  },

这样，在增加数据库数据的同时，就会调用云函数，并在开发者工具的console中显示调用结果。

 

 

 

参考：

Js文件函数中调用另一个Js文件函数的方法，https://www.cnblogs.com/cxx8181602/p/9340678.html

JS 时间格式化函数 https://www.cnblogs.com/henw/archive/2011/10/17/2215545.html

js生成随机数 https://www.cnblogs.com/wenxuehai/p/10285585.html