Maven最佳实践-distributionManagement
2017-04-19 14:13
337 查看
分发构件至远程仓库
mvn install 会将项目生成的构件安装到本地Maven仓库,mvn deploy 用来将项目生成的构件分发到远程Maven仓库。本地Maven仓库的构件只能供当前用户使用,在分发到远程Maven仓库之后,所有能访问该仓库的用户都能使用你的构件。
我们需要配置POM的distributionManagement来指定Maven分发构件的位置,如下:
Maven项目的POM中,环境配置<distributionManagement>负责管理构件的发布。
1.<distributionManagement>的基本配置
[html] view plain copy
<distributionManagement>
...
<downloadUrl>http://jcat.ericsson.org/my-project</downloadUrl>
<status>deployed</status>
</distributionManagement>
说明:
downloadUrl,一个URL,其他Maven项目可以通过该URL下载并引用当前Maven项目的构件。注意区别本文下面的<repository>中的URL,<repository>中的URL给出了当前Maven项目的构件的发布URL。
status,当前Maven项目的状态,可用的状态如下所示。注意,该值是由Maven自动设置,永远不要人工设置。
none,未指明状态,默认值
converted,该Maven项目的构件已经被转换为兼容Maven 2
partner,该Maven项目的构件保持与另一个库的Maven版本一致
deployed,该Maven项目的构件是通过Maven 2或Maven 3发布的,最常用的值
verified,该Maven项目的构件已经被验证过
2.<distributionManagement>的<repository>配置
给出Maven部署当前项目的构件到远程库时,关于远程库的配置。示例如下:
[html] view plain copy
<distributionManagement>
<repository>
<uniqueVersion>false</uniqueVersion>
<id>corp1</id>
<name>Corporate Repository</name>
<url>scp://repo/maven2</url>
<layout>default</layout>
</repository>
<snapshotRepository>
<uniqueVersion>true</uniqueVersion>
<id>propSnap</id>
<name>Propellors Snapshots</name>
<url>sftp://propellers.net/maven</url>
<layout>legacy</layout>
</snapshotRepository>
...
</distributionManagement>
具体配置参数,参考前文。
3. <distributionManagement>的<site>配置
除了部署当前Maven项目的构件,还可以部署当前Maven项目的网站和文档。示例如下:
[html] view plain copy
<distributionManagement>
...
<site>
<id>mojo.website</id>
<name>Mojo Website</name>
<url>scp://beaver.codehaus.org/home/projects/mojo/public_html/</url>
</site>
...
</distributionManagement>
这里的配置参数与<repository>中的对应配置参数一致。
4. <distributionManagement>的<relocation>配置
随着一个Maven项目的发展壮大,该Maven项目的构件可能需要重新发布到新的库。<relocation>可以将当前Maven项目以新的构件的形式发布到另一个库。示例如下:
[html] view plain copy
<distributionManagement>
...
<relocation>
<groupId>org.apache</groupId>
<artifactId>my-project</artifactId>
<version>1.0</version>
<message>We have moved the Project under Apache</message>
</relocation>
...
</distributionManagement>
mvn install 会将项目生成的构件安装到本地Maven仓库,mvn deploy 用来将项目生成的构件分发到远程Maven仓库。本地Maven仓库的构件只能供当前用户使用,在分发到远程Maven仓库之后,所有能访问该仓库的用户都能使用你的构件。
我们需要配置POM的distributionManagement来指定Maven分发构件的位置,如下:
Maven项目的POM中,环境配置<distributionManagement>负责管理构件的发布。
1.<distributionManagement>的基本配置
[html] view plain copy
<distributionManagement>
...
<downloadUrl>http://jcat.ericsson.org/my-project</downloadUrl>
<status>deployed</status>
</distributionManagement>
说明:
downloadUrl,一个URL,其他Maven项目可以通过该URL下载并引用当前Maven项目的构件。注意区别本文下面的<repository>中的URL,<repository>中的URL给出了当前Maven项目的构件的发布URL。
status,当前Maven项目的状态,可用的状态如下所示。注意,该值是由Maven自动设置,永远不要人工设置。
none,未指明状态,默认值
converted,该Maven项目的构件已经被转换为兼容Maven 2
partner,该Maven项目的构件保持与另一个库的Maven版本一致
deployed,该Maven项目的构件是通过Maven 2或Maven 3发布的,最常用的值
verified,该Maven项目的构件已经被验证过
2.<distributionManagement>的<repository>配置
给出Maven部署当前项目的构件到远程库时,关于远程库的配置。示例如下:
[html] view plain copy
<distributionManagement>
<repository>
<uniqueVersion>false</uniqueVersion>
<id>corp1</id>
<name>Corporate Repository</name>
<url>scp://repo/maven2</url>
<layout>default</layout>
</repository>
<snapshotRepository>
<uniqueVersion>true</uniqueVersion>
<id>propSnap</id>
<name>Propellors Snapshots</name>
<url>sftp://propellers.net/maven</url>
<layout>legacy</layout>
</snapshotRepository>
...
</distributionManagement>
具体配置参数,参考前文。
3. <distributionManagement>的<site>配置
除了部署当前Maven项目的构件,还可以部署当前Maven项目的网站和文档。示例如下:
[html] view plain copy
<distributionManagement>
...
<site>
<id>mojo.website</id>
<name>Mojo Website</name>
<url>scp://beaver.codehaus.org/home/projects/mojo/public_html/</url>
</site>
...
</distributionManagement>
这里的配置参数与<repository>中的对应配置参数一致。
4. <distributionManagement>的<relocation>配置
随着一个Maven项目的发展壮大,该Maven项目的构件可能需要重新发布到新的库。<relocation>可以将当前Maven项目以新的构件的形式发布到另一个库。示例如下:
[html] view plain copy
<distributionManagement>
...
<relocation>
<groupId>org.apache</groupId>
<artifactId>my-project</artifactId>
<version>1.0</version>
<message>We have moved the Project under Apache</message>
</relocation>
...
</distributionManagement>
相关文章推荐
- Maven最佳实践:划分模块
- Maven最佳实践:划分模块
- Maven最佳实践:约定优于配置
- Maven-03 安装最佳实践
- Maven最佳实践:版本管理
- Maven最佳实践
- Maven最佳实践――目录的约定
- \t\tMaven 最佳实践:maven仓库-1
- Maven最佳实践:Maven仓库(转)
- Maven最佳实践:划分模块
- Maven最佳实践:遵循约定
- Maven最佳实践:管理依赖
- Maven最佳实践:划分模块
- Maven最佳实践:划分模块
- Maven最佳实践:划分模块
- Maven最佳实践:Maven仓库 - 1
- Maven最佳实践:版本管理【转】
- Maven最佳实践:管理依赖
- 【Maven】Maven最佳实践:划分模块
- (转)Maven最佳实践:划分模块