工程配置
icejs 基于 build-scripts,因此工程使用方式与 build-scripts 完全一致。
#
开发调试默认情况下,项目的 package.json 会配置以下命令:
执行 npm start
即可进行项目开发,正常情况下执行命令后自动打开浏览器 http://localhost:3333
进行页面预览,修改源码后浏览器会自动刷新页面。执行 npm run build
进行项目构建,构建产物默认输出到 ./build
目录下。
#
命令行介绍icejs 提供了 start/build 两个核心命令供开发者使用。
在使用
npm run start
命令时,如需传入参数请按照这个格式npm run start -- --https
#
start#
build#
工程构建配置工程构建相关的配置默认都收敛在项目根目录的 build.json
文件中,配置方式:
如果希望使用 JS 类型的配置文件,则需要在 npm scripts 中指定配置文件:
build.config.js
中通过 JS 模块的方式指定配置:
当下支持的基础配置项请参考文档:配置。
#
进阶配置#
根据环境区分工程配置参考 区分不同环境。
#
如何开启新的 JSX 转换ice.js 1.16.0+ 支持 New JSX Transform,开启该能力之后,编写 React 组件时不再需要在头部引入 React
。
只需要修改 tsconfig.json
中的 compilerOptions.jsx
即可:
接下来书写组件就不再需要引入 React 了:
#
自定义工程配置如果基础配置和已有插件都无法支持业务需求,可以通过自定义配置来实现,自定义配置同时也是一个 Webpack 插件。
首先新建 build.plugin.js
文件作为一个自定义插件,然后写入以下代码:
插件内部代码写法可以参考文档 通过插件定制工程能力。
最后在 build.json
里引入自定义插件即可:
#
调试在某些情况下可能遇到配置没有生效,或者配置不符合预期,这时候我们可以通过下面的命令进行调试,查看最终的 Webpack 配置是否符合预期。