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

csm0 2019-12-06

本文用两个框架,一个是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即可看到如下效果

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

 对于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‘
        })
    ]
}

相关推荐