### 模塊的創建方案 > 前面我們知道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]目錄下. #### 手動創建 > 其實個人是不推薦手動創建模塊的, 那樣極易出錯, 因為很多單詞, 寫法, 代碼塊都不熟悉. > 個人建議還是使用項目自帶的腳本來創建.