Maven 構建生命周期
Maven 構建生命周期定義了一個項目構建跟發布的過程。
一個典型的 Maven 構建(build)生命周期是由以下幾個階段的序列組成的:
階段 | 處理 | 描述 |
---|---|---|
驗證 validate | 驗證項目 | 驗證項目是否正確且所有必須信息是可用的 |
編譯 compile | 執行編譯 | 源代碼編譯在此階段完成 |
測試 Test | 測試 | 使用適當的單元測試框架(例如JUnit)運行測試。 |
包裝 package | 打包 | 創建JAR/WAR包如在 pom.xml 中定義提及的包 |
檢查 verify | 檢查 | 對集成測試的結果進行檢查,以保證質量達標 |
安裝 install | 安裝 | 安裝打包的項目到本地倉庫,以供其他項目使用 |
部署 deploy | 部署 | 拷貝最終的工程包到遠程倉庫中,以共享給其他開發人員和工程 |
為了完成 default 生命周期,這些階段(包括其他未在上面羅列的生命周期階段)將被按順序地執行。
Maven 有以下三個標准的生命周期:
- clean:項目清理的處理
- default(或 build):項目部署的處理
- site:項目站點文檔創建的處理
構建階段由插件目標構成
一個插件目標代表一個特定的任務(比構建階段更為精細),這有助於項目的構建和管理。這些目標可能被綁定到多個階段或者無綁定。不綁定到任何構建階段的目標可以在構建生命周期之外通過直接調用執行。這些目標的執行順序取決於調用目標和構建階段的順序。
例如,考慮下面的命令:
clean 和 pakage 是構建階段,dependency:copy-dependencies 是目標
mvn clean dependency:copy-dependencies package
這里的 clean 階段將會被首先執行,然後 dependency:copy-dependencies 目標會被執行,最終 package 階段被執行。
Clean 生命周期
當我們執行 mvn post-clean 命令時,Maven 調用 clean 生命周期,它包含以下階段:
- pre-clean:執行一些需要在clean之前完成的工作
- clean:移除所有上一次構建生成的文件
- post-clean:執行一些需要在clean之後立刻完成的工作
mvn clean 中的 clean 就是上面的 clean,在一個生命周期中,運行某個階段的時候,它之前的所有階段都會被運行,也就是說,mvn clean 等同於 mvn pre-clean clean ,如果我們運行 mvn post-clean ,那么 pre-clean,clean 都會被運行。
我們可以通過在上面的 clean 生命周期的任何階段定義目標來修改這部分的操作行為。
在下面的例子中,我們將 maven-antrun-plugin:run 目標添加到 pre-clean、clean 和 post-clean 階段中。這樣我們可以在 clean 生命周期的各個階段顯示文本信息。
我們已經在 C:\MVN\project 目錄下創建了一個 pom.xml 文件。
現在打開命令控製台,跳轉到 pom.xml 所在目錄,併執行下面的 mvn 命令。
C:\MVN\project>mvn post-clean
Maven 將會開始處理併顯示 clean 生命周期的所有階段。
[INFO] Scanning for projects... [INFO] ------------------------------------------------------------------ [INFO] Building Unnamed - com.companyname.projectgroup:project:jar:1.0 [INFO] task-segment: [post-clean] [INFO] ------------------------------------------------------------------ [INFO] [antrun:run {execution: id.pre-clean}] [INFO] Executing tasks [echo] pre-clean phase [INFO] Executed tasks [INFO] [clean:clean {execution: default-clean}] [INFO] [antrun:run {execution: id.clean}] [INFO] Executing tasks [echo] clean phase [INFO] Executed tasks [INFO] [antrun:run {execution: id.post-clean}] [INFO] Executing tasks [echo] post-clean phase [INFO] Executed tasks [INFO] ------------------------------------------------------------------ [INFO] BUILD SUCCESSFUL [INFO] ------------------------------------------------------------------ [INFO] Total time: < 1 second [INFO] Finished at: Sat Jul 07 13:38:59 IST 2012 [INFO] Final Memory: 4M/44M [INFO] ------------------------------------------------------------------
你可以嘗試修改 mvn clean 命令,來顯示 pre-clean 和 clean,而在 post-clean 階段不執行任何操作。
Default (Build) 生命周期
這是 Maven 的主要生命周期,被用於構建應用,包括下面的 23 個階段:
生命周期階段 | 描述 |
---|---|
validate | 檢查工程配置是否正確,完成構建過程的所有必要信息是否能夠獲取到。 |
initialize | 初始化構建狀態,例如設置屬性。 |
generate-sources | 生成編譯階段需要包含的任何源碼文件。 |
process-sources | 處理源代碼,例如,過濾任何值(filter any value)。 |
generate-resources | 生成工程包中需要包含的資源文件。 |
process-resources | 拷貝和處理資源文件到目的目錄中,為打包階段做准備。 |
compile | 編譯工程源碼。 |
process-classes | 處理編譯生成的文件,例如 Java Class 字節碼的加強和優化。 |
generate-test-sources | 生成編譯階段需要包含的任何測試源代碼。 |
process-test-sources | 處理測試源代碼,例如,過濾任何值(filter any values)。 |
test-compile | 編譯測試源代碼到測試目的目錄。 |
process-test-classes | 處理測試代碼文件編譯後生成的文件。 |
test | 使用適當的單元測試框架(例如JUnit)運行測試。 |
prepare-package | 在真正打包之前,為准備打包執行任何必要的操作。 |
package | 獲取編譯後的代碼,併按照可發布的格式進行打包,例如 JAR、WAR 或者 EAR 文件。 |
pre-integration-test | 在集成測試執行之前,執行所需的操作。例如,設置所需的環境變量。 |
integration-test | 處理和部署必須的工程包到集成測試能夠運行的環境中。 |
post-integration-test | 在集成測試被執行後執行必要的操作。例如,清理環境。 |
verify | 運行檢查操作來驗證工程包是有傚的,併滿足質量要求。 |
install | 安裝工程包到本地倉庫中,該倉庫可以作為本地其他工程的依賴。 |
deploy | 拷貝最終的工程包到遠程倉庫中,以共享給其他開發人員和工程。 |
有一些與 Maven 生命周期相關的重要概念需要說明:
當一個階段通過 Maven 命令調用時,例如 mvn compile,只有該階段之前以及包括該階段在內的所有階段會被執行。
不同的 maven 目標將根據打包的類型(JAR / WAR / EAR),被綁定到不同的 Maven 生命周期階段。
在下面的例子中,我們將 maven-antrun-plugin:run 目標添加到 Build 生命周期的一部分階段中。這樣我們可以顯示生命周期的文本信息。
我們已經更新了 C:\MVN\project 目錄下的 pom.xml 文件。
現在打開命令控製台,跳轉到 pom.xml 所在目錄,併執行以下 mvn 命令。
C:\MVN\project>mvn compile
Maven 將會開始處理併顯示直到編譯階段的構建生命周期的各個階段。
[INFO] Scanning for projects... [INFO] ------------------------------------------------------------------ [INFO] Building Unnamed - com.companyname.projectgroup:project:jar:1.0 [INFO] task-segment: [compile] [INFO] ------------------------------------------------------------------ [INFO] [antrun:run {execution: id.validate}] [INFO] Executing tasks [echo] validate phase [INFO] Executed tasks [INFO] [resources:resources {execution: default-resources}] [WARNING] Using platform encoding (Cp1252 actually) to copy filtered resources, i.e. build is platform dependent! [INFO] skip non existing resourceDirectory C:\MVN\project\src\main\resources [INFO] [compiler:compile {execution: default-compile}] [INFO] Nothing to compile - all classes are up to date [INFO] [antrun:run {execution: id.compile}] [INFO] Executing tasks [echo] compile phase [INFO] Executed tasks [INFO] ------------------------------------------------------------------ [INFO] BUILD SUCCESSFUL [INFO] ------------------------------------------------------------------ [INFO] Total time: 2 seconds [INFO] Finished at: Sat Jul 07 20:18:25 IST 2012 [INFO] Final Memory: 7M/64M [INFO] ------------------------------------------------------------------
命令行調用
在開發環境中,使用下面的命令去構建、安裝工程到本地倉庫
mvn install
這個命令在執行 install 階段前,按順序執行了 default 生命周期的階段 (validate,compile,package,等等),我們只需要調用最後一個階段,如這里是 install。
在構建環境中,使用下面的調用來純淨地構建和部署項目到共享倉庫中
mvn clean deploy
這行命令也可以用於多模塊的情況下,即包含多個子項目的項目,Maven 會在每一個子項目執行 clean 命令,然後再執行 deploy 命令。
Site 生命周期
Maven Site 插件一般用來創建新的報告文檔、部署站點等。
- pre-site:執行一些需要在生成站點文檔之前完成的工作
- site:生成項目的站點文檔
- post-site: 執行一些需要在生成站點文檔之後完成的工作,併且為部署做准備
- site-deploy:將生成的站點文檔部署到特定的服務器上
這里經常用到的是site階段和site-deploy階段,用以生成和發布Maven站點,這可是Maven相當強大的功能,Manager比較喜歡,文檔及統計數據自動生成,很好看。 在下面的例子中,我們將 maven-antrun-plugin:run 目標添加到 Site 生命周期的所有階段中。這樣我們可以顯示生命周期的所有文本信息。
我們已經更新了 C:\MVN\project 目錄下的 pom.xml 文件。
現在打開命令控製台,跳轉到 pom.xml 所在目錄,併執行以下 mvn 命令。
C:\MVN\project>mvn site
Maven 將會開始處理併顯示直到 site 階段的 site 生命周期的各個階段。
[INFO] Scanning for projects... [INFO] ------------------------------------------------------------------ [INFO] Building Unnamed - com.companyname.projectgroup:project:jar:1.0 [INFO] task-segment: [site] [INFO] ------------------------------------------------------------------ [INFO] [antrun:run {execution: id.pre-site}] [INFO] Executing tasks [echo] pre-site phase [INFO] Executed tasks [INFO] [site:site {execution: default-site}] [INFO] Generating "About" report. [INFO] Generating "Issue Tracking" report. [INFO] Generating "Project Team" report. [INFO] Generating "Dependencies" report. [INFO] Generating "Project Plugins" report. [INFO] Generating "Continuous Integration" report. [INFO] Generating "Source Repository" report. [INFO] Generating "Project License" report. [INFO] Generating "Mailing Lists" report. [INFO] Generating "Plugin Management" report. [INFO] Generating "Project Summary" report. [INFO] [antrun:run {execution: id.site}] [INFO] Executing tasks [echo] site phase [INFO] Executed tasks [INFO] ------------------------------------------------------------------ [INFO] BUILD SUCCESSFUL [INFO] ------------------------------------------------------------------ [INFO] Total time: 3 seconds [INFO] Finished at: Sat Jul 07 15:25:10 IST 2012 [INFO] Final Memory: 24M/149M [INFO] ------------------------------------------------------------------```