本文共 6605 字,大约阅读时间需要 22 分钟。
Maven的settings.xml配置了Maven执行的方式,像pom.xml一样,但是它是一个通用的配置,
不能绑定到任何特殊的项目。它通常包括本地仓库地址,远程仓库服务,认证信息等。settings.xml存在于两个位置:
/conf/settings.xml
/.m2/settings.xml
maven目录下的称为全局配置,用户目录下的称为用户配置。如果两个配置都存在,它们的内容将合并,有冲突的以用户配置优先。
通常情况下,用户目录下的/.m2/settings.xml
是不存在的,如果你需要,可以从maven目录下的/conf/settings.xml
复制过来。maven的默认settings模板中,包含了所有的配置的例子,它们都被注释掉了,如果你需要,可以打开注释,配置你自己的信息。 下面是settings文件的顶层元素:
settings文件中的内容可以使用插值替换,例如:
${user.home}
或者其他的系统属性(3.0以上)${env.HOME}
等环境变量注意:profile中定义的properties不能使用插值
settings文件中,顶层元素中的一半以上都是简单值。接下来让我们看一看吧。
${user.home}/.m2/repository true false false ...
${user.home}/.m2/repository
。它允许所有的用户从这个公共的本地仓库构建系统。${user.home}/.m2/plugin-registry.xml
管理插件版本。从2.0以后,我们是不需要使用这个属性的,可以认为它废弃了。pluginGroups
包含了一组pluginGroup
元素,每一个都包含一个groupId
。当你在命令行使用插件,没有提供groupId
时,maven将搜索这个列表。
org.apache.maven.plugins
和org.codehaus.mojo
。 ... ... org.mortbay.jetty
例如:我们执行org.mortbay.jetty:jetty-maven-plugin:run
时,可以使用短命令:mvn jetty:run
。
下载和部署的仓库通常在pom.xml
中的repositories
和distributionManagement
元素中定义,但是像username
和password
时不应该在
... ... server001 my_login my_password ${user.home}/.ssh/id_dsa some_passphrase 664 775
当使用私钥文件的时候,不要使用password
,要使用passphrase
。
... ... planetmirror.com PlanetMirror Australia http://downloads.planetmirror.com/pub/maven2 central
<servers>
中配置的id一致。center
。也可以使用一些高级的语法:repo1,repo2
或 *,!inhouse
。... ... myproxy true http proxy.somewhere.com 8080 proxyuser somepassword *.google.com|ibiblio.org
protocol://host:port
,分隔成了多个元素。镜像和代理的区别:镜像:改变原始的仓库地址;代理:有些公司是不能上网的,他们需要配置代理才能访问外网。
settings.xml
文件中的profile
是pom.xml
中的删减版。它由activation
, repositories
, pluginRepositories
和 properties
组成。
如果settings中的profile是有效的,它将覆盖掉pom中的相同id的profile。
它是profile中的一个元素,会在满足activation
的条件时,激活状态。
... ... test ... false 1.5 Windows XP Windows x86 5.1.2600 mavenVersion 2.0.3 ${basedir}/file2.properties ${basedir}/file1.properties
当activation
的条件满足时,该profile将激活。
activation
有一个内嵌的,在jdk元素中已java为中心的检查。当jdk的版本与配置的版本前缀匹配时,这个profile将被激活。上面的例子中,jdk的版本1.5.0_06将匹配。范围配置也是可以的,这里不做详细介绍了。activation不是profile激活的唯一方式,settings.xml
文件中的activeProfile
元素包含了一个profile的id,可以同过命令行指定这个id来
maven的属性是一个占位符,它可以在pom文件中,通过${X}进行访问,X是属性的名称。它们有5中不同的形式:
env.X
:前缀是一个env,它将返回系统的环境变量。例如:${env.PATH}
将返回系统的环境变量$path。project.x
:访问pom嗯我那件,点(.)在pom中代表层级的分隔。例如:<project><version>1.0</version></project>
可以通过${project.version}
访问。settings.x
:同上,只是访问的是settings文件。例如:<settings><offline>false</offline></settings>
可以通过${settings.offline}
访问。java.lang.System.getProperties()
可以访问到的属性,在pom文件中都可以访问。例如:${java.home}
。x
:<properties>
元素里配置的属性。通过${someVal}
访问。... ... ... ... ${user.home}/our-project
上面的例子中,如果profile被激活,在pom中可以访问${user.install}
。
Repositories在这里不是本地仓库的意思,而是远程仓库的集合。它在本地仓库配置,maven通过它从远程下载插件或者依赖。
不同的仓库包含不同的项目,在激活的profile下,它们能被搜索到。... ... ... codehausSnapshots Codehaus Snapshots false always warn true never fail http://snapshots.maven.codehaus.org/maven2 default ... ...
always
、daily
(默认)、interval:X
(X是分钟)、never
。ignore
, fail
, 或 warn
,在checksum丢失或不正确的情况下执行。default
或 legacy
。仓库有两种主要的类型。第一种是工件作为依赖,常说的jar包依赖。第二种是插件,maven的插件是一种特殊类型的工件,正因如此,maven把插件类型的仓库
单独提了出来。pluginRepositories
的元素和repositories
的元素非常的相似,它指定一个远程插件仓库的地址,可以在那里找到相应的maven插件。 ... env-test
activeProfiles
元素包含了activeProfile
元素的集合,activeProfile
有一个profile的id值。在activeProfile
里定义的id都将被激活。
好了,maven的settings.xml就为大家介绍的这里,有疑问可以随时评论、留言。接下来还会介绍maven的pom.xml。
转载地址:http://xrsxx.baihongyu.com/