英文原地址:http://maven.apache.org/guides/getting-started/maven-in-five-minutes.html

 

一、前提

需要懂得如何在计算机上安装软件。

二、安装

1、maven是一个java工具,所以得首先安装java。

2、下载maven,并安装安装指南一步步安装(解压、配置环境变量)。

3、测试:运行:mvn --version

三、建立一个项目

1、首先建立一个目录用于存放maven项目,这里假设为d:\mavenspace。并切换到该目录。

2、运行下面的命令。(其中archetype是plugin,generate是plugin中的goal)

注:如果是第一次运行这个命令,速度可能较慢,因为要maven会根据依赖关系下载很多对应的jar包。

mvn archetype:generate -DgroupId=com.mycompany.app -DartifactId=my-app -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false

3、运行命令cd my-app进入到maven生成的目录,会发现src/main/java目录、src/test/java目录、pom.xml文件。

4、POM文件

该文件是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>
  <version>1.0-SNAPSHOT</version>
  <packaging>jar</packaging>

  <name>Maven Quick Start Archetype</name>
  <url>http://maven.apache.org</url>

  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.8.2</version>
      <scope>test</scope>
    </dependency>
  </dependencies>
</project>

5、刚才我做了什么?
我们运行了maven目标archetype:generate并给命令传递了一些参数。前缀archetype 包含了目标。这个和Ant很像,可以想象成Ant的Task。这个目标根据原型创建了一个简单的项目。插件是为了一些共同的目标而由一组目标组成的。举例来说,jboss-maven-plugin就是为了处理“各种各样jboss相关的问题”。

6、构建这个项目

a、运行命令:mvn package
不像我们运行的第一个命令(archetype:generate),这个命令只有一个单词:package。这不是一个目标,是一个阶段(phase),也就是项目构建生命周期中的一个过程。构建生命周期是一组有序的阶段的序列。当给定了一个阶段,maven会执行这个序列中在该阶段之前的所有阶段,也包括给定的阶段。举例来说,当我们执行compile这个阶段时,实际上被执行的阶段是:

validate

generate-sources

process-sources

generate-resources

process-sources

compile

 

b、用下面命令测试该编译和打包了的jar,输出结果应该是:Hello World!

java -cp target/my-app-1.0-SNAPSHOT.jar com.mycompany.app.App

 

四、运行Maven工具

1、maven阶段(maven phases)

尽管是一个很复杂的列表,下面是最常见的构建过程中的阶段。

validate:

compile:

test:

package:

integration-test:

verify:

install:

deploy:

除了上面默认的列表,这里还有两个构建过程阶段。

clean:清除前面构建生成的制品。

site:为这个项目生成站点文档。

注:阶段(phases)一般都对于潜在的目标(goals)。每个阶段执行的目标是依赖于项目的打包类型。举例来说,如果项目类型是JAR则package这个阶段执行jar:jar这个目标,如果项目类型是WAR则执行的是war:war这个目标。

一个有趣的事情是阶段和目标可以在一个序列中被执行。

mvn clean dependency:copy-dependencies package

举例来说,以上命令会首先清除项目生成文件、复制依赖、然后打包项目(当然会执行所有阶段直到打包这个阶段)。

2、构建站点(generating the site)

命令是:mvn site

这个阶段会根据项目的pom生成一个站点。你可以在target/site目录下看到生成的文档。

 

五、结论

我们希望这个快速的预览激起了你对maven多样性的兴趣。注意这个一个节选的快速开始的手册。如果你想对刚才那些你执行的动作有更加全面的和详细的了解,请阅读maven开始后的手册。