mpvue微信小程序系列

项目空闲时间,来做一波温故知新。

当前时期的需求是做一个拼团的小程序。

在这之前在做一个微信公众号H5项目,技术栈是Vue全家桶(vue+router+vuex+vant...)。在新的小程序项目中有很多组件类似于之前项目的组件,所以决定使用mpvue作为基础来搭建项目。

mpvue框架基于 Vue.js 核心,mpvue 修改了 Vue.js 的 runtime 和 compiler 实现,使其可以运行在小程序环境中,从而为小程序开发引入了整套 Vue.js 开发体验。

简而言之,就是可以用类似vue的语法来开发小程序,通过mpvue配置好的各种loader来将vue文件转换为小程序需要的wxml,wxss

站在巨人的肩膀上,别人的分享为我提供了很多的方便。下面介绍项目的第一步,搭建环境。

从第一步搭建环境开始记录。建议使用cnpm,开发过程中会需要填写appid等信息,不过要是练手的话也可以不用填

# 全局安装 vue-cli
$ npm install --global vue-cli

# 创建一个基于 mpvue-quickstart 模板的新项目
$ vue init mpvue/mpvue-quickstart my-project

# 安装依赖
$ cd my-project
$ npm install
# 启动构建
$ npm run dev

上面流程走完,项目中会多出一个dist文件夹,这就是生成的微信小程序项目。OK,然后打开微信开发者工具,选择小程序----体验模式(没有appid时),将项目目录指向刚刚生成的dist文件夹。好了,页面出来了。

这就完了?

当然
没有

需要知道的地方:
1.最重要的当然是看文档,mpvue的文档相当的简单,是我辈开发者的最爱。
2.自己的代码在/src里面,每个页面一个文件夹,包含这三个文件

image.png
  • index.vue 这是页面主页文件,完全和vue的语法相同,可以放心食用
  • main.js 这个是将vue实例化的一个文件,建议不要修改,即每个页面文件夹都是这样


    image.png
  • main.json 看过小程序文档的都知道,这个文件可以用来配置小程序顶部tab的标题和颜色之类的东西


    image.png

3.在/build/utils.js文件夹里,有一堆配置,初学者可以不用管它三七二十一的。不过需要修改一下px2rpxLoader的属性,这里的意思是将css代码中的px转换成小程序的rpx(小程序标配的尺寸,自适应效果很好)原本基础配置是2比1,意思是将2px转换成1rpx。我们将它改成1比1,这样就可以直接按照标注图上的px单位来敲代码了。

var px2rpxLoader = {
    loader: 'px2rpx-loader',
    options: {
      baseDpr: 1,
      rpxUnit: 1
    }
  }

4.配置环境变量
为了统一并且方便,我们通常都会配置一个环境变量来保持devproduct的代码统一。
/config/dev.env.jsdev版本

module.exports = merge(prodEnv, {
  NODE_ENV: '"development"',
  //服务器域名,这里展示测试服的服务器地址
  API_ROOT:'"http://beta.baidu.com"'  
})

/config/prod.env.jsproduct版本

module.exports = {
  NODE_ENV: '"production"',
  // 服务器域名
  API_ROOT:'"http://baidu.com"'
}

取值:这样就能在代码一致的情况下,配置不同的地址(其他更多不同的地方)。

const url =  process.env.API_ROOT;

我所使用到的环境搭建以及基本配置就已经完成了。

mpvue项目中需要注意的点

  • 获取服务端数据需要在mounted中请求
  • 尽量不使用小程序的生命周期,主要使用vue的生命周期

一些常用的API

在这个项目中没有使用到vuex,我们使用小程序原生的方法储存数据
微信小程序详细API看这里,我只总结一些常用的方法

// 同步储存数据
wx.setStorageSync('phone', 18244242739);
// 普通跳转页面
wx.navigateTo({
  url: 'test?id=1'
})
// 重定向,在路由栈中删除当前页面
!!!微信页面栈最多5层,遵循栈的先进后出,只是这里超出5层就删除第一层
wx.redirectTo({
  url: 'test?id=1'
})
// 取缓存中的值
const value = wx.getStorageSync('key值')
// 微信小程序登陆
wx.login({
    success(res){
        // 登陆成功的回调
    }
})
// 获取当前页面的地址(url后的参数)
function getCurrentPageUrl(){
  var pages = getCurrentPages()    //获取加载的页面
  var currentPage = pages[pages.length-1]    //获取当前页面的对象
  // url后的参数:url.options.参数名
  var url = currentPage.route    //当前页面url
  return url
}
选择图片并上传
// 上传
wx.chooseImage({
    count: 4, // 可以同时选择多少张
    sourceType: ["album", "camera"], // 图片来源:相册选图  相机拍照
    sizeType: ["original", "compressed"], // 图片质量:原图  压缩图
    success(res) {
        // res为选取的图片数据
        // 上传多张
        for (let i = 0; i < res.tempFilePaths.length; i++) {
            uploadImg(res, i);
        }
    }
});

// 上传到自己的服务器上
function uploadImg(res, index) {
    // 验证文件大小
    if (res.tempFiles[index].size > 3 * 1024 * 1024) {
        this.$tip("图片大小不能超过3M");
        return;
    }
    wx.uploadFile({
        url: "自己服务器的接口地址",
        // 获取文件
        filePath: res.tempFilePaths[index],
        // 字段名
        name: "image",
        //wx此方法的content-type默认为multipart/form-data
        header: {
            "user-token": "xxxxxxxxxx",
        },
        success(resData) {
            // 成功的回调
            // ......
        }
    });
}

真机调试和预览

image.png

代码完工之后的发布流程

image.png

1.在微信小程序管理中心配置你的微信号为主要开发者后,这里会出现一个上传按钮,点击上传就好
2.管理中心点击确定发布
3.等待审核(第一次2-3天,然后等待时间可能比较长了...)
4.审核通过,完成上线。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 205,386评论 6 479
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 87,939评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 151,851评论 0 341
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,953评论 1 278
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,971评论 5 369
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,784评论 1 283
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,126评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,765评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,148评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,744评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,858评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,479评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,080评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,053评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,278评论 1 260
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,245评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,590评论 2 343

推荐阅读更多精彩内容