webpack打包工具之ts版开发框架搭建

本文用两个框架，一个是threejs，一个是phaser3，其实流程都是一样。

nodejs、npm是基础，不再多说！

首先新建一个文件夹命名three-study，然后npm init -y

用webpack工具，第一步要安装webpack主功能包：

npm i webpack --save-dev

npm i webpack-cli --save-dev

这两个包是webpack最基础的包，如果仅仅只是用于打包，这两个足够了（--save-dev的意思是仅仅用于开发环境）。

接下来第二步为里调试方便，需要安装webpack-dev-server

npm i webpack-dev-server --save-dev

这个包是一个用来快速搭建本地运行环境的工具，通常情况下package.json里的dev或start调试模式都是用它，常用方式：

webpack-dev-server --config webpack.conf.js

其相关配置可自行百度，一般会配置到webpack.conf.js里。

第三步：安装html-webpack-plugin

npm i html-webpack-plugin --save-dev

这个包就是将打包后的js自动添加到目标index.html模板文件里，省去每次打包都手动操作的麻烦。

第三步：安装ts-loader，typescript，这是ts语言的配置，所有用到ts开发的都必须安装这两个依赖

npm i ts-loader --save-dev
npm i typescript --save-dev

第四步：创建ts配置文件，tsconfig.json，ts的运行必须要有tsconfig文件，否则无法运行和转换成js，我的配置如下：

{
    "compilerOptions": {
        "module": "commonjs",
        "sourceMap": true,
        "target": "es5"
    },
    "include": [
        "src/*"
    ],
    "exclude": [
        "node_modules"
    ]
}

接下来安装file-loader和clean-webpack-plugin，file-loader用于资源加载配置，而clean-webpack-plugin则仅仅是打包的时候清除本地原来的打包文件，相当于保持最新，非必须

npm i file-loader --save-dev
npm i clean-webpack-plugin --save-dev

到这里所有工具依赖全部安装完成，接下来就是我们要开发的包如phaser或threejs，这里注意一定要安装到依赖环境，即--save 而不是--save-dev

npm i three --save

整个package.json依赖如下

{
  "name": "three-study",
  "version": "1.0.0",
  "description": "",
  "main": "index.js",
  "scripts": {
    "start":"webpack-dev-server --config webpack.conf.js",
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "keywords": [],
  "author": "",
  "license": "ISC",
  "devDependencies": {
    "clean-webpack-plugin": "^3.0.0",
    "file-loader": "^5.0.2",
    "html-webpack-plugin": "^3.2.0",
    "ts-loader": "^6.2.1",
    "typescript": "^3.7.3",
    "webpack": "^4.41.2",
    "webpack-cli": "^3.3.10",
    "webpack-dev-server": "^3.9.0"
  },
  "dependencies": {
    "three": "^0.111.0"
  }
}

好了，接下来配置webpack.conf.js文件，让程序运行起来，我的配置如下

const path = require("path");
const HtmlWebpackPlugin = require('html-webpack-plugin');

module.exports = {
    mode:'development',
    entry:'./src/Main.ts',
    output:{
        path:path.resolve(__dirname,'./public'),
        filename:'app.bundle.js'
    },
    devServer:{
        //设置服务器访问的基本目录
        contentBase:path.resolve(__dirname,'./public'),
        host:'172.18.27.110',
        port:1222, // 设置端口号
        inline:true
    },
    module:{
        rules:[
            {
                test:/\.tsx?$/,
                use:'ts-loader',
                exclude:/node_modules/
            },
            {
                test:/\.(png|jpe?g|gif|svg)(\?.*)?$/,
                use:{
                    loader:'file-loader',
                    options:{
                        name:'[name].[ext]',
                        outputPath:'assets/'
                    }
                }
            }
        ]
    },
    resolve:{
        extensions:['.ts','.tsx','.js']
    },
    devtool:"eval",
    plugins:[
        new HtmlWebpackPlugin({
            template:'index.html'
        })
    ]
}

其中172.18.27.110是我自己电脑的局域网ip，其他各项配置均可查询官方文档，这里不再扯远。

最后一步，根目录创建一个index.html模板文件，然后创建一个src和public文件夹，public文件夹主要用来存放资源，在src下创建一个Main.ts文件，编写代码如下

import * as THREE from 'three'

class Main{
    constructor(){
        this.init();
    }
    private scene:THREE.Scene;
    private camera:THREE.Camera;
    private renderer:THREE.WebGLRenderer;
    private myCube:THREE.Mesh;
    private init(){
        let scene = new THREE.Scene();
        this.scene = scene;
        let camera = new THREE.PerspectiveCamera(75,window.innerWidth/window.innerHeight,.01,1000);
        this.camera = camera;
        let renderer = new THREE.WebGLRenderer();
        renderer.setSize(window.innerWidth,window.innerHeight);
        document.body.appendChild(renderer.domElement);
        this.renderer = renderer;

        let geometry = new THREE.BoxGeometry(1,1,1);
        let material = new THREE.MeshBasicMaterial({color:0xfff000});
        let cube = new THREE.Mesh(geometry,material);
        scene.add(cube);
        this.myCube = cube;

        camera.position.z = 5;

        this.animate();
    }

    private animate(){
        requestAnimationFrame(this.animate.bind(this));
        this.renderer.render(this.scene,this.camera);
        this.loop();
    }

    private loop(){
        this.myCube.rotation.x += 0.01;
        this.myCube.rotation.y += 0.01;
        this.myCube.rotation.z += 0.01;
    }
}
new Main();

在命令行运行npm run start，然后打开浏览器输入172.18.27.110:1222即可看到如下效果

对于phaser，也是如此配置，这里仅仅配置里一个dev环境，其实还有个线上打包环境，我一般分成dev.conf.js和prd.conf.js，分别代表dev和生产环境，这里有个生产环境配置可作参考

const path = require("path");
const CleanWebpackPlugin = require("clean-webpack-plugin").CleanWebpackPlugin;
const HtmlWebpackPlugin = require('html-webpack-plugin');

module.exports = {
    mode:'production',
    devtool:"source-map",
    entry:'./src/Main.ts',
    output:{
        filename:'js/[name].[chunkhash].js',
        path:path.resolve(__dirname,'.././dist')
    },
    module:{
        rules:[
            {
                test:/\.tsx?$/,
                use:'ts-loader',
                exclude:/node_modules/
            },
            {
                test:/\.(png|jpe?g|gif|svg)(\?.*)?$/,
                use:{
                    loader:'file-loader',
                    options:{
                        name:'[name].[ext]',
                        outputPath:'assets/'
                    }
                }
            }
        ]
    },
    resolve:{
        extensions:['.ts','.tsx','.js']
    },
    optimization:{
        splitChunks:{
            name:"vendor",
            chunks:"all"
        }
    },
    plugins:[
        new CleanWebpackPlugin(),
        new HtmlWebpackPlugin({
            template:'index.html'
        })
    ]
}