Vue移动端项目搭建: 手把手从零开始搭建

前言

为什么要写这篇文章?

给以后的移动端项目留个模板

首先新起一个项目

vue init webpack projectName

解决适配问题

安装lib-flexible

npm i lib-flexible --save

引入lib-flexible

main.js引入

import 'lib-flexible/flexible.js'

安装px2rem-loader

npm install px2rem-loader --save-dev

配置px2rem-loader

修改build/utils.js, 在cssLoader变量中

exports.cssLoaders = function (options) {
  options = options || {}

  var cssLoader = {
    loader: 'css-loader',
    options: {
      minimize: process.env.NODE_ENV === 'production',
      sourceMap: options.sourceMap
    }
  }
  const px2remLoader = {
    loader: 'px2rem-loader',
    options: {
      remUnit: 32             // 设计稿的1/10   我所用设计稿宽为320px
    }
  }
  ...
}

// 在后面的函数中
// 修改 generateLoaders 函数中 const loaders这句
  function generateLoaders(loader, loaderOptions) {
    const loaders = options.usePostCSS ? [cssLoader, postcssLoader, px2remLoader] : [cssLoader, px2remLoader]
    if (loader) {
      loaders.push({
        loader: loader + '-loader',
        options: Object.assign({}, loaderOptions, {
          sourceMap: options.sourceMap
        })
      })
    }

项目里使用设计稿标注的px，编译或者打包后会自动转化为rem

使用less

npm install less less-loader

在Vue-cli中使用lang="less"时报错：Module build failed: TypeError: this.getOptions is not a function at Object.loader
出现这个问题的原因是less-loader版本过高，降级到5.0.0即可

npm install [email protected] --save-dev

main.js添加

import less from 'less'

Vue.use(less)

顶部进度条

npm i nprogress -S

main.js

import NProgress from 'nprogress' //引入自定义css是为了覆盖掉默认的进度条的颜色
import './assets/css/nprogress.css'
NProgress.configure({
    easing: 'ease',  // 动画方式    
    speed: 500,  // 递增进度条的速度    
    showSpinner: false, // 是否显示加载ico    
    trickleSpeed: 200, // 自动递增间隔    
    minimum: 0.3 // 初始化时的最小百分比
})
router.beforeEach((to, from , next) => {
    // 每次切换页面时，调用进度条
    NProgress.start();
    next()
});
router.afterEach(() => {  
    // 在即将进入新的页面组件前，关闭掉进度条
    NProgress.done()
})

nprogress.css

    #nprogress {
        pointer-events: none;
    }

  #nprogress .bar {
    /* 自定义颜色 */
    background: #FE571B;

    position: fixed;
    z-index: 1031;
    top: 0;
    left: 0;

    width: 100%;
    height: 2px;
  }

  /* Fancy blur effect */
  #nprogress .peg {
    display: block;
    position: absolute;
    right: 0px;
    width: 100px;
    height: 100%;
    box-shadow: 0 0 10px #FE571B, 0 0 5px #FE571B;
    opacity: 1.0;

    -webkit-transform: rotate(3deg) translate(0px, -4px);
        -ms-transform: rotate(3deg) translate(0px, -4px);
            transform: rotate(3deg) translate(0px, -4px);
  }

  /* Remove these to get rid of the spinner */
  #nprogress .spinner {
    display: block;
    position: fixed;
    z-index: 1031;
    top: 15px;
    right: 15px;
  }

  #nprogress .spinner-icon {
    width: 18px;
    height: 18px;
    box-sizing: border-box;

    border: solid 2px transparent;
    border-top-color: #FE571B;
    border-left-color: #FE571B;
    border-radius: 50%;

    -webkit-animation: nprogress-spinner 400ms linear infinite;
            animation: nprogress-spinner 400ms linear infinite;
  }

  .nprogress-custom-parent {
    overflow: hidden;
    position: relative;
  }

  .nprogress-custom-parent #nprogress .spinner,
  .nprogress-custom-parent #nprogress .bar {
    position: absolute;
  }

  @-webkit-keyframes nprogress-spinner {
    0%   { -webkit-transform: rotate(0deg); }
    100% { -webkit-transform: rotate(360deg); }
  }
  @keyframes nprogress-spinner {
    0%   { transform: rotate(0deg); }
    100% { transform: rotate(360deg); }
  }

路由懒加载(增加首屏加载速度)

router/index.js

routes: [
    {
        path: '/',
        name: 'index',
        component: () => import('@/views/index')
        // 或者
        //  component:resolve=>require(['@/views/index'],resolve)
    },
   //  ...
]

配置404页面

修改router/index.js

    {
      path: "/404",
      name: "notFound",
       meta: {
            title: '404',
            auth:false,// 不需要登录
        },
      component: () => import('../views/404.vue')
    }, 
    {
      path: "*", // 此处需特别注意置于最底部
      redirect: "/404"
    }

封装axios请求

npm install --save axios

src文件夹下新建http文件夹，并在文件夹内新建request.js
request.js

import axios from 'axios'
import router from 'vue-router'
import {auth} from "./auth";

/**
* 定义请求常量
* TIME_OUT、ERR_OK
*/
export const TIME_OUT = 5000;    // 请求超时时间
export const ERR_OK = true;      // 请求成功返回状态，字段和后台统一
// export const baseUrl = process.env.BASE_URL   // 引入全局url，定义在全局变量process.env中，开发环境为了方便转发，值为空字符串

// 环境的切换
console.log('process.env.NODE_ENV:'+process.env.NODE_ENV);

// create an axios instance
export const service = axios.create({
    baseURL: config.BASE_API || process.env.VUE_APP_BASE_API,  
    //  process.env.VUE_APP_BASE_API :这种方式在config/dev.env.js或者prod.dev.env.js中配置VUE_APP_BASE_API 
    timeout: TIME_OUT, // 请求超时时间
    headers: {
        "X-Requested-With": "XMLHttpRequest",
        "content-Type": "application/json; charset=UTF-8",
        "Cache-Control": "no-cache",
        Pragma: "no-cache",
    },
});
service.defaults.baseURL = config.BASE_API;

// 封装请求拦截
service.interceptors.request.use(
    config => {
        config.headers['Content-Type'] = 'application/json;charset=UTF-8';
        config.headers['accessToken'] = '';
        
        const token = auth.getToken();
        if (token) {
            config.headers["Authorization"] = token;
        }

        return config
    },
    error => {
        return Promise.reject(error)
    }
)
// 封装响应拦截，判断token是否过期
service.interceptors.response.use(
    response => {
        const res = response.data;
       
        if (res.status === 200) {
            return Promise.resolve(res);
        }
        if (res.status === 401) { // 如果后台返回的错误标识为token过期，则重新登录
             // token过期移除token
             localStorage.removeItem('token')
             // 进行重新登录操作
             auth.removeToken();

            //  提示确认框重新登录
            return Promise.reject(res.message || "Error");

        }else{
            return Promise.reject(new Error(res.message || "Error"));

        }
        
    },
    error => {
        // return Promise.reject(error.response)
        if (error.response.status) { 
            switch (error.response.status) {                
                // 401: 未登录
                // 未登录则跳转登录页面，并携带当前页面的路径
                // 在登录成功后返回当前页面，这一步需要在登录页操作。                
                case 401:                    
                    router.replace({                        
                        path: '/login',                        
                        query: { 
                            redirect: router.currentRoute.fullPath // 401后跳转登录页  把当前路由带上 登录后可直接回到该路由
                        }
                    });
                    break;
                // 403 token过期
                // 登录过期对用户进行提示
                // 清除本地token和清空vuex中token对象
                // 跳转登录页面                
                case 403:
                    // var toast = Toast.$create({
                    //     txt: '登录过期，请重新登录',
                    //     mask: true
                    // })
                    // toast.show()
                    // 清除token
                    localStorage.removeItem('token');
                    store.commit('loginSuccess', null);
                    // 跳转登录页面，并将要浏览的页面fullPath传过去，登录成功后跳转需要访问的页面 
                    setTimeout(() => {                        
                        router.replace({                            
                            path: '/login',                            
                            query: { 
                                redirect: router.currentRoute.fullPath 
                            }                        
                        });                    
                    }, 1000);                    
                    break; 

                // 404请求不存在
                case 404:
                    // var toast = Toast.$create({
                    //     txt: '网络请求不存在',
                    //     mask: true
                    // })
                    // toast.show()
                    break;

                // 其他错误，直接抛出错误提示
                default:
                    // var toast = Toast.$create({
                    //     txt: error.response.data.message,
                    //     mask: true
                    // })
                    // toast.show()
            }
        }
        return Promise.reject(error.response)
  }
)

export default service;

main.js

import axios from './http/request'
Vue.prototype.$axios = axios

使用方法:
然后就可以在项目中以 this.$axios 来进行请求

// get请求参数需要 params：{}
this.$axios.get(`/search/list`, {
          params:{ 
              id:11
           }
        }).then((res) => {
})

// post请求
this.$axios.post(`scan/qr/code`, {
          loginCode: this.loginCode
        }).then((res) => {
})

// 假如上传需要用到 BASE_API2
this.$axios.post(`/upload/file`, {
          loginCode: this.loginCode
        }, {baseURL: config.BASE_API2,}).then((res) => {
})

axios区分不同的接口环境

process.env.VUE_APP_BASE_API :
这种方式在config/dev.env.js或者prod.dev.env.js中配置VUE_APP_BASE_API

但是当线上环境的测试环境不止一个时，用这个不方便实现。 

static文件夹下新增config.js

/**
 * devlopment
 * local本地 | dev白盒 ｜ uat1 ｜ uat2 ｜ prod生产
 */
 const devlopment = 'local'

 let config = {}
 
 if(devlopment === 'local'){
   config = { 
        BASE_API: 'http://localhost:8080',  // 后端api地址
        BASE_API2: 'http://localhost:8090',  
   }
 }
 
 if(devlopment === 'dev'){
    config = { 
        BASE_API: 'http://localhost:8080',  // 后端api地址
        BASE_API2: 'http://localhost:8090',  
    }
 }

使用

index.html添加




在请求的时候能使用到 BASE_API或者BASE_API2

路由鉴权

(1) router/index.js

给每个路由新增一个auth字段来判断是否需要登录

routes: [
    {
      path: '/',
      name: 'index',
      meta: {
        title: '首页',
        auth:true,// 是否需要登录
      },
      component: () => import('@/views/index')
    },
    {
      path: '/login',
      name: 'login',
      meta: {
        title: '登录页',
        auth:false,// 是否需要登录
      },
      component: () => import('@/views/login')
    },
]

(2) main.js

router.beforeEach((to, from , next) => {
  /* 路由发生变化修改页面title */
  if (to.meta.title) {
      document.title = to.meta.title
  }
  // 每次切换页面时，调用进度条
  NProgress.start();
  // 对路由进行验证    
  if(to.matched.some( m => m.meta.auth)){  // 某路由需要登录权限
    const ifLogin = localStorage.getItem('isLogin') 
    if(!ifLogin) { // 未登陆
        next({path:'/login'})
        NProgress.done()
    }else{
        next()
    }
  }else{
      next()
  }
});
router.afterEach(() => {  
    // 在即将进入新的页面组件前，关闭掉进度条
    NProgress.done()
})

引用vconsole

移动端项目调式怎么可以少了这个神器.

static文件夹下新建vconsole.js，
再去git上拷贝源码下来,在index.html里引入,vconsole地址：点这里

index.html

 或者

解决移动端点击300ms延迟

npm i fastclick -S

main.js

import FastClick from 'fastclick'
FastClick.attach(document.body)

解决css移动端字母或者文字大小有时会变化的问题

App.vue

html{
    -ms-text-size-adjust: 100%;
    -webkit-text-size-adjust: 100%;
}

谷歌下不支持小于12px，当字体小于12px时 会变成12px 这个时候我们设置的rem及=就没有效果了 设置text-size-adjust会解决这个问题 禁用Webkit内核浏览器的文字大小调整功能

设置全局公共组件

src / components 下新建index.js

import BaseTitle from "./BaseTitle";
import BaseModule from "./BaseModule";

const array = [
    BaseTitle,
    BaseModule
];

const baseComponents = {
    install(vue) {
        for (let i = 0; i < array.length; i++) {
            vue.component(array[i].name, array[i]);
        }
    },
};

export default baseComponents;

main.js

import baseComponents from './components'

Vue.use(baseComponents)

使用: 直接使用不需要import

强烈建议在components文件夹下只放置公共组件，通用组件，不要放置页面组件，业务组件

解决页面每次打开不能返回顶部位置

main.js中路由的前置守卫里添加这句：

router.beforeEach((to, from , next) => {
  document.body.scrollTop = 0;
  // .......
})

打包后生成很大的.map文件的问题

在config/index.js文件中，设置productionSourceMap: false,就可以不生成.map文件

查看打包后各文件的体积

npm run build --report

本模板框架gitee地址： https://gitee.com/apple0515/vue_h5_project

持续更新~~