maven的l配置详解
maven的l⽂件⼀般会存在两个地⽅:
1. 在maven安装⽬录(全局):…/l
2. 在⽤户安装⽬录下(当前⽤户下):${user.home}.l演员邬倩倩
当两者都存在,它们的内容将被合并,特定于⽤户的l⽂件占主导地位。
1. l⽂件模板
<settings xmlns="/SETTINGS/1.1.0" xmlns:xsi="/2001/XMLSchema-instance"
xsi:schemaLocation="/SETTINGS/1.1.0 /xsd/settings-1.1.0.xsd">
<!-- 本地仓库地址,默认是${user.home}/.m2/repository,也可为⾃⼰创建的本地仓库路径-->
<localRepository></localRepository>
陈法蓉个人资料<!-- Maven是否需要和⽤户交互以获得输⼊,默认是true -->
<interactiveMode></interactiveMode>
<!-- Maven是否应该使⽤l⽂件来管理插件版本。默认是false -->
<usePluginRegistry></usePluginRegistry>
<!-- maven是否以离线的模式进⾏项⽬构建,在⽹络异常,或⽆⽹络⽆法连接远程仓库的时候可使⽤离线模式,默认是false -->
<offline/>
<!-- 为不同的代理配置⽂件进⾏配置。对于在笔记本或其他移动平台上⼯作的⼈来说,多个代理配置⽂件可能⾮常⽅便,可以通过简单地指定配置⽂件id来轻松切换整个代理配置⽂件,同样可以从命令⾏或从下⾯的默认部分进⾏。 -->
<proxies>
<!-- 包含代理设置所需的信息,可存在多个代理-->
<proxy>
<!-- 此代理配置是否为激活的,如果存在多个代理,默认是第⼀个<proxy>⽣效,当然,我们可根据需要激活对应的代理,将其active设为true -->
<active></active>
<!-- 代理协议,默认使⽤http协议  -->
<protocol></protocol>
<!-- 代理服务器的登录⽤户名 -->
<username></username>
<!-- 代理服务器的登录密码 -->
<password></password>
<!-- 代理主机端⼝ -->
<port></port>
<!-- 代理主机,域名或ip -->
<host></host>
<!-- 不需要进⾏代理的主机列表,可使⽤ | 符号来分隔多个主机名。同时,该配置⽀持通配符,如*.XXX表⽰所有以XXX结尾的域名访问都不要通过代理。 -->
<nonProxyHosts></nonProxyHosts>
<!-- 代理的唯⼀标记符,可区分不同的代理 -->
<id></id>
</proxy>
</proxies>
<!-- 配置权限,如私库的⽤户名,密码,对应l⽂件的 distributionManagement  -->
<servers>
<!-- 包含配置服务器时需要的信息 -->
<server>
<!-- ⾝份校验的⽤户名 -->
<username></username>
<!-- ⾝份校验的密码 -->
<password></password>
<!-- 存放⾝份校验私钥的地址,默认是${user.home}/.ssh/id_dsa) -->
<privateKey></privateKey>
<!-- 私钥的密码 -->
<passphrase></xpassphrasex>
<!-- ⽂件创建时的权限,在部署的时候会创建⼀个存在权限的仓库⽂件,合法的值是⼀个三位数字,其对应了unix⽂件系统的权限,如664,或者775。 -->      <filePermissions></filePermissions>
<!-- ⽂件创建时的权限,在部署的时候会创建⼀个存在权限的仓库⽂件,合法的值是⼀个三位数字,其对应了unix⽂件系统的权限,如664,或者775。 -->      <directoryPermissions></directoryPermissions>
<!-- 传输层的额外配置 -->
<configuration></configuration>
<!--这是server的id,该id与l⽂件中的distributionManagement的repository元素的id相匹配。-->
<!--这是server的id,该id与l⽂件中的distributionManagement的repository元素的id相匹配。-->
<id></id>
</server>
</servers>
<!-- 仓库列表配置的下载镜像列表。 -->
<mirrors>
<!-- 给定仓库的下载镜像。 -->
<mirror>
<!-- 被镜像的服务器的id, 例如maven的中央仓库的服务器id为central,所以,该字段需要设为central -->
<mirrorOf></mirrorOf>
<!--镜像名称 -->
<name></name>
<!--该镜像的URL。构建系统会优先考虑使⽤该URL,⽽⾮使⽤默认的服务器URL。-->
<url></url>
<!-- 镜像仓库的布局,从maven3开始有的配置,默认值是default -->
<layout></layout>
<!-- 被镜像的存储库的布局。此值可⽤于将镜像的使⽤限制为具有匹配布局的存储库(除了匹配id之外)。默认值为default,legacy-->
<mirrorOfLayouts/>
<!-- 该镜像的唯⼀标识符。id⽤来区分不同的mirror元素 -->
<id></id>
</mirror>
</mirrors>
<!-- 根据环境参数来调整构建配置的列表。
它包含了id,activation, repositories, pluginRepositories和 properties元素。
这⾥的profile元素只包含这五个⼦元素是因为这⾥只关⼼构建系统这个整体
(这正是l⽂件的⾓⾊定位),⽽⾮单独的项⽬对象模型设置。
若settings中的profile被激活,
它的值会覆盖任何其它定义在POM中或者l中的带有相同id的profile。 -->
<profiles>
<profile>
<!-- 能⾃动触发profile的条件逻辑。如POM中的profile⼀样,profile的⼒量来⾃于它能够在某些特定的环境中⾃动使⽤某些特定的值;这些环境通过activation 元素指定。activation元素并不是激活profile的唯⼀⽅式。l⽂件中的activeProfile元素可以包含profile的id。profile也可以通过在命令⾏,使⽤-P标记和逗号分隔的列表来显式的激活(如,-P test) -->
<activation>
<!-- profile默认是否激活的标识,默认值为false -->
<activeByDefault></activeByDefault>
<!--指定当检测到匹配的JDK时将激活此配置⽂件。例如,1.8激活所有为1.8版本的JDK,⽽!1.8激活所有版本不是以1.8开头的JDK。-->
<jdk></jdk>
<!-- 指定当检测到匹配的操作系统属性时将激活此配置⽂件。os元素可以定义⼀些操作系统相关的属性 -->
<os>
<!--激活profile的操作系统 -->
<name>Windows 10</name>
<!--激活profile的操作系统所属家族(如 'windows')  -->
<family>Windows</family>
<!--激活profile的操作系统体系结构  -->
<arch>x86</arch>
<!--激活profile的操作系统版本-->
<version>5.1.2600</version>
</os>
<!--如果Maven检测到某⼀个属性(其值可以在POM中通过${name}引⽤),其拥有对应的name = 值,Profile就会被激活。如果值字段是空的,那么存在属性名称字段就会激活profile,否则按区分⼤⼩写⽅式匹配属性值字段-->
<property>
<!--激活profile的属性的名称-->
<name>mavenVersion</name>
<!--激活profile的属性的值 -->
<value>2.0.3</value>
</property>
<!--提供⼀个⽂件名,通过检测该⽂件的存在或不存在来激活profile。missing检查⽂件是否存在,如果不存在则激活profile。另⼀⽅⾯,exists则会检查⽂件是否存在,如果存在则激活profile。-->
<file>
<!--如果指定的⽂件存在,则激活profile。 -->
<exists>${basedir}/file2.properties</exists>
<exists>${basedir}/file2.properties</exists>
李湘和王岳伦
<!--如果指定的⽂件不存在,则激活profile。-->
<missing>${basedir}/file1.properties</missing>
</file>
</activation>
<!--
对应profile的扩展属性列表。Maven属性和Ant中的属性⼀样,可以⽤来存放⼀些值。
这些值可以在POM中的任何地⽅使⽤标记${X}来使⽤,这⾥X是指属性的名称。
属性有五种不同的形式,并且都能在l⽂件中访问。
1. env.X: 在⼀个变量前加上"env."的前缀,会返回⼀个shell环境变量。
如,"env.PATH"指代了$path环境变量(在Windows上是%PATH%)。
2. project.x:指代了POM中对应的元素值。
如: <project><version>1.0</version></project>
通过${project.version}获得version的值。
3. settings.x: 指代了l中对应元素的值。
如:<settings><offline>false</offline></settings>
车险保险险种通过 ${settings.offline}获得offline的值。
4. Java System Properties:
所有可通过java.Properties()访问的属性都能在POM中使⽤该形式访问。如 ${java.home}。
5. x: 在<properties/>元素中,或者外部⽂件中设置,以${someVar}的形式使⽤。
-->
<properties>
<!-- note:如果该profile被激活,则可以再POM中使⽤${user.install} -->
<user.install>${user.home}/our-project</user.install>
</properties>
<!--远程仓库列表,包含与远程存储库建⽴连接所需的信息。 -->
<repositories>
<repository>
<!--如何处理远程仓库⾥发布版本的下载-->
<releases>
<!-- true或者false表⽰是否使⽤该仓库下载某种类型构件(发布版,快照版)开启 -->
<enabled>false</enabled>
<!--更新发⽣的频率。Maven会⽐较本地POM和远程POM的时间戳。这⾥的选项是:always(⼀直),daily(默认,每⽇),interval:X(这⾥X是以分钟为单位的时间间隔),或者never(从不,仅在本地不存在时)。 -->
<updatePolicy>always</updatePolicy>
<!--当Maven验证构件校验⽂件失败时该怎么做-ignore(忽略),fail(失败),或者warn(警告)。-->黄河精神
<checksumPolicy>warn</checksumPolicy>
</releases>
<!--如何处理远程仓库⾥快照版本的下载。有了releases和snapshots这两组配置,POM就可以在每个单独的仓库中,为每种类型的构件采取不同的策略。例如,可能有⼈会决定只为开发⽬的开启对快照版本下载的⽀持-->
<snapshots>
<!-- true或者false表⽰是否使⽤该仓库下载某种类型构件(发布版,快照版)开启 -->
<enabled>true</enabled>
<!-- 同上 -->
<updatePolicy>always</updatePolicy>
<!-- 同上 -->
<checksumPolicy>warn</checksumPolicy>
</snapshots>
<!--远程仓库唯⼀标识-->
<id></id>
<!--远程仓库名称 -->
<name></name>
<!--远程仓库URL,按protocol://hostname/path形式 -->
<url></url>
<!--⽤于定位和排序构件的仓库布局类型-可以是default(默认)或者legacy(遗留)。Maven 2为其仓库提供了⼀个默认的布局;然⽽,Maven 1.x有⼀种不同的布局。我们可以使⽤该元素指定布局是default(默认)还是legacy(遗留)。 -->
<layout>default</layout>
</repository>
</repositories>
<!--发现插件的远程仓库列表。仓库是两种主要构件的家。第⼀种构件被⽤作其它构件的依赖。这是中央仓库中存储的⼤部分构件类型。另外⼀种构件类型是插件。Maven插件是⼀种特殊类型的构件。由于这个原因,插件仓库独⽴于其它仓库。pluginRepositories元素的结构和repositories元素的结构类似。每个pl uginRepository元素指定⼀个Maven可以⽤来寻新插件的远程地址。-->
<pluginRepositories>
<!-- 内部元素配置与依赖类型构件的配置⼀样 -->
<pluginRepository>
<releases>
<releases>
<enabled>true</enabled>
<updatePolicy>always</updatePolicy>
<checksumPolicy>warn</checksumPolicy>
</releases>
<snapshots>
<enabled>true</enabled>
<updatePolicy>always</updatePolicy>
<checksumPolicy>warn</checksumPolicy>
</snapshots>
农村电影大全<id></id>
<name></name>
<url></url>
<layout>default</layout>
</pluginRepository>
</pluginRepositories>
<!--该配置的唯⼀标识符。 -->
<id></id>
</profile>
</profiles>
<!--⼿动激活profiles的列表,按照profile被应⽤的顺序定义activeProfile。该元素包含了⼀组activeProfile元素,每个activeProfile都含有⼀个profile id。任何在activeProfile中定义的profile id,不论环境设置如何,其对应的
profile都会被激活。如果没有匹配的profile,则什么都不会发⽣。例如,env-test是⼀个activeProfile,则在l(或者l)中对应id的profile 会被激活。如果运⾏过程中不到这样⼀个profile,Maven则会像往常⼀样运⾏。 -->
<activeProfiles>
<activeProfile>env-test</activeProfile>
</activeProfiles>
<!-- 当插件groupId没有显式提供时,⽤于搜索插件的groupId列表。 -->
<pluginGroups></pluginGroups>
</settings>
阿⾥云镜像
<mirror>
<id>alimaven</id>
<name>aliyun maven</name>
<url>maven.aliyun/nexus/content/groups/public/</url>
<!-- maven 中央仓库服务器id -->
<mirrorOf>central</mirrorOf>
</mirror>