前言
這是我第一次開發小程序，開發的產品是音頻類的，在大佬的建議下采用了mpvue,一周時間把功能都做出來，由于不太熟悉mpvue和微信小程序，足足用了一周時間來改bug才出來一個能用的版本，在這里整理分享下我開發時遇到的一些問題和給出一些建議。
在Linux上開發小程序
在公司電腦裝了雙系統，日常用的是Ubuntu系統，Linux或Mac的開發環境對前端相對來說會友好一些。微信小程序官方的開發者工具只有Windows和Mac版本，所以這就尷尬了。
不過還好，發現已經有大神在GitHub上做了Linux的支持，推薦給大家：Linux微信web開發者工具。
根據教程安裝使用即可，使用時就用./bin/wxdt命令打開。不過用了幾天后面覺得不太方便，就索性切回Windows系統用官方最新的版本了。
封裝wx.request為Promise
wx.request用于發起http請求，但平時習慣了Promise的寫法，所以還是封裝一下這個方法為Promise的形式。
我看很多小程序會使用fly這個庫。
但個人覺得發起請求不需要那么強大的功能，小程序本身就應該是一個輕量級的東西，引入一個庫可能會導致項目打包變大，可能讓小程序更卡，所以本著能自己寫就自己寫吧的心態，索性自己封裝一下算了。
在src/utils,新建一個request.js:
const apiUrl = 'https://your server.com/api/'
const request = (apiName, reqData, isShowLoading = true) => {
// 某些請求可能不需要顯示loading
if (isShowLoading) {
wx.showLoading({
title: '正在努力加載中',
mask: true
})
}
return new Promise(function (resolve, reject) {
wx.request({
url: apiUrl + apiName,
method: 'POST',
data: reqData,
header: {
'content-type': 'application/json' // 默認值
},
success (res) {
if (res.data.code === 0) {
// 與后端約定code=0時才是正常的
resolve(res)
} else {
reject(res)
}
},
fail (err) {
reject(err)
},
complete (res) {
wx.hideLoading()
}
})
})
}
export default request
當然這是個簡化版的，我實際項目中還會在初始化時加入一些token之類的參數，大家能看明白是這樣封裝成Promise的就可以啦。
使用vant-weapp
小程序已經支持了npm安裝，但不太會弄。還是按網上方法，將項目clone下來放進static目錄下。
git clone https://github.com/youzan/vant-weapp.git
然后將vant-weapp的dist目錄拷貝到項目的static目錄下（盡可能精簡，刪掉一些奇奇怪怪的如.github的東西，所以直接使用dist目錄），改名為vant(也可以不改名)。全局使用時，可以在app.json引入：
"usingComponents": {
"van-button": "/static/vant/button/index",
"van-field": "/static/vant/field/index"
},
注意：需要打開微信開發者工具中的ES6轉ES5功能
一開始以為使用起來和web端的沒啥差別，但沒想到那么麻煩。比如：在vue中是可以使用v-model的，但在mpvue中的小程序中不能使用，只能
<van-field :value="password" type="password" @change="pwdChange" input-class="myClass" />
而且不能隨意靈活添加class修改組件的樣式，需要vant組件支持提供外部樣式才可修改，比如上面的van-field是通過input-class來添加樣式控制的，很不方便。而且某些內部樣式由于沒有外部樣式表，根本改不了。
綜上： 在微信小程序使用第三方組件庫不太方便，樣式修改比較麻煩，如果產品是有UI設計時，盡量不使用，有時候自己實現樣式可能更快，而且項目體積更小。
使用vuex
mpvue官方的快速模板中是將vuex放在counter 這個page目錄下，可能習慣了vue官方寫法的很多同學（包括我）不太喜歡，所以最好就改為vuex官方的寫法。
在src目錄下建一個store的文件夾，分別建以下文件：
項目不太復雜時不建議使用modules，使用起來比較麻煩。
貼一下index.js的代碼，其他的actions.js,getters.js按官方的寫法就好啦。
import Vue from 'vue'
import Vuex from 'vuex'
import * as actions from './actions'
import * as getters from './getters'
import state from './state'
import mutations from './mutations'
import createLogger from 'vuex/dist/logger'
Vue.use(Vuex)
const debug = process.env.NODE_ENV !== 'production'
export default new Vuex.Store({
actions,
getters,
state,
mutations,
strict: debug,
plugins: debug ? [createLogger()] : []
})
vuex/dist/logger是vuex在開發環境可以自動打印日志的工具，debug比較方便，建議使用。
然后在src/main.js引入：
import Vue from 'vue'
import App from './App'
import store from '@/store'
Vue.config.productionTip = false
App.mpType = 'app'
Vue.prototype.$store = store
const app = new Vue({
store
})
app.$mount()
這樣就可以在項目中正常使用啦，完全支持mapState,mapActions,mapGetters的寫法，比如在pages/index/index.vue中使用：
<script>
import { mapState, mapActions } from 'vuex'
export default {
computed: {
...mapState(['myAudio'])
},
methods: {
...mapActions(['myActions'])
},
created () {
this.myActions() //調用vuex中的方法
}
}
</script>
踩坑指南
其實大多數坑可能是mpvue的，很多情況也是自己不熟悉小程序生命周期導致的一些奇奇怪怪的bug。
mpvue是支持小程序原生組件的
mpvue會將div編譯為小程序中的view。一開始我不了解，以為用了mpvue后就不能使用小程序原生支持的組件了，比如swiper,scroll-view等，小程序是支持的，可以放心使用哈哈。
npm run build后樣式丟失
本來在開發環境正常的，然后準備發版npm run build后發現樣式丟失了。然后重新npm start排查問題，樣式還是丟失的。內心此時是mmp的：npm run build丟失就算了，我沒改什么東西重新npm start后為什么還是丟失，之前還是正常的呀？
剛開始懷疑是緩存什么的問題，刪掉的dist目錄，重啟開發者工具，甚至重啟電腦都試了一下，這是我遇到的超級詭異的問題之一。
冷靜下來想到：之前的版本是正常的，一定是新版本引入了什么導致了打包樣式的丟失。于是回滾版本一個個build排查問題，最后找到了原因：在一個page中引入了其他page，即在頁面中import另一個頁面。
在我這里的具體例子是：我在pages/index/index.vue 中想做底部共用一個tabbar，頁面根據tabbar的值來顯示對應的子級頁面:pages/page1/index.vue和pages/page2/index.vue。
所以我將這兩個頁面當做子組件來引入了：import Page1 from '@/pages/page1'，一開始沒有問題，等重啟項目，或者build后就發現樣式丟失了。
這可能是mpvue打包機制的一個限制，即頁面不能將另一個頁面當子組件來引用，否則會導致樣式丟失。
背景音頻的src無法讀取
項目中希望用戶退出小程序后依然能播放音頻，所以用到了背景音頻的api： wx.getBackgroundAudioManager()。
this.audio = wx.getBackgroundAudioManager()
this.audio.src = 'http://ws.stream.qqmusic.qq.com/M500001VfvsJ21xFqb.mp3?guid=ffffffff82def4af4b12b3cd9337d5e7&uin=346897220&vkey=6292F51E1E384E061FF02C31F716658E5C81F5594D561F2E88B854E81CAAB7806D5E4F103E55D33C16F3FAC506D1AB172DE8600B37E43FAD&fromtag=46'
this.audio.title = '此時此刻' //注意必填
this.audio.epname = '此時此刻'
this.audio.singer = '許巍'
this.audio.coverImgUrl = 'http://y.gtimg.cn/music/photo_new/T002R300x300M000003rsKF44GyaSk.jpg?max_age=2592000'
title和src賦值后會直接播放音頻，后面的幾個屬性建議也填上，因為播放背景音頻時微信是有個界面需要封面圖和歌手名稱等的。
如果想要獲取當前正在播放的音頻src，本來以為通過this.audio.src來獲取就可以了但是有bug。
在開發者工具中是可以正常獲取的，即開發時是沒問題的，但在真機上返回的是undefined，因此不能用this.audio.src來獲取當前播放的音頻url，得用一個變量來存這個數據。
直接使用音頻的currentTime可能渲染不及時
currentTime用于顯示當前的播放進度，但我用在子組件中時經常更新不及時，打印是正常的，但試圖渲染不及時，有時候需要點擊一下才能重新渲染，這可能是mpvue使用時才會遇到。
所以建議還是項目自身維護一套背景音頻的變量比較好一點，比如放在vuex中。監聽BackgroundAudioManager.onTimeUpdate()方法每次賦值到自身維護的變量中。
音頻的onCanplay方法不一定每個音頻都會觸發
一開始我監聽在onCanplay方法，將音頻的時長信息duration賦值到vuex中存起來，但發現onCanplay有時候是不會觸發的，比如重新賦值src播放下一首時，很尷尬。
所以不要太依賴onCanplay這個方法，還好目前直接使用audio.duration好像不會出現像上面的currentTime渲染不及時的問題，所以就這樣用著先。
音頻播放結束，即onStop后，不能再通過audio.play()的方法重新播放，得重新賦值src
正常來說，音頻播放結束后，音頻的src是不變的，再次play()應該是可以的。但在小程序中偏偏不行，得重新賦值src才能重新播放，這應該是小程序的一個bug。。。
所以需要判斷一下暫停和停止的情況，用不同的辦法播放。正常來說，音頻暫停時currentTime是不為0的，而結束時currentTime會為0。
所以可以通過currentTime（最好是自己維護的變量）來判斷暫停和停止的情況:如果currentTime不為0，表示是暫停的情況，可以用play(),如果小于等于0，則重新賦值src播放：
if (currentTime) {
this.audio.play()
} else {
this.audio.src = 'xx.mp3'
}
mpvue不支持直接在template上直接綁定函數
這個是mpvue文檔上有寫的，不過一開始并不是很理解，也踩坑了，所以在這里提一下，避免不知道的同學踩坑找半天。
<template>
<div v-for="(item, index) in list" :key="index">{{ formatItem(item) }}</div>
</template>
<script>
export default {
data () {
return{
list: [1, 2, 3]
}
},
methods: {
formatItem (item) {
return `我是${item}`
}
}
}
</script>
上面的代碼應該是日常vue中比較常用的，就是將數據傳參給方法做一些處理，這個在mpvue中是不支持的，會被編譯成一個空字符串。
小程序中可放心使用css3的一些特性
比如高斯模糊
filter: blur(50px);
如果要使用動畫，盡量用css動畫代替wx.createAnimation
在實際使用時，wx.createAnimation做動畫其實很卡，性能很差，所以在需要使用動畫時，建議盡量使用css做動畫。
在小程序中是支持css動畫的，transition,animation,@keyframes這些特性都支持。
比如做一個div一直旋轉的動畫，大家可以對比一下兩個版本：
-
wx.createAnimation版本
原理：通過setInterval()不斷更新div的旋轉位置
<template>
<div class="cover" :animation="animationData"></div>
</template>
<script>
export default {
data () {
return {
animationData: '',
animation: '',
rotateCount: 0,
timer: ''
}
},
components: {
},
methods: {
startRotate () {
this.timer = setInterval(() => {
this.rotateAni(++this.rotateCount)
}, 100)
},
rotateAni (n) {
if (!this.animation) {
return
}
// 每100毫秒旋轉10度
this.animation.rotate(10 * n).step()
this.animationData = this.animation.export()
}
},
onShow () {
// 頁面從隱藏到顯示時才執行
if (!this.animation) {
this.animation = wx.createAnimation()
this.startRotate()
}
},
onReady () {
// 第一次初始化時會執行
if (!this.animation) {
this.animation = wx.createAnimation()
this.starRotate()
}
},
onHide () {
// 頁面隱藏時會執行，避免頻繁的setData操作，將定時器停掉
this.timer && clearInterval(this.timer)
},
beforeDestroy () {
// 頁面卸載，也停掉定時器
this.timer && clearInterval(this.timer)
}
}
</script>
<style scoped lang="scss">
.cover {
left: 20px;
bottom: 70px;
border-radius: 50%;
background: #fff;
position: absolute;
width: 50px;
height: 50px;
background: rgba(0, 0, 0, 0.2);
box-shadow: 0px 2px 5px 0px rgba(0, 0, 0, 0.2);
border: 1px solid rgba(255, 255, 255, 0.5);
overflow: hidden;
z-index: 10000;
}
</style>
- 使用css的
@keyframes做旋轉動畫
<template>
<div class="cover" :style="coverStyle"></div>
</template>
<script>
export default {
}
</script>
<style scoped lang="scss">
// 定義一個動畫名為 rotate
@keyframes rotate {
0%,
100% {
transform: rotate(0deg);
}
100% {
transform: rotate(360deg);
}
}
.cover {
left: 20px;
bottom: 70px;
border-radius: 50%;
background: #fff;
position: absolute;
width: 50px;
height: 50px;
background: rgba(0, 0, 0, 0.2);
box-shadow: 0px 2px 5px 0px rgba(0, 0, 0, 0.2);
border: 1px solid rgba(255, 255, 255, 0.5);
overflow: hidden;
z-index: 10000;
// 使用動畫
animation: rotate 4s linear infinite;
}
</style>
用js寫的動畫需要控制好setInterval的間隔時間和旋轉角度，比較難調。而用css寫動畫很簡單，性能比js好，代碼量也很少。
使用css動畫時建議開啟硬件加速
為了動畫更流暢，想盡辦法做優化，雖然不知道有沒效果，反正用了再說[手動滑稽]。
可以用will-change和transform: translate3d(0,0,0)開啟硬件加速。我也不太會用，具體用法大家自行百度Google。
will-change: auto;
transform: translate3d(0, 0, 0);
iPhoneX需要底部導航條預留34px（68rpx）的高度。
由于小程序中不能設置viewport-fit=cover，所以也就沒有web中的安全區域說法，目前主流的做法是通過wx.getSystemInfoSync()判斷是否是ipx，若是則給頁面底部撐高34px。
const res = wx.getSystemInfoSync()
if (res.model.indexOf('iPhone X') >= 0) {
this.isIpx = true
}
注意是用res.model.indexOf('iPhone X'),在開發者工具的iPhone X中，model是全等于iPhone X的，但在真機中往往拿到的值是iPhone X GZxxx，即后面可能會帶一串東西，所以用indexOf才是比較穩的，而且對iPhone XR等機型也適用。
由于還有其他安卓機的全面屏，不太可能一一判斷，而且某些安卓全面屏是沒有用iPhone底部的工具條的（不存在沖突的情況），所以我們只判斷iPhone X的情況就可以了，其他全面屏就不需要給底部預留了。
至于全面屏布局的適配，需要用flex布局或者獲取屏幕寬高來慢慢調了，建議最好用flex布局自適應處理。
for循環中的子組件click事件無法觸發
Page -> 父組件 -> 子組件，在子組件click后$emit一個事件出來，發現無法觸發。
這個bug一開始沒有出現，但偶然npm run build出現的，然后排查原因，后面即使回滾所有版本再npm start也還會出現。好像不觸發則已，一發就不可收拾，這又是一個大坑，搜issue和加群問人，當晚下班回家研究到1點多都沒有解決。
第二天繼續研究，感覺可能是框架的原因，最后嘗試升級一下mpvue版本，沒想到就正常了。直接使用quick-strat項目的mpvue版本是 2.0.0，mpvue和mpvue-template-compiler升級到最新2.0.6就解決了。
事后查看mpvue版本記錄，果然是框架本身原因，并且找到了issue。
npm run build后代碼報錯，再build一次可能報另一些錯
解決： 沒找到原因，可能是引入vant導致的，打包時丟失了部分文件。多build幾次，或者重啟下小程序開發者工具就正常了。
mpvue中created() 鉤子會在頁面初始化時全部一起觸發，盡量不要用
小程序生命周期的理解
- 進入已銷毀的page組件時依次觸發: onLoad,onShow,onReady,beforeMount,mounted
- 第一次進入已銷毀的子組件時依次觸發: onLoad,onReady,beforeMount,mounted
- 第二次進入已銷毀的子組件時依次觸發: onLoad,onShow,onReady
- 再次進入 未被銷毀的page組件、子組件時只觸發: onShow
mpvue文檔中建議盡量不要使用小程序的生命周期，這個應該是為了讓項目更好地適應支付寶小程序和頭條小程序等，所以才這樣建議大家盡量不要使用某一個小程序自身的api。
如果你們的小程序只是微信小程序（不考慮兼容其他平臺小程序），我建議直接用小程序的生命周期，而不要用mpvue的生命周期，坑太多了。比如mpvue的created周期，初始化時所有的page都會執行，所以created這個周期是不能用了。
onUnload不觸發
小程序中與平常web開發不同的是，它的頁面會被緩存。舉個例子：
- 從
page1跳轉到page2，再從page2返回page1,此時的page1還沒銷毀，不會觸發onLoad再重新渲染，而是直接使用之前的數據。從性能上來說，單純的返回不應該再請求api獲取數據重新渲染，這是對的，符合我們的預期。 - 而有時候，從
page2返回page1時，我們希望page1是重新獲取數據渲染的。比如在page2做了一個退出登錄的操作，此時再返回page1時，還是會看到之前的數據。實際上我們的預期是：由于已經退出登錄了，page1的數據應該被銷毀了。
在平常的web開發中，遇到上面的問題，我們可能是不管緩存，每次返回page1都再次請求api渲染最新的數據，犧牲掉部分性能從而保證邏輯的正確性。
在mpvue中我也嘗試這樣干了：想在page1的onUnload()生命周期中銷毀數據，但是沒有成功。即使在page2退出登錄時，采用wx.reLaunch()重新刷一遍，page1的onUnload()生命周期也沒有執行。所以onUnload()是有可能不執行的，建議慎用。
最后還是得想辦法做到在page2控制page1的數據銷毀或保留。想到這里，vuex就不自覺浮現在眼前了，如果page1的數據是通過vuex來控制的，那么我在page2就可以用vuex來靈活管理其他頁面的數據了。
如果page2做退出登錄操作時，就讓page1的數據銷毀，如果是不退出登錄正常返回，page1的數據還是正常，做到靈活控制。
個人平時web開發很少用vuex，因為項目比較簡單不用那么復雜的全局數據傳遞。但在小程序中，建議全局使用vuex來控制所有數據（當然是得根據需求來用）。
總結
第一次開發小程序就直接上了mpvue，可能有些坑已經很多同學總結過了，有些坑可能是不熟悉而導致的，但自己沒有去踩過一遍可能不夠深刻。
有兩種坑會比較難啃：
- 框架本身的問題，如mpvue2.0.0出現的子組件無法觸發事件的問題。
- 開發者工具和真機運行環境不一致導致的坑。
遇到真機和開發者工具不一致的情況，可按以下步驟排查：
- 有可能是緩存，可以殺掉之前的版本再跑起來
- 手機微信版本太低，可能api不支持，用
wx.canIUse打印一下 - 手機端某些屬性不支持讀取，比如上面的
this.audio.src，可以在真機打印調試一下 - 代碼在手機端運行有報錯，可以在手機端開啟調試，看一下log
- 微信設計上的坑，百度下是否有相關的案例和解決辦法
而遇到mpvue框架的問題可以：
- 去搜一下
mpvue的issue看有沒相關解決辦法 - 盡量使用最新版本的框架，可能某些問題已經修復了的。實在解決不了的，建議想辦法繞過，換一種方法來實現。
希望對大家有所幫助。
作者：fengxianqi
鏈接：http://www.lxweimin.com/p/de667b477057
來源：簡書
著作權歸作者所有。商業轉載請聯系作者獲得授權，非商業轉載請注明出處。
