运行环境

• Maven：3.6.0
• Eclipse：4.10.0
• jdk版本：1.8
• 操作系统：windows10

概念

Maven采用POM（project object model）配置项目

安装

• Maven依赖于jdk
• 安装包解压缩即可
• bin目录添加到PATH环境变量中
• 命令行执行mvn -v验证安装成功

创建（create）项目

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

• archetype为插件，用来根据模板生成项目的目录结构
• groupId对应源代码包名
• artifactId对应项目根目录文件名
• archetypeArtifactId对应采用的目录模板

构建（build）项目

构建

mvn package

• package是一个阶段，Maven会执行从第一个阶段直到指定阶段的全部过程。
• 阶段属于生命周期，Maven的生命周期包括clean、default和site。
• default除了package阶段，还包括compile、install、deploy等。install安装到本地仓库，deploy发布到远端仓库。

执行package后，Maven会将生成的jar包放到默认的target目录下。由于本机没有配置JAVA_HOME环境变量，出现了"no compiler is provided"的错误，添加配置后构建成功。

运行测试

java -cp target/my-app-1.0-SNAPSHOT.jar com.mycompany.app.App
由于本机没有配置classpath环境变量，出现了"找不到或无法加载主类"的错误，添加配置后运行成功。

添加依赖包

在pom.xml的dependencies元素下新增dependency子元素

<dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>4.11</version>
      <scope>test</scope><!--scope默认为compile-->
    </dependency>
</dependencies>

如何指定版本号范围：方括号表示闭区间，圆括号表示开区间

• [1.0, 2.0]表示1.0<=version<=1.2
• (, 1.5]表示version<=1.5

在不确定依赖包的groupId和artifactId时可以先去repository提供的web页面查询，比如说可以用mvn repository

添加资源

默认放在${basedir}/src/main/resources目录，资源会被一同打包到jar文件

如何改造已有项目为Maven项目

• 创建pom.xml，修改对应信息
• 如果源代码所在目录不符合Maven默认的目录结构，可以增加或修改如下配置

<build>
    <sourceDirectory>${basedir}/src/main/java</sourceDirectory>
</build>

• 如果资源所在目录不符合Maven默认的目录结构，可以增加或修改如下配置

<build>
    <resources>
        <resource>
            <targetPath>META-INF</targetPath>
            <directory>${basedir}/src</directory>
            <includes>
                <include></include>
            </includes>
            <excludes>
                <exclude></exclude>
            </exculdes>
        </resource>
    </resources>
</build>

ide集成

eclipse插件m2eclipse
在eclipse的4.4以上的版本内置了对maven的支持，所以可以不用自己安装插件。默认的插件使用内置的Maven，如果想要改成使用自己安装的Maven，可以通过修改Window->Preference->Maven中的以下配置

• Installations添加Maven运行时
• User Settings修改配置文件
• Archetypes修改目录结构模板的源，如果默认的源速度太慢的话可以考虑修改，甚至可以将archetype-catalog.xml文件存储在本地

配置修改完成后，在新建项目的时候选择Maven Project即可。如果项目已经存在，可以右键项目Configure->Convert to Maven Project将其转换成Maven项目。如果编译时出现以下错误信息：
No compiler is provided in this environment. Perhaps you are running on a JRE rather than a JDK?
检查Window->Preference->Java->Installed JREs是否是jdk下的jre。

依赖包源码

• eclipse环境下，可以右键jar包，选择Maven->Download Sources，此时源码会直接关联到jar包
• cmd环境下，切换到项目根目录后执行mvn dependency:sources

与Ant的区别

• Maven内置了更多的隐式规则，内置了软件构建的生命周期
  以上两点使得Maven知道如何在默认情况下完成任务，只要你告诉它做什么；而Ant需要你告诉它怎么做
• Maven有依赖管理和仓库管理，Ant没有