Maven是一个Java工具,所以你必须安装
Java环境
首先,下载Maven并解压到你选择的安装目录,例如在windows下的C:\maven,或者Linux下的/usr/local/maven。然后添加系统变量$M2_HOME和M2_HOME/bin到你的
系统路径。在终端或者命令提示里输入以下指令:
这应该打印你安装的Maven的版本,例如:
取决于你的网络设置,你可能需要额外的配置。如果需要则查看
配置Maven指南。
创建一个项目
在你的命令行执行以下maven goal:
- mvn archetype:create -DgroupId=com.mycompany.app -DartifactId=my-app
- mvn archetype:create -DgroupId=com.mycompany.app -DartifactId=my-app
如果你刚安装Maven,第一次运行这个可能需要花费一些时间。这是因为Maven会下载最新的artifacts(插件jars和其他文件)到你的本地reository。你也可能需要
多执行几次这个命令来让它成功。这是因为远程服务器可能在下载完成之前超时。不要担心,有解决这个的办法。
你将注意到create goal创建了一个名为artifactId的目录。更换到该目录。
在该目录下你将注意到以下
标准项目结构
- my-app
- |-- pom.xml
- `-- src
- |-- main
- | `-- java
- | `-- com
- | `-- mycompany
- | `-- app
- | `-- App.java
- `-- test
- `-- java
- `-- com
- `-- mycompany
- `-- app
- `-- AppTest.java
- 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为项目的Project Object Model,或者POM。
POM
pom.xml文件为Maven中项目的配置核心。它为一个单独的配置文件,包含以你想要的方式后构建项目需要的主要信息。POM很大并且它的复杂性让人却步,但是
没必要理解所有复杂的东西来有效的使用它。该项目的POM为:
- <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
- <modelVersion>4.0.0</modelVersion>
- <groupId>com.mycompany.app</groupId>
- <artifactId>my-app</artifactId>
- <packaging>jar</packaging>
- <version>1.0-SNAPSHOT</version>
- <name>Maven Quick Start Archetype</name>
- <url>http:
- <dependencies>
- <dependency>
- <groupId>junit</groupId>
- <artifactId>junit</artifactId>
- <version>3.8.1</version>
- <scope>test</scope>
- </dependency>
- </dependencies>
- </project>
- <project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
- xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
- <modelVersion>4.0.0</modelVersion>
- <groupId>com.mycompany.app</groupId>
- <artifactId>my-app</artifactId>
- <packaging>jar</packaging>
- <version>1.0-SNAPSHOT</version>
- <name>Maven Quick Start Archetype</name>
- <url>http:
- <dependencies>
- <dependency>
- <groupId>junit</groupId>
- <artifactId>junit</artifactId>
- <version>3.8.1</version>
- <scope>test</scope>
- </dependency>
- </dependencies>
- </project>
刚才我做了什么?
你执行了Maven goal archetype:create,并传递不同的参数给该goal。前缀archetype为包含该goal的
插件
如果你熟悉
Ant,你可能认为这和task类似。该goal创建一个简单的基于一个原型的项目。一个插件是一些具有一个一般目的的goal的集。
例如jboss-maven-plugin,它的目的是“处理不同的jboss事项”。
构建项目
该命令行将打印不同的动作,并以下面内容结束:
- ...
- [INFO] ------------------------------------------------------------------------
- [INFO] BUILD SUCCESSFUL
- [INFO] ------------------------------------------------------------------------
- [INFO] Total time: 2 seconds
- [INFO] Finished at: Thu Oct 05 21:16:04 CDT 2006
- [INFO] Final Memory: 3M/6M
- [INFO] ------------------------------------------------------------------------
- ...
- [INFO] ------------------------------------------------------------------------
- [INFO] BUILD SUCCESSFUL
- [INFO] ------------------------------------------------------------------------
- [INFO] Total time: 2 seconds
- [INFO] Finished at: Thu Oct 05 21:16:04 CDT 2006
- [INFO] Final Memory: 3M/6M
- [INFO] ------------------------------------------------------------------------
不像执行的第一个命令(archetype:create),你可能注意到第二个命令为一个简单的词-package。这是一个phase而不是一个goal。
一个phase为
构建生命周期中的一步,构建生命周期为一个有序的phase序列。
当给定一个phase时,Maven将执行序列中的每个phase直到并包含定义的phase。例如,如果我们执行compile phase,则执行的phases为:
1,validate
2,generate-sources
3,process-sources
4,generate-resources
5,process-resources
6,compile
你可以使用下列命令测试新编译并打包的JAR:
- java -cp target/my-app-1.0-SNAPSHOT.jar com.mycompany.app.App
- java -cp target/my-app-1.0-SNAPSHOT.jar com.mycompany.app.App
这将打印:
运行Maven工具
Maven Phases
尽管不是一个全面的列表,这些是最常见的默认执行的生命周期phases。
validate:验证项目是正确的并且所有必要的信息可得
compile:编译项目的源代码
test:使用一个合适的单元测试框架来测试编译的源代码。这些测试应该不需要代码打包或者部署
package:得到编译的源代码并以它的发布形式打包,例如一个JAR
integration-test:如果有必要则处理并部署包到集成测试可以被运行的环境
verify:运行任何检查来检验包是合法的并达到质量标准
install:安装包到本地repository,作为本地其他项目中的依赖使用
deploy:在一个集成或者发布环境中完成,复制最终的包到远程repository来与其他开发者和项目共享
除了上面的默认列表还有两个其他的Maven生命周期需要注意,它们为
clean:清除先前的构建创建的artifacts
site:为该项目生成site文档
Phases事实上映射到底层的goal。每个phase执行的指定的goals依赖于项目的打包类型。例如,如果项目类型为JAR则package执行jar:jar,而项目类型为WAR则
执行war:war。
需要注意的一个有趣的事情是phases和goals可以一次执行。
- mvn clean dependency:copy-dependencies package
- mvn clean dependency:copy-dependencies package
该命令将清除项目,复制依赖,并打包项目(当然,执行所有的phases直到package)。
生成Site
该phase生成一个基于项目的pom的信息的site。你可以查看在target/site下生成的文档。
结论
我们希望本迅速浏览引起了你对Maven的兴趣。注意这是一个大量删节的快速上手指南。
现在你已经准备好了解关于你刚才执行的动作相关的全面的细节了。查看
Maven上手指南。