使用maven -pl选项和从模块级别运行maven有什么区别?

时间:2016-02-24 13:39:40

标签: maven maven-3 pom.xml multi-module maven-reactor

之间有什么区别吗?
C:/dev/path/to/Project> mvn package -pl MyModule -am -s settings.xml

C:/dev/path/to/Project/MyModule> mvn package -am -s ../settings.xml

就我而言,这两项行动的结果应该是一样的。

然而,在每种情况下,行为似乎都不同:前者似乎更为广泛;后者更快结束 - 我试图理解为什么会这样。

1 个答案:

答案 0 :(得分:13)

让我们首先澄清一下有关多模块(聚合器)构建的内容(即,从聚合器/父项目调用构建)并构建单个模块。

让我们使用以下示例:

-+ modules-project
 |- module-a
 |- module-b (depends on module-a)

因此,模块项目将作为其pom的一部分具有以下内容:

<modules>
    <module>module-a</module>
    <module>module-b</module>
</modules>

从module-project文件夹构建时:

module-project> mvn clean install

Maven Reactor将创建声明模块的依赖关系图并相应地构建它们,因此module-a将在module-b之前构建,因为module-b依赖于module-a

module-b> mvn clean install

可以正常工作,只需构建module-b,将模块-a解析为依赖项(我们之前安装过),并在需要时将其作为构建类路径的一部分使用。

如果不是在modules-project上调用clean install而是调用clean package,Maven就不会在我们的本地Maven缓存中安装任何东西,因此在模块中依赖于module-a -b项目无法解决。澄清:

module-project> mvn clean package

仍将构建整个项目(包含其所有子模块)并创建包(即jar文件)。

module-b> mvn clean package

现在失败,因为对本地Maven缓存或任何Maven存储库中不存在对module-a的依赖关系,也就是说,它不作为依赖关系和Maven存在它对其他模块一无所知,它正在构建一个简单的项目(模块)而不了解其他模块(由modules-project提供)。当构建模块项目时,Maven正在构建具有更多信息的每个模块,知道模块与另一个模块的依赖关系,它不会在本地缓存或任何Maven存储库中查找模块间依赖关系。同样,它是reactor build

这就是为什么只有在已经构建了整个多模块项目并且至少在本地Maven缓存中安装其工件的情况下才能将子模块构建为单独的构建的原因。这就是为什么最佳实践始终是从多模块项目开始工作的原因,以便Maven拥有所有必需的信息,您可以:

  • 构建整个多模块项目(mvn clean install
  • 通过-pl选项构建单个或一组模块(但仍然从多模块项目开始)
  • 通过-pl-am选项(仍来自多模块项目)构建单个或一组模块其依赖项

现在让我们澄清最后一点,这也将回答你的问题。

modules-project> mvn clean package -pl module-a

运行正常,只构建模块-a作为反应堆构建的一部分。然而

modules-project> mvn clean package -pl module-b

会失败,因为Maven会按照要求尝试构建module-b,但是,再次,会将module-a视为依赖项而不是模块,因此在本地Maven缓存中或在配置的Maven存储库中,找不到它。

模块项目&GT; mvn clean package -pl module -b -am

最终会正常工作,因为现在Maven也在构建依赖模块(感谢-am),并确切知道在哪里找到它们(作为多模块信息的一部分,即{{1 })。)。

让我们看看最后一个案例:

模块-B个mvn clean package -am

如果我们从未安装过整个多模块项目(即我们总是运行modules),会失败,如果不是反应堆的一部分,clean package选项会被忽略build(因为它是reactor的一个选项,而不是正常构建的选项),Maven仍会尝试在本地缓存或存储库中查找module-a。

这就是为什么你应该总是从其聚合器/父级以及-am-pl选项构建子模块,以确保:

  • 使用正确的依赖关系和模块信息正确构建
  • 您构建了最新版本的代码/依赖项,而不是针对先前在maven缓存中安装的内容,这可能与其模块的代码不一致

这也是为什么你的观察是正确的,你提到的第一个调用(从聚合器项目构建一个子模块)需要稍长一点,因为它不仅仅是子模块的构建,而是更多(因为还有更多)要处理的信息,它是一种不同类型的构建,一个反应堆,也可能构建依赖模块),而直接构建一个子模块(从其目录)是一个更简单的Maven构建,因此也更快(但更容易出错)缺乏一些信息)。

有关反应堆构建的这些选项的更多信息,请参见here