来到新公司对很多陌生的技术一头雾水,以前在工作中没有真正使用过maven,于是强迫自己蛋定下来一个一个的突破,下面是我对maven的setting配置文件的理解,由于是现学的,难免可能会理解偏差,还请牛人路过指正。
<!-- xuze added by:添加了一些注释,利于新人理解 Date:2011年7月18日 --> <settings> <!-- 配置镜像 --> <mirrors> <mirror> <!-- 此镜像一般用来作为公司内部开发的版本快照,作为public-snapshots仓库的镜像地址 --> <!-- 镜像的id,id用来区分不同的mirror元素。 --> <id>nexus-public-snapshots</id> <!-- 被镜像的服务器的id。例如,如果我们要设置了一个Maven中央仓库(http://repo1.maven.org/maven2)的镜像, 就需要将该元素设置成central。这必须和中央仓库的id “central”完全一致。 --> <mirrorOf>public-snapshots</mirrorOf> <!-- 该镜像的URL。 --> <url>http://repos.d.xxx.com/nexus/content/groups/public-snapshots</url> </mirror> <mirror> <!-- 此镜像一般用来作为公司第三方引用基础类库镜像,是所有仓库的镜像地址 --> <id>nexus</id> <!-- 为*表示为所有的仓库做镜像,有了这个配置,所有的构建都会包含public组,如果你想包含public-snapshots组, 你必须添加public-snapshots这个Profile,通过在命令行使用如下的 -P 标志:$ mvn -P public-snapshots clean install --> <mirrorOf>*</mirrorOf> <url>http://repos.d.xxx.com/nexus/content/groups/public</url> </mirror> </mirrors> <!-- settings.xml中的profile元素是pom.xml中profile元素的裁剪版本。它包含了activation, repositories, pluginRepositories 和 properties元素。 这里的profile元素只包含这四个子元素是因为这里只关心构建系统这个整体(这正是settings.xml文件的角色定位),而非单独的项目对象模型设置。 如果一个settings中的profile被激活,它的值会覆盖任何其它定义在POM中或者profile.xml中的带有相同id的profile。 --> <profiles> <profile> <id>development</id> <!-- 仓库。仓库是Maven用来填充构建系统本地仓库所使用的一组远程项目。而Maven是从本地仓库中使用其插件和依赖。 不同的远程仓库可能含有不同的项目,而在某个激活的profile下,可能定义了一些仓库来搜索需要的发布版或快照版构件。有了Nexus,这些应该交由Nexus完成 --> <repositories> <repository> <id>central</id> <!-- 虚拟的URL形式,指向镜像的URL,因为所有的镜像都是用的是nexus,这里的central实际上指向的是http://repos.d.xxx.com/nexus/content/groups/public --> <url>http://central</url> <!-- 表示可以从这个仓库下载releases版本的构件--> <releases><enabled>true</enabled></releases> <!-- 表示可以从这个仓库下载snapshot版本的构件 --> <snapshots><enabled>true</enabled></snapshots> </repository> </repositories> <!-- 插件仓库。仓库是两种主要构件的家。第一种构件被用作其它构件的依赖。这是中央仓库中存储大部分构件类型。 另外一种构件类型是插件。Maven插件是一种特殊类型的构件。由于这个原因,插件仓库独立于其它仓库。 pluginRepositories元素的结构和repositories元素的结构类似。每个pluginRepository元素指定一个Maven可以用来寻找新插件的远程地址。 --> <pluginRepositories> <pluginRepository> <id>central</id> <url>http://central</url> <releases><enabled>true</enabled></releases> <snapshots><enabled>true</enabled></snapshots> </pluginRepository> </pluginRepositories> </profile> <profile> <!--this profile will allow snapshots to be searched when activated--> <id>public-snapshots</id> <repositories> <repository> <id>public-snapshots</id> <!-- 虚拟的URL形式,指向镜像的URL,这里指向的是http://repos.d.xxx.com/nexus/content/groups/public-snapshots --> <url>http://public-snapshots</url> <releases><enabled>false</enabled></releases> <snapshots><enabled>true</enabled></snapshots> </repository> </repositories> <pluginRepositories> <pluginRepository> <id>public-snapshots</id> <url>http://public-snapshots</url> <releases><enabled>false</enabled></releases> <snapshots><enabled>true</enabled></snapshots> </pluginRepository> </pluginRepositories> </profile> </profiles> <!-- 激活的Profile。activation元素并不是激活profile的唯一方式。settings.xml文件中的activeProfile元素可以包含profile的id, 任何在activeProfile中定义的profile id,不论环境设置如何,其对应的profile都会被激活。如果没有匹配的profile,则什么都不会发生。 profile也可以通过在命令行,使用-P标记和逗号分隔的列表来显式的激活(如,-P test)。 要了解在某个特定的构建中哪些profile会激活,可以使用maven-help-plugin(mvn help:active-profiles)。 --> <activeProfiles> <!-- 没有显示激活public-snapshots --> <activeProfile>development</activeProfile> </activeProfiles> <!-- 自定义本地仓库地址,其默认值为~/.m2/repository --> <localRepository>/data/maven-repository</localRepository> <!-- 发布的服务器和密码,暂时未限制权限 --> <servers> <server> <!-- 发布的位置在POM中配置,以ID为关联,有很多公用的信息需要配置在POM文件里,最佳实践是定义一个公司级别的root pom --> <id>archiva.internal</id> <username>maven</username> <password>1q2w3e4r</password> </server> <server> <id>archiva.snapshots</id> <username>maven</username> <password>1q2w3e4r</password> </server> </servers> </settings>