NEI 工程规范介绍
NEI 3.0 版本和以往版本有所不同,可以直接在 NEI 平台上定义工程规范
工程规范定义了工程的初始化目录结构,在使用本工具构建项目的时候,会按照定义好的目录和文件数据在本地生成相应的目录和文件
工程规范和项目的关联方式
在项目的"工具设置"中,我们可以分别指定项目的"WEB工程规范"、"AOS工程规范"、"iOS工程规范"以及"测试工程规范"
除了设置项目的工程规范外,还可以为项目设置"变量映射规则"和"命令行参数":
变量映射规则
有时在 NEI 上定义的变量名称, 在使用构建工具翻译成目标语言代码时, 名称可能需要更改。此时可以使用变量映射规则表。
比如在 NEI 上面定义的类型名称为 Number,在生成 Objective-C 代码时,想使用 NSInteger, 此时可以设置规则如下:
数据模型 | 变量名称 |
---|---|
Number | NSInteger |
命令行参数
请查看 传给模板的数据格式说明 中关于命令行参数的介绍
工程规范中的目录
除了常规目录外,还有以下特殊目录:
静态资源根目录:在使用本地模拟容器时,需要该信息,该目录用来存放静态资源
模板根目录:在使用本地模拟容器时,需要该信息,该目录用来存放页面模板
接口MOCK数据根目录:使用本工具生成的异步接口的mock数据会放到该目录下面
模板MOCK数据根目录:使用本工具生成的页面模板的mock数据会放到该目录下面
JAR包根目录:存放自定义JAR包,ftl 模板可以直接调用JAR包中的静态方法
工程规范中的文件
除了常规文件外,还有以下特殊文件:
接口列表填充:使用项目中定义的异步接口数据列表作为数据源,每个异步接口都会生成一个文件
数据模型列表填充:使用项目中定义的数据模型数据列表作为数据源,每个数据模型都会生成一个文件.为了保持通用性,我们区分了枚举类型和非枚举类型.如果需要使用枚类型的数据类型列表,需要在文件名后面加上
!!enum
页面模板列表填充:使用项目中定义的页面模板数据列表作为数据源,每个页面模板都会生成一个文件
视图列表填充:使用项目中定义的视图数据列表作为数据源,每个视图都会生成一个文件
命令行参数配置文件:该文件的内容须为有效的 json,它的值会作为本构建工具的命令行参数
传给模板的数据格式说明
本构建工具使用 handlebars 模板引擎,在生成目录和文件的时,传入的数据见说明:传给模板的数据格式说明
Handlebars 辅助函数集说明