FIS3 构建工具安装与发布指南

安装 FIS3

npm install -g fis3 

• -g 表示安装到全局目录，必须使用全局安装才能在命令行（cmd 或者终端）找到 fis3 命令。
• 安装过程中遇到问题请查阅官方文档。
• 如果已安装旧版 FIS，也执行上面的命令进行安装，FIS3 和 FIS 是不同的构建工具，向下无法完全兼容。如果要从 FIS 迁移到 FIS3，请参考官方文档。
• 如果 npm 长时间运行无响应，推荐使用镜像源来安装。

安装完成后执行 fis3 -v 判断是否安装成功，如果安装成功，则显示类似如下信息：

$ fis3 -v [INFO] Currently running fis3 (/Users/Your/Dev/fis3/dev/fis3) v3.0.0

如果提示找不到 fis3 命令并且 npm 安装成功退出，请参考官方文档解决。如果 Windows 下提示 basedir=$(dirname "$(echo "$0" | sed -e 's,\\,/,g')") 则找到 npm 全局路径下面的 fis 脚本删除，留下 fis.cmd 就好了。

发布

进入项目根目录，执行命令，进行构建。

项目根目录：FIS3 配置文件（默认 fis-conf.js）所在的目录为项目根目录。

fis3 release -d <path> 

• <path> 任意目录。
• fis3 release -h 获取更多参数。

构建发布到项目目录的 output 目录下

fis3 release -d ./output 

报错处理

1. unable to load plugin [fis3-hook-commonjs/lookup.js]

   解决方案：

   • 全局安装或者本地安装都可以。

   npm install -g fis3-hook-commonjs 
   

   或者

   npm install fis3-hook-commonjs 
   

2. unable to load plugin [fis3-hook-amd]

   解决方案：

   • 全局安装或者本地安装都可以。

   npm install -g fis3-hook-amd 
   

   或者

   npm install fis3-hook-amd 
   

3. [ERROR] unable to load plugin [fis3-postpackager-loader] or [fis-postpackager-loader]

   解决方案：

   • 支持全局安装和局部安装，根据自己的需求来定。