### 模块的创建方案 > 前面我们知道OFBiz的模块有固定的目录和文件结构, 所以为了减少模块创建的复杂度, 让开发者不浪费时间在不必要的事情上, OFBiz为创建模块提供了一个快速构建工具. > 所以, 我们可以使用脚本创建, 当然也可以手工创建(这种适合仔细研读代码时做). > > 脚本分OFBiz的版本的: > - Gradle脚本创建: 使用[createPlugin]指令 > - Ant脚本创建: 使用[create-component]指令 >[warning] 这里我们新建一个模块名为[newlearn], 译名: 新的学习模块 #### 使用[createPlugin]指令 > 这个指令要求项目必须是Gradle脚本构建环境的, 即高版本的OFBiz项目, 具体请看[**获取框架**](获取框架.md)章节. > 由于这个指令是一个需要配置额外参数的指令, 所以需要按照[用IDEA手工执行Gradle指令](用IDEA手工执行Gradle指令.md)来配置一个新建模块的指令. > > 特殊配置项输入值如下: > - Tasks输入: createPlugin > - Arguments输入: -PpluginId=newlearn -PpluginResourceName=NewLearn -PwebappName=newlearn -PbasePermission=NEWLEARN > - pluginId=newlearn: 指定当前模块名为(newlearn), 必须全小写且没有特殊字符. > - pluginResourceName=NewLearn: 模块资源文件名前缀, 必须是驼峰命名法, 且首字母大写. > - webappName=newlearn: 模块对外提供站点的根网址, 必须全小写且没有特殊字符. > - basePermission=NEWLEARN: 模块访问的基础权限, 必须全大写且没有特殊字符. > > 注: 若模块名称只有一个单词时, 这里的特殊配置项输入值可简写如下: > - Tasks输入: createPlugin > - Arguments输入: -PpluginId=learn > - 此时: 默认了(pluginResourceName=Learn、webappName=learn、basePermission=LEARN) > > 这个指令执行成功后将存储新模块在[OFBIZ_HOME/specialpurpose]目录下. #### 使用[create-component]指令 > 这个指令要求项目必须是Ant脚本构建环境的, 即低版本的OFBiz项目, 具体请看[**获取框架**](获取框架.md)章节. > 在IDEA的Ant工具窗口里找到[create-component]指令双击运行, 将弹出对话框, 按下文方式输入: > - Component name: (e.g. mycomponent) [Mandatory] > - 模块名称, 一般多个单词的全小写(如: newlearn) > - Component resource name: (e.g. MyComponent) [Mandatory] > - 模块资源名, 一般多个单词按[驼峰式(单词首字母大写)]编写(如: NewLearn) > - Webapp name: (e.g. mycomponent) [Mandatory] > - 建站的站点地址名, 一般多个单词的全小写(如: newlearn) > - Base permission: (e.g. MYCOMPONENT) [Mandatory] > - 模块访问基础权限, 一般多个单词的全大写(如: NEWLEARN) > - Confirm: N/Y/n/y > - 确认生成吗? 否/是/否/是, 在确认是后生成模块, > > 这个指令执行成功后将存储新模块在[OFBIZ_HOME/hot-deploy]目录下. #### 手动创建 > 其实个人是不推荐手动创建模块的, 那样极易出错, 因为很多单词, 写法, 代码块都不熟悉. > 个人建议还是使用项目自带的脚本来创建.