Weex 輔助工具

為了方便使用，Weex 提供了一系列輔助模塊/插件來實(shí)現(xiàn)降級功能。

Npm 模塊

• npm 模塊主頁： https://www.npmjs.com/package/@weex-project/downgrade
• 源碼地址： https://github.com/weexteam/downgrade

首先安裝 ?@weex-project/downgrade? 模塊，然后在頁面代碼中引入，調(diào)用其中的接口即可觸發(fā)降級。

import downgrade from '@weex-project/downgrade'

提供的接口如下：

force()

強(qiáng)制降級。調(diào)用該接口可以無條件立即降級。

downgrade.force()

check(options)

檢查環(huán)境信息是否滿足 ?options? 的描述，返回校驗(yàn)結(jié)果，并不會觸發(fā)降級。

?options? 的格式見下文詳解，返回值的格式如下：

• ?isDowngrade?: 是否應(yīng)該降級（不滿足 ?options? 中的條件則為 ?true?）。
• ?errorType?: 錯誤類型，語義同上，僅 ?isDowngrade? 為? true ?時才包含。
• ?code?: 錯誤代碼，語義同上，僅 ?isDowngrade? 為 ?true? 時才包含。

const result = downgrade.check({ ios: { osVersion: '<=9.0' } })
if (!result.isDowngrade) {
  // Do something
}

condition(options)

檢查環(huán)境信息是否滿足 ?options? 的描述，不滿足條件則觸發(fā)降級。 ?options? 的格式見下文詳解，沒有返回值。

downgrade.condition({
  android: {
    appVersion: '<=7.8.0',
    weexVersion: '<0.16.0'
  }
})

Webpack 插件

Weex 提供了一個 Webpack 插件 webpack-plugin-downgrade 支持在打包時注入觸發(fā)降級的代碼。

// webpack.config.js
var DowngradePlugin = require('webpack-plugin-downgrade')

module.exports = {
  // other configs ...

  plugins: [
    new DowngradePlugin({ /* downgrade options */ })
  ]
}

插件支持的配置項如下：

• ?force?: ?Boolean? 是否強(qiáng)制降級。
• ?condition: Object? 滿足特定條件時才觸發(fā)降級。具體的配置項見下文詳解。

// 強(qiáng)制降級
new DowngradePlugin({ force: true })

// 滿足某些條件時降級
new DowngradePlugin({
  condition: {
    ios: {
      deviceModel: ['iPhone5,1']
    },
    android: {
      osVersion: '<=4.4',
      weexVersion: '<0.16.0'
    }
  }
})