《maven官方文檔》5分鍾開始Maven
前提
你必須明白如何在電腦上安裝軟件。如果你不知道如何做,請向你學校、辦公室裏等的人請教下,或者付費給他人讓他們解釋給你。Maven郵件組不是尋求這個建議的最好地方。
安裝
Maven是個Java工具,所以你必須安裝了Java才能繼續。首先,下載Maven,然後按照安裝指南。完成後,在終端或命令行中鍵入如下指令:
mvn --version
應該會打印已安裝Maven的版本。例如:
Apache Maven 3.0.5 (r01de14724cdef164cd33c7c8c2fe155faf9602da; 2013-02-19 14:51:28+0100) Maven home: D:\apache-maven-3.0.5\bin\.. Java version: 1.6.0_25, vendor: Sun Microsystems Inc. Java home: C:\Program Files\Java\jdk1.6.0_25\jre Default locale: nl_NL, platform encoding: Cp1252 OS name: "windows 7", version: "6.1", arch: "amd64", family: "windows"
基於你的網絡設置,你需要額外的配置。如果有必要的話看看Maven配置指南.如果你在使用Windows,你應該查看Windows前提以確保你已準備好在Windows上使用Maven。
創建一個項目
你需要一個給你項目保存的地方。在某處創建一個目錄,然後在這個目錄裏開始shell。在你的命令行上,執行如下Maven語言:
mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false
如果你已安裝Maven,第一次執行這個需要一定時間。這是因為Maven在下載最新的物件(jar插件和其他文件)到你的本地倉庫。在成功前,也需要你執行幾次命令。這是因為在下載完成前,遠程服務器可能超時。別擔心,有幾種解決這個的方法。
你講看見生成語言創建了一個和物件ID相同名字的目錄。變更到這個目錄:
cd my-app
使用這個目錄,你講看到如下標準目錄結構:
my-app |-- pom.xml `-- src |-- main | `-- java | `-- com | `-- mycompany | `-- app | `-- App.java `-- test `-- java `-- com `-- mycompany `-- app `-- AppTest.java
src/main/java目錄包含項目源代碼,src/test/java目錄包含檢查源代碼,pom.xml是項目的項目對象模型,或POM。
POM
在Maven裏,pom.xml文件是項目配置的核心。它是一個獨立的配置文件,包含了你想要的方式下建立項目所必須的主要信息。POM是巨大的,其複雜度使人苦惱。但你隻需要有效地使用它,沒有必要明白所有的錯綜複雜。項目的POM是:
<project xmlns="https://maven.apache.org/POM/4.0.0" xmlns:xsi="https://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="https://maven.apache.org/POM/4.0.0 https://maven.apache.org/xsd/maven-4.0.0.xsd"> <modelVersion>0.0</modelVersion> <groupId>mycompany.app</groupId> <artifactId>my-app</artifactId> <version>0-SNAPSHOT</version> <packaging>jar</packaging> <name>Maven Quick Start Archetype</name> <url>https://maven.apache.org</url> <dependencies> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>8.2</version> <scope>test</scope> </dependency> </dependencies> </project>
隻需要我做的是什麼?
你執行了Maven語言原型:generate,向這個語言傳了許多參數。前綴原型是包含這個語言的插件。如果你熟悉Ant,你可以設想這個是相同的任務。基於一個原型,這個語言創建了一個簡單的項目。現在可以說,插件是個有通用目的的語言的集合。例如jboss-maven-plugin,目的是“處理大量jboss條目”。
建設項目
mvn package
命令行會打印出各種指令,並具有以下結尾:
... [INFO] ------------------------------------------------------------------------ [INFO] BUILD SUCCESSFUL [INFO] ------------------------------------------------------------------------[INFO] Total time: 2 seconds [INFO] Finished at: Thu Jul 07 21:34:52 CEST 2011 [INFO] Final Memory: 3M/6M [INFO] ------------------------------------------------------------------------
不像第一個執行的命令(archetype:generate),你可能注意到第二個命令是簡單的一個詞-package。這是個階段實行而不是語言。實行階段是[建設生命周期]( https://maven.apache.org/guides/introduction/introduction-to-the-lifecycle.html)裏的而一個步驟,是一係列有序的階段。當給出一個實行階段,Maven將執行序列裏的每一個階段,並且包括定義的階段。例如,如果我們執行編譯階段,實際上得到執行的階段是:
- 驗證
- 編譯代碼
- 處理代碼
- 生成資源文件
- 處理資源文件
- 編譯
您可以使用以下命令測試新編譯和打包的JAR:
java -cp target/my-app-1.0-SNAPSHOT.jar com.mycompany.app.App
將打印經典語句:
Hello World!
運行Maven工具
Maven階段
盡管幾乎沒有一個全麵的清單,這些都是執行最常用的默認生命周期階段。
- 驗證:驗證項目是正確的,所有必要的信息
- 編譯:編譯項目的源代碼
- 測試:使用合適的單元測試框架測試編譯的源代碼。 這些測試應該不需要代碼被打包或部署
- 包:把編譯後的代碼,並在其分發格式打包,例如一個JAR。
- 集成測試:如果需要,處理和部署包到集成測試可以運行的環境
- 驗證:運行任何檢查,以驗證包是有效的,同時符合質量標準
- 安裝:包本地安裝到本地存儲庫中,用作本地其他項目的依賴
- 部署:在集成或發布環境中進行,複製最終的包到遠程倉庫與其他開發者和項目共享。
還有值得注意的另外兩個Maven的生命周期超出上麵的默認列表。 他們是
- 清潔:清理之前建立創建的工件
- 網站:生成此項目的站點文檔,
實行階段實際上映射到底層的語言。 每階段中執行的具體語言是取決於項目的包類型。 例如, packet執行的jar:jar,如果項目類型為JAR和war:war ,如果項目類型是-你猜對了-WAR。
需要注意的一個有趣的事情是,階段和語言,可以按順序執行。
mvn clean dependency:copy-dependencies package
此命令將清理項目,複製依賴關係,並打包項目(當然執行各個階段到包 )。
生成站點
mvn site
這個階段產生基於對項目的POM信息的站點。你可以看一下在target/site生成的文檔。
結論
我們希望這一快速瀏覽已經激起了你的Maven中的通用性興趣。請注意,這是一個非常截斷快速入門指南。現在,你已經準備好關於你剛才執行的動作更全麵的信息。 看看Maven的入門指南 。
最後更新:2017-05-19 16:38:03