怎樣搭建vue移動端項目到上線

這篇文章將為大家詳細講解有關怎樣搭建vue移動端項目到上線，小編覺得挺實用的，因此分享給大家做個參考，希望大家閱讀完這篇文章后可以有所收獲。

初始化項目

1、在安裝了node.js的前提下，使用以下命令

npm install --g vue-cli

2、在將要構建項目的目錄下

vue init webpack myproject(項目目錄名稱)

一路回車如下

中間會讓選擇ESLint進行項目代碼風格檢查，為了美觀和效率，可以開起來，vue-router用起來，紅框框中的兩個測試，不要也罷，后面是問要使用哪個進行install依賴包，默認npm好了；然后回車，等待下載依賴；慢的話可以用鏡像。

下載完成之后會看到如下提示：

按照步驟往下走就好了

接下來在瀏覽器里輸入localhost:8080，就可以進入到vue的世界了

只有這些還不夠，這距離一個響應式的app框架還差好多，接下來就正式搭建一個移動端的項目吧。

首先我們來看一下剛構建好的vue的項目結構

可以發現項目中有assets和static兩個文件夾可存放靜態文件，那豈不是沖突了？其實不然，assets中存放的靜態文件是會經過webpack處理的，一般放一些圖片之類的靜態資源，而static則不會收到webpack的影響，調用的時候也是通過絕對路徑調用的，通常用來存放一些第三方的靜態資源庫。

此項目將基于vue-cli的項目目錄進行改造，使其集成vue-router、vuex、axios，而且可以自動適配移動端大小。

在開始寫代碼之前，先說一下ESlint警告和報錯，可以選擇性修改校驗規則，點擊參考修改，也可以使用 /* eslint-disable */ 選擇性忽略校驗

路由（vue-router）

一個項目的路由是一個項目的基礎，我們先從路由開始，在剛一開始初始化項目的時候，vue-router就被引進項目里來了，上面的圖片里在src\router里面放的就是路由配置文件，按照個人習慣我將對上面的目錄結構進行調整，如下

新建page目錄存放主邏輯頁面，components存放公共組件，router統一管理路由

如圖引入新的頁面，路由跳轉可通過this.$router.push('/Home')

路由vue-cli都給封裝的差不多了，倒也沒什么要大改的地方，接下來來看下vuex

vuex（狀態管理模塊）

關于vuex的介紹官網也給了比較詳細的介紹，對其作用不太了解的話可以參考什么是vuex，這里只說怎么集成在項目里面，并且簡單介紹其用法

（1）安裝vuex

npm install vuex --save

（2）配置vuex

根據個人開發習慣，項目中vuex的配置也不相同，不過大體都差不多，也有差別大的地方，比方說官網推薦在actions里寫異步操作改變state狀態，但是我還是比較喜歡將請求數據等異步操作放在store外面操作，在通過commit去改變狀態，具體將會在下面的數據請求模塊的封裝里提到

廢話不多說了，看下面圖片

首先創建了一個狀態的文件夾，用于管理整個狀態；在modules里面分開來寫各個模塊的狀態，如下

/**
 * home.js
 * 用于home模塊的狀態管理
 */
import * as types from '../mutation-type' // 引入定義的方法
const home = {
 state: {
 number: 1
 },
 mutations: {
 [types.SET_NUM](state, num) { // 修改state 可通過mapMutations調用
 state.number = num
 }
 },
 actions: {},
 getters: {  // 定義getters，可以通過mapGetters拓展函數調用
 number: state => {
 return state.number
 }
 }
}
export default home // 輸出home模塊

mutation-type定義了一些修改state的方法，如下

在index.js統一輸出，如下

import Vue from 'vue'
import Vuex from 'vuex'
import home from './modules/home'
import createLogger from 'vuex/dist/logger'

Vue.use(Vuex)
const debug = true

export default new Vuex.Store({
 modules: {
 home
 },
 plugins: debug ? [createLogger()] : [] // 是否開啟vuex的debug模式
})

這里用到了一個vuex的內置插件，如上圖，開啟之后狀態的每次改變都可以在console里面查看修改信息如下圖

這里的index配置好之后就是要在main.js里注冊一下

通過以上幾步設置，就可以在項目里面使用狀態了，這里以home.vue為例，看下面代碼

import {mapMutations, mapGetters, mapState} from 'vuex' // 引入map方法
export default {
 data () {
 return {
 num: 0
 }
 },
 methods: {
 ...mapMutations({  // 調用setNum方法
 setNum: 'SET_NUM'
 }),
 increase() {
 this.num++
 this.setNum(this.num) // 將this.num轉入setNum
 }
 },
 computed: {
 // ...mapGetters([  // 通過getters獲取state數據
 // 'number'
 // ]),
 ...mapState({  // 通過state獲取state數據
 number: state => state.home.number
 })
 }

到這里vuex的引入就結束了，下面來繼續看數據請求模塊（axios）

axios（數據請求模塊）

之前vue數據請求模塊用的是vue-resource，官方不推薦，棄之；說下axios的集成步驟，以及需要注意的一些地方

（1）安裝axios和js-cookie

npm install axios --save

（2）配置axios

在src目錄下面新建apiconfig文件夾，用來封裝請求和定義一些關于請求的全局變量；同時創建api文件夾，用來分別聲明各個模塊的請求方法，如下圖

先來看apiconfig里的公共封裝部分；這里會對請求做以下處理

• 定義一些像請求返回成功的狀態、請求超時時間等常量，

• 對請求做一次公共的封裝，

• 對token的存儲和攔截當操作，

下面看代碼

/* eslint-disable */
import axios from 'axios'

/**
* 定義請求常量
* TIME_OUT、ERR_OK
*/
export const TIME_OUT = 1000; // 請求超時時間
export const ERR_OK = true; // 請求成功返回狀態，字段和后臺統一
export const baseUrl = process.env.BASE_URL // 引入全局url，定義在全局變量process.env中，開發環境為了方便轉發，值為空字符串

// 請求超時時間
axios.defaults.timeout = TIME_OUT

// 封裝請求攔截
axios.interceptors.request.use(
 config => {
 let token = localStorage.getItem('token') // 獲取token
 config.headers['Content-Type'] = 'application/json;charset=UTF-8'
 config.headers['Authorization'] = ''
 if(token != null){    // 如果token不為null，否則傳token給后臺
  config.headers['Authorization'] = token
 }
 return config
 },
 error => {
 return Promise.reject(error)
 }
)
// 封裝響應攔截，判斷token是否過期
axios.interceptors.response.use(
 response => {
 let {data} = response
 if (data.message === 'token failure!') { // 如果后臺返回的錯誤標識為token過期，則重新登錄
 localStorage.removeItem('token')  // token過期，移除token
 // 進行重新登錄操作
 } else {
 return Promise.resolve(response)
 }
 },
 error => {
 return Promise.reject(error)
 }
)
// 封裝post請求
export function fetch(requestUrl, params = '') {
 return axios({
 url: requestUrl,
 method: 'post',
 data: {
 'body': params
 }
 })
}

以上代碼以post請求為例，對請求進行公共封裝，并且定義了一些常量以供請求使用，另外分別對請求和響應進行了攔截，方便在請求或者數據返回時，對數據進行統一處理，具體在代碼的注釋里都可以看到，下面就以登錄為例，對封裝的請求方法進行調用。

下面來看api模塊部分，以home-api為例，看代碼

/**
 * 引入fetch、baseUrl
 * @param params
 * @returns {*}
 */
import {fetch, baseUrl} from 'config/index'
// 登錄接口
export function loginUserNo(params) {
 return fetch(`${baseUrl}/root/login/checkMemberLogin`, params)
}

在文件里引入fetch方法和baseUrl，這里為什么可以簡寫成'config/index'呢，需要在'build/webpack.base.conf.js'里添加以下代碼，后面引入api同理

這里export登錄方法loginUserNo之后，就可以在組件里面使用這個登錄方法了，如下代碼

import * as homeApi from 'api/home-api' // 引入api
import { ERR_OK } from 'config/index' // 引入請求成功狀態
// 請求方法
login() {
 let params = {
 password: '*******',
 storeNo: '',
 userName: '*********'
 }
 homeApi.loginUserNo(params).then((res) => {
 let {data} = res
 if (data.success === ERR_OK) {
  // 請求成功操作，存儲token
  localStorage.setItem('token', data.value.token)
 } else {
 }
 }).catch(() => {
 })
 }
}

在點擊登錄之后執行登錄方法，就可以調用請求方法了，但是這里還有一個問題

關于數據請求，避不開的一個老生常談的問題就是跨域，同樣的上面點擊登錄也會涉及到跨域無法請求的問題，不過好在vue-cli里面已經配置了解決跨域問題的模塊，我們可以在config/index.js里面配置以下要代理的地址，如下圖

將以root開頭的api轉發出去，將地址指向接口地址，這樣就解決了跨域的問題。

到此，vue全家桶的引入及應用就基本完成了，但是到目前為止這個項目還只能進行簡單的路由跳轉、狀態存儲以及數據請求，而我們的目標是一個移動端應用框架，接下來我們還要解決如下幾個問題

• 移動端適配問題

• 移動端ui框架的引入

• 項目組織架構的優化問題

下面我們就先從移動端適配問題入手

項目的適配

因為移動端設備屏幕大小，屏幕比例什么的差別比較大，所以移動端項目的適配問題就顯得尤為重要，這里我們主要使用flexible.js進行適配，關于flexible.js，不懂得話可以點這里，這里我們以最常用的750*1334的尺寸為例

引入flexible.js，在main.js里引入flexible.js文件，可將flexible.js作為靜態文件放在最外層static文件夾里引入，如下圖

使用less作為css預處理器，首先安裝less

（1）安裝less和less-loader

npm install lessless-loader --save-dev

（2）配置less

在build/webpack.base.conf.js 的module.exports.module.rules 里面添加

{
 test: /\.less$/,
 loader: 'style-loader!css-loader!less-loader'
 },

然后在組件里面使用的時候，在style標簽上加上 lang="less"，就可以正常的使用less了，這里我們來引入幾個初始化項目的less文件，在src下面創建styles文件夾，放入以下文件

在每個組件里的style標簽里引入index.less和variable.less

<style scoped lang="less">
@import "~styles/index.less";
@import "~styles/variable.less";
.hello{
 h2{
 color: red;
 .fs(38); // mixin里數字大小函數
 }
}
</style>

然后上面寫關于像素的樣式的時候，都在mixin.less定義下，就可以實現對所有移動端的適配問題。

移動端頁面切換及切換動畫

此處將切換動畫單獨拿出來說以下，作為移動端一般要實現的需求是，第一級菜單切換不需要轉場動畫，第一級菜單向第二級菜單轉場時需要過渡動畫；針對這一需求提供以下解決方案。

需要用到動畫的話肯定會用到vue的transition，不熟悉的話可以看這里，這里實現動畫的解決方案是判斷要執行路由的方向，如下代碼，在路由配置文件里定義路由的方法

// 需要左方向動畫的路由用this.$router.to('****')
Router.prototype.togo = function (path) {
 this.isleft = true
 this.isright = false
 this.push(path)
}
// 需要右方向動畫的路由用this.$router.goRight('****')
Router.prototype.goRight = function (path) {
 this.isright = true
 this.isleft = false
 this.push(path)
}
// 需要返回按鈕動畫的路由用this.$router.goBack()，返回上一個路由
Router.prototype.goBack = function () {
 this.isright = true
 this.isleft = false
 this.go(-1)
}
// 點擊瀏覽器返回按鈕執行，此時不需要路由回退
Router.prototype.togoback = function () {
 this.isright = true
 this.isleft = false
}

上面在執行路由跳轉的時候，在App.vue里面判斷滑動的方向，來指定動畫的方向，不需要動畫的話，可以直接使用this.$router.push('****')，下面是App.vue里處理的動畫代碼

<template>
 <div id="app">
 <transition :name="transitionName">
 <router-view class="Router"></router-view>
 </transition>
 </div>
</template>

<script>
export default {
 name: 'App',
 data() {
 return {
 transitionName: 'slideleft'
 }
 },
 watch: {
 $route() { // 監聽路由變化重新賦值
 if (this.$router.isleft) {
 this.transitionName = 'slideleft'
 }
 if (this.$router.isright) {
 this.transitionName = 'slideright'
 }
 }
 }
}
</script>

<style>
#app {
 font-family: 'Avenir', Helvetica, Arial, sans-serif;
 -webkit-font-smoothing: antialiased;
 -moz-osx-font-smoothing: grayscale;
 text-align: center;
 color: #2c3e50;
}
.Router {
 position: absolute;
 top: 0;
 left: 0;
 right: 0;
 width: 100%;
 height: 100%;
 transition: all .5s ease;
 -webkit-transition: all .5s ease;
 -moz-transition: all .5s ease;
}
.slideleft-enter,
 .slideright-leave-active {
 opacity: 0;
 -webkit-transform: translate(100%, 0);
 transform: translate(100%, 0);
}
.slideleft-leave-active,
.slideright-enter {
 opacity: 0;
 -webkit-transform: translate(-100%, 0);
 transform: translate(-100%, 0);
}
</style>

在組件中使用的話則使用

this.$router.goBack() // 返回
this.$router.to('****') // 進入到詳情

還有一步，就是監聽點擊瀏覽器返回按鈕，在main.js里寫如下代碼

 window.addEventListener('popstate', function(e) {
 router.togoback() // router已經在上面import進來
}, false)

移動端UI框架選擇

作為移動端項目，上面步驟其實已經算完善了，但是往往會遇到項目工期緊，或者缺少人手的時候，這個時候引入一個移動端的UI就如虎添翼了，不用自己去封裝一些ui組件了，這里使用mint-ui，優點可自行搜索，這里講一下對mint-ui的引入。

（1）安裝mint-ui

npm install mint-ui --save

（2）引入mint-ui

在main.js里引入mint-ui

import Mint from 'mint-ui'
import 'mint-ui/lib/style.css' // 引入css
Vue.use(Mint) // 全局使用

這樣就可以在整個vue項目里面使用mint-ui的組件了。

打包

打包遇到的一些問題

（1）打包之后在ios上點擊元素會閃出來一個半透明的灰色框，這里需要加一句css做下兼容-webkit-tap-highlight-color:rgba(0,0,0,0); 放入#app的css里

（2）點擊事件右300ms的延遲，可采用fastclick.js解決，參考以下代碼

npm install fastclick --save

// 在main.js引入
import FastClick from 'fastclick'
FastClick.attach(document.body)

打包注意事項

如果將項目打包用于移動端瀏覽器，則直接打包，不需要更改其它的東西，在包之后上傳至服務器，使用nginx做下接口轉發即可

如果想將打包的靜態文件進一步打包成移動端應用，則需要修改以下config/index.js

在config/prod.env.js新增baseUrl

打包成app之后，移動端不會存在跨域問題。

關于“怎樣搭建vue移動端項目到上線”這篇文章就分享到這里了，希望以上內容可以對大家有一定的幫助，使各位可以學到更多知識，如果覺得文章不錯，請把它分享出去讓更多的人看到。