Maven系列3--Maven命令行選項

可以免費轉載,轉載時請註明出處  http://pengqb.iteye.com


Maven 命令行選項
說明:
1、使用-選項時,和後面的參數之間可以不要空格。而使用--選項時,和後面的參數之間必須有空格。如下面的例子:
 $ mvn help:describe -Dcmd=compiler:compile
 $ mvn install --define maven.test.skip=true
2、有些命令行選項是從Maven2.1纔有的。

 

定義屬性
-D,--define<arg> 定義系統屬性
這是最常用到的定製Maven插件行爲的選項。

 

獲得幫助
-h,--help  顯示幫助信息
如果你要尋找特定插件的可用目標和參數信息,請參考Maven Help 插件。

 

使用構建剖面(profile)
要從命令行激活一個或多個構建剖面,使用下面的選項:
-P,--activate-profiles<arg> 被激活的,用逗號分隔的剖面列表

 

顯示版本信息
要顯示Maven版本信息,在命令行裏,使用下面選項中的一個。
-V,--show-version 顯示版本信息後繼續執行Maven其他目標。
-v,--version 顯示版本信息。
這兩個選項輸出相同的版本信息,但-v選項在打印版本信息後會中斷Maven處理。如果你想讓Maven版本信息出現在構建輸出的開始處,你應該使用-V選項。如果你正在持續構建環境裏運行Maven,並且你需要知道特定構建使用了哪個Maven版本,-V選項就可以派上用場。

 

離線模式運行
-o,--offline 離線模式工作
該參數可以阻止通過網絡更新插件或依賴。

使用定製的POM或定製的Settings文件
如果你不喜歡pom.xml文件名、用戶相關的Maven配置文件的位置或者全局配置文件的位置,你可以通過下面的選項定製這些參數。
-f, --file <file> 強制使用備用的POM文件
-s,--settings <arg> 用戶配置文件的備用路徑
-gs, --global-settings <file> 全局配置文件的備用路徑

 

加密密碼
下面的命令允許你使用Maven加密密碼,然後存儲到Maven settings文件裏:
-emp,--encrypt-master-password <password> 加密主安全密碼
-ep,--encrypt-password <password>  加密服務器密碼

 

失敗處理
下面的選項控制,在多模塊項目構建的中間階段,Maven如何應對構建失敗。
-fae, --fail-at-end 僅影響構建結果,允許不受影響的構建繼續
-ff, --fail-fast 遇到構建失敗就停下來
-fn,--fail-never 無論項目結果如何,構建從不失敗
-fn 和 -fae選項對於使用持續集成工具(例如Hunson)的多模塊構建非常有用。 -ff 選項對於運行交互構建的開發者非常有用,因爲開發者在開發週期中想得到快速的反饋。

 

控制Maven的日誌級別
如果你想控制Maven的日誌級別,你可以使用下面三個命令行選項:
-e, --errors 產生執行錯誤相關消息
-X, --debug 產生執行調試信息
-q, --quiet 僅僅顯示錯誤
只有出現錯誤或問題,-q 選項纔打印一條消息。-X 選項會打印大量的調試日誌消息,這個選項主要被Maven開發者和Maven插件開發者用來診斷在開發過程中碰到的Maven代碼問題。如果你想診斷依賴或路徑問題,-X 選項也非常有用。如果你是Maven開發者,或者你需要診斷Maven插件的一個錯誤,那麼-e選項就會派上用場。如果你想報告Maven或Maven插件的一個未預料到的問題,你應該傳遞-X 和 -e命令行選項。

用批處理方式運行Maven
要在批處理模式下運行Maven,使用下面的選項:
-B, --batch-mode 在非交互(批處理)模式下運行
如果你需要在非交互、持續集成環境下運行Manve,必須要使用批處理模式。在非交互模式下運行,當Mven需要輸入時,它不會停下來接受用戶的輸入,而是使用合理的默認值。

 

下載和驗證依賴
下面的命令行選項會影響Maven和遠程倉庫的交互以及Maven如何驗證下載的構件:
-C, --strict-checksums 如果校驗碼不匹配的話,構建失敗
-c, --lax-checksums 如果校驗碼不匹配的話,產生告警
-U, --update-snapshots 在遠程倉管更新發布版本或快照版本時,強制更新。
如果你關注安全,你就想帶 -C選項運行Maven。Maven倉庫爲每個存儲在倉庫裏的構件維護一個MD5 和 SHA1 校驗碼。如果構件的校驗碼不匹配下載的構件,Maven默認被配置成告警終端用戶。如果傳遞-C 選項,當遇到帶着錯誤校驗碼的構件,會引起Maven構建失敗。如果你想確保Maven檢查所有快照依賴的最新版本,-U選項非常有用。

 

控制插件更新
下面的命令行選項告訴Maven,它將如何從遠程倉庫更新(或不更新)Maven插件:
-npu,--no-plugin-updates 對任何相關的註冊插件,不進行最新檢查。使用該選項使Maven表現出穩定行爲,該穩定行爲基於本地倉庫當前可用的所有插件版本。
-cpu, --check-plugin-updates 對任何相關的註冊插件,強制進行最新檢查。強制Maven檢查Maven插件的最新發布版本,即使在你的項目POM裏明確規定了Maven插件版本,還是會強制更新。
-up, --update-plugins cpu的同義詞.

下面的命令行選項影響Maven從遠處倉庫下載插件的方式:
-npr, --no-plugin-registry 對插件版本不使用~/.m2/plugin-registry.xml  裏的配置。
-npr 命令行選項告訴Maven不要參考插件註冊表。欲瞭解關於插件註冊表的更多信息,去這裏:http://maven.apache.org/guides/introduction/introduction-to-plugin-registry.html.

 

非遞歸構建
有時,你只想運行Maven構建,而不陷入項目子模塊的構建。通過使用下面的命令行選項,你可以做到這點:
-N, --non-recursive 阻止Maven構建子模塊。僅僅構建當前目錄包含的項目。
運行該命令行選項使Maven只爲當前目錄下的項目執行生命週期中的目標或步驟。

 

參考文獻:《Maven:The Complete Reference》

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章