Maven常用命令

Posted 2020-08-15 晋心

1. 用Maven 命令创建一个简单的 Maven 项目

在cmd中运行如下命令：

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

即可在当前目录创建一个简单的 maven 项目，创建的时候会从Maven库中下载相关的依赖。

执行成功后，进入创建的 my-app 目录，打开 pom.xml 文件，内容如下：

<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/maven-v4_0_0.xsd">
  <modelVersion>4.0.0</modelVersion>
  <groupId>com.mycompany.app</groupId>
  <artifactId>my-app</artifactId>
  <packaging>jar</packaging>
  <version>1.0</version>
  <name>my-app-simple</name>
  <url>http://maven.apache.org</url>
  <dependencies>
    <dependency>
      <groupId>junit</groupId>
      <artifactId>junit</artifactId>
      <version>3.8.1</version>
      <scope>test</scope>
    </dependency>
  </dependencies>
</project>

　　

POM 包含了一个 project 所需要的所有信息，包括配置文件；开发者需要遵循的规则，缺陷管理系统，组织和licenses，项目的url，项目的依赖性，以及其他所有的项目相关因素。

我们开发Maven项目的时候，需要为其定义适当的坐标，在这个基础上，其他Maven项目才能应用该项目生成的构件。Maven坐标为各种构件引入了秩序，任何一个构件都必须明确定义自己的坐标，而一组Maven坐标是通过一些元素定义的，它们是groupId,artifactId,version,packaging,class-sifer。其中，前三个是必须的，packaging 是可选的，而 classfier 是不能直接定义的。

下面是一组坐标定义：

<groupId>com.mycompany.app</groupId>
<artifactId>my-app</artifactId>
<packaging>jar</packaging>
<version>1.0</version>

groupId ：定义当前Maven项目隶属的实际项目。首先，Maven项目和实际项目不一定是一对一的关系。比如SpringFrameWork这一实际项目，其对应的Maven项目会有很多，如spring-core,spring-context等。这是由于Maven中模块的概念，因此，一个实际项目往往会被划分成很多模块。其次，groupId不应该对应项目隶属的组织或公司。原因很简单，一个组织下会有很多实际项目，如果groupId只定义到组织级别，而后面我们会看到，artifactId只能定义Maven项目（模块），那么实际项目这个层次将难以定义。最后，groupId的表示方式与Java包名的表达方式类似，通常与域名反向一一对应。

artifactId : 该元素定义当前实际项目中的一个Maven项目（模块），推荐的做法是使用实际项目名称作为artifactId的前缀。比如上例中的my-app。

version : 该元素定义Maven项目当前的版本

packaging ：定义Maven项目打包的方式，首先，打包方式通常与所生成构件的文件扩展名对应，如上例中的packaging为jar,最终的文件名为my-app-1.0.jar。也可以打包成war, ear等。当不定义packaging的时候，Maven 会使用默认值 jar

classifier: 该元素用来帮助定义构建输出的一些附件。附属构件与主构件对应，如上例中的主构件为my-app-1.0.jar,该项目可能还会通过一些插件生成如my-app-1.0-javadoc.jar,my-app-1.0-sources.jar, 这样附属构件也就拥有了自己唯一的坐标

 

2.maven 基本命令

编译：compile

在cmd中，将目录切换到 my-app 下，执行mvn clean compile

build success之后我们会在my-app 下看到新增了一个target目录，该目录下存放项目编译后的文件，如.class文件

清理：clean

cmd目录my-app下执行命令 mvn clean

会将target文件删除，即清理项目，该命令可以结合其他命令运行

测试：test

cmd 目录 my-app 下执行命令 mvn test

会执行src/test/java 下的Junit 测试代码，在执行测试之前会自动执行编译命令。

打包：package

cmd 目录 my-app 下执行命令 mvn package

会将项目打成jar包，并放在target目录中

执行此命令之前会先执行编译和测试命令

安装：install

cmd 目录 my-app 下执行命令 mvn install

会将项目jar包安装到本地仓库中，以便其他项目使用

执行此命令之前会先执行编译，测试，打包命令

 

3.创建自定义archetype

创建一个新的 maven 项目，将配置好的公共文件放到相应目录。

注意：上面要生成模版的项目的版本号不能带-SNAPSHOT，否则找不到的，直接用数字1.0等就可以了。

编辑 pom.xml，添加插件

<plugins>
    <plugin>
        <groupId>org.apache.maven.plugins</groupId>
        <artifactId>maven-archetype-plugin</artifactId>
        <version>2.2</version>
    </plugin>
</plugins>

　　打开 cmd 窗口，进入刚才创建的 maven project  的根目录，运行maven命令：

mvn archetype:create-from-project  

然后会在target目录下面生成 generated-sources 目录，这个就是生成的 archetype，

进入到 archetype 目录，找到 pom.xml 文件，可修改该文件，增加 deploy 的设置，比如公司有 maven repository manager 服务器，以后就可以将该archetype部署到公司服务器上，便于其他人使用。比如：

<distributionManagement> 
    <repository> 
        <id>releases</id> 
        <name>MyCo Internal Repository</name> 
        <url>http://192.168.200.88:9001/nexus/content/repositories/releases</url> 
    </repository> 
    <snapshotRepository> 
        <id>snapshots</id> 
        <name>MyCo Internal Repository</name> 
        <url>http://192.168.200.88:9001/nexus/content/repositories/snapshots</url> 
    </snapshotRepository> 
</distributionManagement>

maven deploy/ maven install

archetype安装的地址是在maven安装目录下面的conf/settings.xml文件中指定的(<localRepository>字节)。

默认会在 ~/.m2 目录下面生成一个archetype-catalog.xml文件（和默认的settings.xml在同一个目录），声明了该archetype的groupId、artifactId和其他属性。如果没有找到，则保存在默认 ~/.m2 目录下。

Eclipse创建maven项目过程中，选择的“Default Local”指向的地址就是 ~/.m2，所以文件archetype-catalog.xml会被eclipse自动读取，使用eclipse创建maven项目的时候可以在"Default Local"一项中找到刚才自定义archetype名字。

如果想要卸载刚才安装的archetype，只需要将~/.m2目录下面的archetype-catalog.xml文件中对应的<archetype>字节段删掉，并且把本地仓库中相应groupId和artifactId下面的文件删掉就可以了。

安装到本地仓库中的archetype只可以被自己使用，如果想要共享，那么不要使用install命令。