Efront NPM | npm.io

English version

efront 是一个开发工具，可以独立开发项目，也可以仅使用其一项功能

efront 思想

每个文件只导出一份数据，这一份数据可以是 boolean,number,string,function,object,bigint,null,undefined 中的任意一种
文件名即变量名，在其他文件中引用当前文件导出的变量，只要使用当前文件的文件名（不含后缀）即可
无环形引用（相互调用：a引用b，b引用a；首尾引用：a引用b，b引用...c，c引用a）
减少异步io的时间，应用启动过程只加载有用代码，启动完成后等待用户操作的同时预加载下一步的代码
版本局部更新，异步加载的每一份代码拥有一个独立的版本号，在版本信息无变化时不重复加载

efront 功能列表

提供 0 秒启动的开发服务器，允许代码在浏览器中完成依赖项的异步加载
提供 “按文件名引用的代码” 的编译环境，允许开发者不写 import, require 等语句
提供具有环形检查的加载器
自动识别并附加预加载的逻辑
自动追加检查缓存的逻辑并生成代码版本号
efront 服务器提供跨域中转功能
efront 编译导出的组件对可能造成代码可读的字符串和属性进行提取和加密

基本命令（部分命令适用于windows，其他系统类似）

1. 下载安装

efront 运行在 nodejs 环境下，请在安装 nodejs 环境后使用。从npm全局安装efront

npm install -g efront

2. 查看帮助系统

命令行帮助命令如下

efront help

也可以用如下命令启动文档服务器，用浏览器查看帮助信息

efront docs

3. 启动开发环境服务器

efront live
efront live HTTP端口
efront live HTTP端口 HTTPS端口

其中HTTP端口和HTTPS端口为数字，可以不输入，更多使用方案可以查看帮助系统。要禁用https服务端口开启时的警告信息，可以配置自己的ssl证书路径和证书密码。

4. 压缩编译项目

默认将编译输出的目标代码保存到public目录可以把public目录的代码发布到任意服务器上

set app=PROJECT_NAME
set public_path=PUBLIC_PATH
efront public

其中PUBLIC_PATH为发布路径，PUBLIC_PATH的默认值是当前目录的public文件夹

如果是要发布在服务器上，不建议使用以.html结尾的方式发布，将异步加载的代码写入独立的文件
如果要导出无服务器本地可以访问的项目，可以设置一个以.html结尾的项目名，将异步加载的代码合并到首页文件

set app=PROJECT_NAME.html

如果要导出组件，可以设置一个以.js结尾的项目名

set app=PROJECT_NAME.js

目前版本的efront提供对 commonjs中的require语法和es6中的import语法的不完全支持（不支持异步环形调用），对于符合要求的相关项目，可以进行编译发布。
如果要发布含有require语法的组件，并希望将组件及所有依赖项合并输出，那么可以将上面的efront public替换为efront publish
如果需要自动识别路径，类似public/dist/output/release的目录都可能被识别为目标路径，这些路径中的文件可能被覆盖，如果确认可行，可以使用efront build或efront release

5.Watch模式

监测文件变化，自动编译更新的部分并输出到指定目录

set app=PROJECT_NAME
set public_path=PUBLIC_PATH
efront watch

可配置项说明

efront 优先读取系统环境变量中的配置，也可以将配置信息写入配置文件。 efront 默认读取当前路径下的_envs/和用户目录的.efront/_envs/进行环境配置的初始化（如果要修改默认环境配置的路径，可以在系统环境变量中设置CONFIG_PATH，多个目录可以用英文逗号分开），其中的setup.bat为环境配置的入口，访问工作目录的某个子项目APP时，还将自动读取_envs/app=%APP%.bat中的配置。

当前版本的efront，支持命令行快捷配置环境变量，如

 efront watch --APP=kugou --PUBLIC_PATH=... --PAGE_PATH=...

配置项	说明
`APP`	应用名，影响最终生成应用的路径和默认的源文件路径
`PAGE_PATH`	页面文件所存放的根路径，默认为`./apps`
`COMM_PATH`	组件文件所存放的根路径，如果存在多个，可以用 `,` 分割，可以使用 `:` 指定为`efront`所提供的组件的路径，默认为`./coms`
`PUBLIC_PATH`	发布的目标根路径，最终生成的代码路径为`PUBLIC_PATH\APP`，如果此项被指定为`PAGE_PATH`，efront将禁用发布功能，在执行`efront start`后，可以通过浏览器访问压缩版本的代码
`PUBLIC_EXTT`	发布的逻辑代码的扩展名，默认`.js`或`.txt`
`PAGE`	页面文件存放的路径，默认为应用名`APP`
`COMM`	组件文件存放的路径，默认为应用名加efront默认组件库`APP,zimoli`
`PREFIX`	发布时指定组件className前缀，默认无前缀
`NOPROXY`	传统代理，默认在开发环境开启传统代理，在生产环境禁用传统代理
`DIRECT`	如果是用`pathname`作为单页应用的页面路径，可以配置此参数，以使空路都指向该参数所指定的路径。如果配置为数值，则自动截取用户路径的前几级，如果指定为字符串，则所有空路径都返回该字符串路径下的内容。
`ENTRY_NAME`	efront默认依次查找文件中声明的`main`,`Main`,`MAIN`,`<文件名>`做为导出对象（入口），用户可配置此环境变量以进行修改
`EXTRACT`	如果项目有多个入口，efront默认将主程序写入独立的文件，如果项目是单入口，efront默认将主程序并入index.html，如果您的代码有特殊要求，可以配置引此参数指定efront的行为
`UPLEVEL`	如果您的代码发布时不需要降级，可添加此参数，以提高编译速度
`MSIE`	用`efront live --msie`启动服务器，可对`ie`系列浏览器进行代码适配，以便在`ie`上动态调试
`AUTOEVAL`	自动常量化的开关，在打包目标代码时默认开启，在开发环境默认关闭，可以指定参数`--no-autoeval`或`--autoeval`修改`efront`的默认行为

功能选项

efront 启动的服务器，默认提供跨域中转的功能，可以在index.html的头部脚本中设置window.cross_host='https://somehost/'指定一个具体的efront服务器实例供cross方法使用
efront 默认禁用了首页的缓存功能，如果要启用，可以在头部script中加入 window.preventCache=false;
efront 默认禁止在iframe中运行，如果要开启，可以在头部script中加入 window.PREVENT_FRAMEWORK_MODE=false;
efront应用的默认初始化脚本是zimoli('/main');，可以在body标签上加上main-path=...属性指定初始化脚本的路径
efront 默认将page_path指向的路径中的.ts,.js,.mjs,.cjs,.less,.html,.xht,.vue文件识别为页面文件，可以在index.html加上<script src='libpath/*' type=deleteoncompile></script>，其中libpath/*指向静态文件的路径，efront编译过程将识别并做出正确的处理
如果仅做为跨域服务器使用，可以将开发环境的url改写为如下形式，以使返回结果加上跨域头：

转发http 用 * http://EFRONT_HOST/*BACKEND_HOST/PATHNAME
转发https 用 ** http://EFRONT_HOST/**BACKEND_HOST/PATHNAME

如：在本机的88端口启动efront服务器，要访问https://im.qq.com/index ，可以请求http://localhost:88/**im.qq.com/index取得带跨域头的数据