用webpack4開發小程序

webpack4開發小程序

哈，本人是REACT系開發者，工做中須要不停的折騰webpack，爲了順帶學習VUE的開發思想和思路，瓜熟蒂落的請纓爲公司小程序打個框架基礎。前期也去了解了下各個小程序開發框架，大致上是經過轉義的思路來解決小程序和VUE/REACT的模板、邏輯關係，不作展開討論了。只是從本人角度分享經過webpack來構建小程序的開發架構。

經過觀察小程序的原有架構，不難發現其已是一套比較完善的mvvm架構了(類VUE)，融合了VUE及REACT的一些特色(以VUE爲主)，但卻有一些不足，缺失了前端開發人員經常使用的npm包的引入，動態樣式的編譯等等提高開發效率的工做環境、模式。所以我想若是經過webpack4來爲原有架構作一個有益的補充，這樣原生架構不就很完美了嗎？

思路

對等編譯輸出小程序項目的全部文件(嚴格按照小程序須要的文件及目錄結構輸出)。js/wxs經過babel編譯輸出，wxml/json直接輸出，wxss經過stylus編譯輸出(咱們使用stylus開發樣式)，順帶使用webpack抽離公共模塊文件common.js，並將runtime運行時抽離做爲一個獨立文件。這樣既精簡了代碼，又享用到了webpack爲咱們帶來的好處。嗯，看上去很簡單嘛，實際上倒是踩了很多的坑！腳上的繭老厚了~~~

webpack module配置

module: {
  rules: [
    {
      test: /\.(wxml|axml)/, // 爲支付寶小程序留了個伏筆，哈哈
      use: [
        relativeFileLoader(isWechat ? 'wxml' : 'axml'),  // 這裏使用file-loader簡單封裝了一下
        'extract-loader',
        'html-loader'
      ]
    },
    {
      test: /\.(jp(e?)g|png|gif)$/,
      use: relativeFileLoader()
    },
    {
      test: /\.wxss$/,
      include: SRC,
      use: relativeFileLoader(),
    },
    {
      test: /\.wxs$/,
      include: SRC,
      exclude: /node_modules/,
      use: [
        relativeFileLoader(),
        {
          loader: 'babel-loader',
          options: {
            babelrc: false,
            presets: [
              'es2015', 
              'stage-0'
            ]
          },
        }
      ]
    },
    {
      test: /\.js$/,
      use: {
        loader: 'happypack/loader',
        options: {
          id: 'babel'
        }
      },
      exclude: /node_modules/,
    },
    {
      test: /\.styl$/,
      include: SRC,
      use: [
        relativeFileLoader(isWechat ? 'wxss' : 'acss'),
        'stylus-loader'
      ]
    }
  ]
},
複製代碼

熟悉webpack的同窗經過上面的moudle配置應該可以看出資源文件編譯的思路，固然直接這樣配置確定作不到正確編譯，還有一些坑須要踩

全文件entry

爲了對等輸出，咱們須要把全部文件整理爲entry給webpack處理，這樣的好處是js可以使用npm包，全部文件都可以支持熱更新機制(webpack的熱更新響應很是快，gulp的熱更新很難精細控制，當項目足夠大的時候，響應很慢)

function entries(dir) {
  var jsFiles = {}
  let _partten = /[\/|\\][_](\w)+/;
  let re_common = /(.*)\/common\//
  const accessExts = ['.wxml', '.wxss', '.styl', '.wxs', '.json', '.png', '.jpg', '.jpeg', '.gif']
  if (fse.existsSync(dir)) {
    globby.sync([`${dir}/**/*`, `!${dir}/js/**/cloudfunctions`, '!node_modules', `!${dir}/dist`]).forEach(function (item) {
      if (!re_common.test(item)) {
        if (!_partten.test(item)) {
          const fileObj = path.parse(item)
          const xcxSrc = path.join(dir, 'js')
          if (~item.indexOf(xcxSrc)) {
            const fileStat = fs.statSync(item)
            const relativeFile = item.replace(xcxSrc, '')
            let relativeKey = relativeFile.replace(fileObj.ext, '').substring(1)
            if (fileObj.ext == '.js') {
              jsFiles[relativeKey] = item
            }
            else {
              if (accessExts.indexOf(fileObj.ext) > -1) {
                jsFiles['nobuild__' + relativeFile] = item
              }
            }
          }
        }
      }
    })
  }
  return jsFiles
}
複製代碼

上述是entry的生成代碼，涵蓋了小程序目錄結構下的全部須要的文件，並加上了一些特定的標識，以便於後續文件編譯輸出

非JS文件的輸出

在entry方法中咱們將wxml，wxss等文件做爲entry通通灌給webpack去處理，正常咱們使用webpack時是不會把非js文件做爲entry輸給webpack的。你猜webpack會報錯嗎，----- 哈哈，報錯就講不下去了，webpack會傻傻的把每一個entry文件都當作js來對待，而且正常輸出，*.wxml.js，等等，這是什麼鬼，我並不須要這樣的東東。加個插件來處理一下

compiler.hooks.compilation.tap('wpConcatFile', (compilation, params) => {
  compilation.hooks.beforeChunkAssets.tap('wpConcatFile', () => {
    compilation.chunks = compilation.chunks.filter(function (item) {
      return item.name.indexOf('nobuild__') == -1
    })
  })
  ...
  ...
}
複製代碼

nobuild__是在生成entry代碼是給非js文件加上的prefix前綴，在插件中咱們排除掉非js，將正常的js文件從新chunk，js文件就可以正常的輸出了，那麼那些非js文件呢？webpack並不會編譯生成它們，中途它們就會被module中的xx-loader處理完,而後被file-loader給甩出去了。

全局變量替換

將全局變量替換爲微信小程序的wx，咱們經過插件解決

const globalVar = 'wx'
...
...
...
let contentObj = compilation.assets[file]
let code = contentObj.source()
code = code.replace(windowRegExp, that.globalVar);
contentObj = new RawSource(code)

compilation.assets[file] = new ConcatSource(
  contentSource,
  '\n',
  '\/**auto import common&runtime js**\/',
  '\n',
  contentObj,
);
複製代碼

經過上述代碼不難看出，咱們讀取了每一個文件的源碼，並將全局變量window/global替換爲wx，再進行源碼重組。

運行時文件引入

咱們須要引入runtime.js和common.js文件，runtime運行環境是webpack爲每一個編譯文件插入的用於解析define, require, module等等這些的文件引入方法，爲了精簡文件，咱們將之抽離爲runtime.js，common.js爲咱們抽離出來的公共模塊文件。在web/h5下引入這些資源是否是so easy，但你還記得咱們是在小程序環境下嘛，並不能經過<script>標籤來引入資源文件啊啊啊，你會不會猛拍腦門，一下就慌了(哈哈)。老辦法，咱們經過插件解決

const lens = []
let posixPath = ''
const matchIt = chunk.name.match(/\//g)
if (matchIt) {
  matchIt.forEach(it => lens.push(this.prePath))
  // posixPath = './'+lens.join('')
  posixPath = lens.join('')
} else {
  posixPath = './'
}
let posixPathFile = posixPath + 'runtime.js'
let contentSource = this.contentSource.replace('~~~~', posixPathFile)
if (chunk.name.indexOf('runtime') > -1) {
  posixPathFile = posixPath + 'common.js'
  if (hasCommon) {
    contentSource = this.contentSource.replace('~~~~', posixPathFile)
  } else {
    contentSource = ''
  }
}
複製代碼

上述代碼片斷中，posixPath是咱們經過一個小的算法來推算資源引入的路徑深度變量，輸出並重寫源文件chunk，這樣咱們就解決了資源引入的問題

webpack-dev-server

引入webpack-dev-server可以使得webpack的編譯可以簡單的輸出到硬盤上，webpack默認是內存文件系統，並不輸出(固然有其餘方法，好比再寫個插件或更換文件系統啥的)，除了文件輸出，webpack-dev-server還可以爲咱們提供mock數據服務，呵呵~，這裏不展開了，你們有興趣百度一下，還可以爲咱們訪問後臺接口做proxy，這裏也不展開了。

經過上述操做，咱們就能獲得小程序結構的對等輸出，剩下咱們只須要將輸出文件導入到小程序編輯器中，接下來就是開發工做了。嗯，這樣就能夠開始給小程序搬磚了，開心嗎？

若是你想參考一下咱們的編譯代碼，能夠看這裏 github.com/webkixi/aot…
若是你想了解下咱們的架構，能夠看這裏 github.com/webkixi/aot…
若是你想使用咱們的架構，怕不怕？怕的話，你看着辦吧，哈哈! 不怕看這裏 www.npmjs.com/package/aot…
若是你還想看看咱們的小程序，看這裏 developers.weixin.qq.com/community/d…