前言

本文重点介绍如何搭建一个Typescript+Vue的Weex开发环境，需要你有一定的Typescript、Vue、Webpack的开发经验，如果你不清楚这些，可以先看看相关内容：

Typescript中文站点
Vue
Webpack

初始化

示例项目结构

- dist
- src
  - page
    - example
      - example.vue
      - index.ts
  - types
    - vue.d.ts
    - weex.d.ts
- package.json
- tsconfig.json
- webpack.config.js

安装依赖

使用 yarn init 构建好 package.json

然后安装相关开发依赖，因Weex项目最终运行环境为构建好的 bundle js ，故所有依赖项均放入devDependencies即可

yarn add webpack typescript vue vue-class-component weex-loader ts-loader -D

配置文件

tsconfig.json

{
    "compilerOptions": {
        "target": "es5",
        "lib": [
            "dom",
            "es5",
            "es2015"
        ],
        "module": "es2015",
        "moduleResolution": "node",
        "experimentalDecorators": true,
        "removeComments": true,
        "suppressImplicitAnyIndexErrors": true,
        "allowSyntheticDefaultImports": true,
        "strict": true,
        "allowJs": true
    },
    "include": [
        "./src/**/*"
    ]
}

webpack.config.js

ts-loader 必须指定 .ts 文件为入口才能工作

Vue对象存在于Weex的运行环境，无须加载，但为了保证代码上下文的使用连贯（即代码中依然使用 import Vue from 'vue ），我们可以定义 externals 配置来让 webpack 忽略 vue 包，避免打包到 bundle js 中去

const path = require('path');
const webpack = require('webpack');

var distDir = path.join(__dirname, 'dist');
var pageDir = path.join(__dirname, 'src', 'page')

module.exports = {
    entry: {
        example: [path.join(pageDir, 'example', 'index.ts')]
    },
    output: {
        path: distDir,
        filename: '[name].js'
    },
    resolve: {
        extensions: ['.ts', '.js', '.vue']
    },
    module: {
        rules: [
            {
                test: /\.ts$/,
                loader: 'ts-loader',
                exclude: /node_modules/,
                options: {
                    appendTsSuffixTo: [/\.vue$/]
                }
            },
            {
                test: /\.vue$/,
                loader: 'weex-loader'
            }
        ]
    },
    externals: {
        vue: 'Vue'
    },
    plugins: [
        new webpack.BannerPlugin({
            banner: '// { "framework": "Vue" } \n',
            raw: true,
            exclude: 'Vue'
        })
    ]
}

src/types/vue.d.ts

让TS代码段可以导入 .vue 文件

declare module "*.vue" {
    import Vue from 'vue'
    export default Vue
}

src/types/weex.d.ts

声明weex实例对象，可自行扩展其他模块

declare namespace we {
    interface instance {
        /** 该变量包含了当前 Weex 页面的所有环境信息 */
        config: any

        /** 获取某个 native module 的所有方法 */
        requireModule(name: string): any
    }
}

declare var weex: we.instance

package.json

配置 dev 脚本，在开发过程中监测文件变化并编译打包为 bundle js

"script": {
    "dev": "webpack --config ./webpack.config.js -w"
}

测试运行

示例代码

src/page/example/example.vue

src/page/example/index.ts

import Example from './example.vue'
new Example({ el: '#root' })

TS写法与JS写法的区别

.vue 文件中的TS代码段，导出的是Vue的“子类”，导出后就可以直接进行 new 实例化；而在JS代码段中，导出的则是一个 ComponentOptions 接口（套用TS定义来说明）的JSON对象，导出后作为参数进行 new Vue(JSON) 进行实例化。关于这点可以比对上面的代码，与官方示例代码，即可看出区别

el 参数问题

官方文档并没有对 el 参数有特别的说明，但经个人踩坑发现该参数为必须值，如果欠缺，运行时则页面空白

目前已知当 entry 以 .vue 文件为入口时，会自动生成；除此之外，均须自已指定，基本上可以为任意字符串值，只要非空就可以了

编译打包

执行以下命令，便会启动 webpack 监测 example/index.ts 为入口的文件变化，并编译打包到 dist 目录下

yarn dev

至此，拿到 dist/example.js 文件，就可以在 Weex框架下的APP里运行显示了

进阶

每个 bundle js 都是一个Weex实例页面，可以参考示例项目结构，在 webpack.config.js 里定义规则，遍历 src/page ，每个目录就是一个页面，动态生成 entry 入口配置

vue-class-component 提供的修饰器功能，在编译打包时，不可避免的会生成部份代码，最终在每个 bundle js 里都会重复出现。再加上项目可能还有一些公共lib定义，公共组件等。基于这一点，可以考虑定制 JS Framework，将公用类库及文件集成进去，进一步节省各个 bundle js 的体积

结尾

文中涉及的多项技术内容，本人并未有深入的研究，只因Weex社区资源实在匮乏，在查找Typescript开发Weex相关资料时，很惊讶的几乎完全没有任何信息。为了避免有类似需求的人走弯路，所以将个人研究结果撰文分享出来，希望能给大家提供帮助。如若文中有描述错误之处，欢迎指出修正，感激不尽。

搭建Weex的Typescript开发环境

前言

初始化