maven 的 settings.xml 配置详解
2024-01-03 06:03:28
settings.xml 配置详解
<?xml version="1.0" encoding="UTF-8"?>
<settings xmlns="http://maven.apache.org/SETTINGS/1.0.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/SETTINGS/1.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">
<!-- 本地仓库配置,默认为 ${user.home}/.m2/repository -->
<localRepository>D:\maven\repository</localRepository>
<!-- 在pluginGroups元素下面可以定义一系列的pluginGroup元素。
表示当通过plugin的前缀来解析plugin的时候到哪里寻找。
pluginGroup元素指定的是plugin的groupId。默认情况下,Maven会自动把org.apache.maven.plugins
和 org.codehaus.mojo 添加到pluginGroups下。-->
<pluginGroups></pluginGroups>
<!-- 这个属性表示在Maven进行项目编译和部署等操作时是否允许Maven进行联网来下载所需要的信息。
如果构建系统需要在离线模式下运行,则为true,默认为false。
当由于网络设置原因或者安全因素,构建服务器不能连接远程仓库的时候,可使用该配置该配置。-->
<offline>false</offline>
<!-- 用来配置不同的代理。-->
<proxies>
<!--代理元素包含配置代理时需要的信息 -->
<proxy>
<!--代理的唯一定义符,用来区分不同的代理元素。 -->
<!-- <id>my_proxy</id> -->
<!--该代理是否是激活。true则激活代理,当声明了多组代理,
而只需要激活一个代理的时候,使用该元素控制。 -->
<!-- <active>true</active> -->
<!--代理的协议。 协议://主机名:端口,分隔成离散的元素以方便配置。 -->
<!-- <protocol>http</protocol> -->
<!--代理的主机名。协议://主机名:端口,分隔成离散的元素以方便配置。 -->
<!-- <host>proxy.somewhere.com</host> -->
<!--代理的端口。协议://主机名:端口,分隔成离散的元素以方便配置。 -->
<!-- <port>8080</port> -->
<!--代理的用户名,用户名和密码表示代理服务器认证的登录名和密码。 -->
<!-- <username>proxy_user</username> -->
<!--代理的密码,用户名和密码表示代理服务器认证的登录名和密码。 -->
<!-- <password>some_password</password> -->
<!--不该被代理的主机名列表。该列表的分隔符由代理服务器指定;如竖线,或逗号分隔。 -->
<!-- <nonProxyHosts>*.google.com|ibiblio.org</nonProxyHosts> -->
</proxy>
</proxies>
<!-- 当仓库需要认证时,需要配置,server的id需要与repositories保持一致生效。
一般,仓库的下载和部署是在pom.xml文件中的repositories 和 distributionManagement 元素中定义的。
然而,一般类似用户名、密码(有些仓库访问是需要安全认证的)等信息不应该在pom.xml文件中配置,
这些信息可以配置在 settings.xml 中。
-->
<servers>
<server>
<!--这是server的id(注意不是用户登陆的id),
该id与distributionManagement中repository元素的id相匹配。 -->
<id>nexus</id>
<!--鉴权用户名。鉴权用户名和鉴权密码表示服务器认证所需要的登录名和密码。 -->
<username>admin</username>
<!--鉴权密码 。鉴权用户名和鉴权密码表示服务器认证所需要的登录名和密码。密码加密功能已被添加到2.1.0 +。
详情请访问密码加密页面 -->
<password>admin123</password>
<!-- 鉴权时使用的私钥位置。和前两个元素类似,私钥位置和私钥密码指定了一个私钥的路径
(默认是${user.home}/.ssh/id_dsa)以及如果需要的话,一个密语。
将来passphrase和password元素可能会被提取到外部,但目前它们必须在settings.xml文件以纯文本的形式声明。
-->
<!-- <privateKey>${usr.home}/.ssh/id_dsa</privateKey>-->
<!--鉴权时使用的私钥密码。 -->
<!-- <passphrase>some_passphrase</passphrase>-->
<!--文件被创建时的权限。如果在部署的时候会创建一个仓库文件或者目录,这时候就可以使用权限(permission)。
这两个元素合法的值是一个三位数字,其对应了unix文件系统的权限,如664,或者775。 -->
<!-- <filePermissions>664</filePermissions>-->
<!--目录被创建时的权限。 -->
<!-- <directoryPermissions>775</directoryPermissions>-->
</server>
</servers>
<!--
用于定义一系列的远程仓库的镜像。
注意是镜像,而不是“分库”,只有当前一个mirror无法连接的时候,才会去找后一个,类似于备份和容灾。
所以当第一个mirror中不存在a.jar的时候,并不会去第二个mirror中查找,甚至于,
maven根本不会去其他的mirror地址查询。
当有id为B,A,C的顺序的mirror在mirrors节点中,maven会根据字母排序来指定第一个,
所以不管怎么排列,一定会找到A这个mirror来进行查找,当A无法连接,出现意外的情况下,才会去B查询。
-->
<mirrors>
<mirror>
<!-- 该镜像的唯一标识符。id用来区分不同的mirror元素。 -->
<id>aliyunmaven</id>
<!-- 被镜像的服务器的id。例如,如果我们要设置了一个Maven中央仓库
(http://repo.maven.apache.org/maven2/)的镜像,就需要将该元素设置成central。
这必须和中央仓库的id central完全一致。 -->
<mirrorOf>*</mirrorOf>
<!-- 镜像名称 -->
<name>阿里云公共仓库</name>
<!-- 该镜像的URL。构建系统会优先考虑使用该URL,而非使用默认的服务器URL。 -->
<url>https://maven.aliyun.com/repository/public</url>
</mirror>
<mirror>
<id>nexus-163</id>
<mirrorOf>*</mirrorOf>
<name>网易 Nexus 163</name>
<url>http://mirrors.163.com/maven/repository/maven-public/</url>
</mirror>
<mirror>
<id>nexus-tencentyun</id>
<mirrorOf>*</mirrorOf>
<name>Nexus tencentyun</name>
<url>http://mirrors.cloud.tencent.com/nexus/repository/maven-public/</url>
</mirror>
</mirrors>
<!-- 根据环境参数来调整构建配置的列表。
settings.xml 中的 profile 元素是 pom.xml 中 profile 元素的裁剪版本。
它包含了id、activation、repositories、pluginRepositories 和 properties 元素。
这里的profile元素只包含这五个子元素是因为这里只关心构建系统这个整体(这正是settings.xml文件的角色定位),
而非单独的项目对象模型设置。
如果一个settings.xml中的profile被激活,它的值会覆盖任何其它定义在pom.xml中带有相同id的profile。
当所有的约束条件都满足的时候就会激活这个profile。
使用默认激活方式时<activeByDefault>true</activeByDefault>,只有在没有指定其他profile激活时才会生效。
激活的时候,若存在多个激活条件,多个条件是或的关系,即有一个条件满足就可以激活该profile。
-->
<profiles>
<!-- java1.8版本 -->
<profile>
<!-- profile的唯一标识 -->
<id>jdk-1.8</id>
<!-- 自动触发profile的条件逻辑 -->
<activation>
<!-- 当其值为true的时候表示如果没有其他的profile处于激活状态的时候,该profile将自动被激活。-->
<activeByDefault>true</activeByDefault>
<jdk>1.8</jdk>
</activation>
<!-- 扩展属性列表 -->
<!-- 用于定义属性键值对的。当该profile是激活状态的时候,properties下面指定的属性都可以在pom.xml中使用。 -->
<!--如果Maven检测到某一个属性(其值可以在POM中通过${name}引用),
其拥有对应的name = 值,Profile就会被激活。如果值字段是空的,那么存在属性名称字段就会激活profile,
否则按区分大小写方式匹配属性值字段 -->
<properties>
<maven.compiler.source>1.8</maven.compiler.source>
<maven.compiler.target>1.8</maven.compiler.target>
<maven.compiler.compilerVersion>1.8</maven.compiler.compilerVersion>
</properties>
</profile>
<profile>
<id>nexus</id>
<!-- 远程仓库列表 -->
<!-- 用于定义远程仓库的,当该profile是激活状态的时候,这里面定义的远程仓库将作为当前pom的远程仓库。
它是maven用来填充构建系统本地仓库所使用的一组远程仓库。 -->
<repositories>
<!--包含需要连接到远程仓库的信息 -->
<repository>
<!--远程仓库唯一标识 -->
<id>maven-releases</id>
<!--远程仓库名称 -->
<name></name>
<url>http://maven-releases</url>
<!--如何处理远程仓库里发布版本的下载 -->
<releases>
<!--true或者false表示该仓库是否为下载某种类型构件(发布版,快照版)开启。 -->
<enabled>true</enabled>
<!--该元素指定更新发生的频率。Maven会比较本地POM和远程POM的时间戳。
这里的选项是:always(一直),daily(默认,每日),
interval:X(这里X是以分钟为单位的时间间隔),或者never(从不)。 -->
<updatePolicy>always</updatePolicy>
<!--当Maven验证构件校验文件失败时该怎么做-ignore(忽略),fail(失败),或者warn(警告)。 -->
<checksumPolicy>warn</checksumPolicy>
</releases>
<!--如何处理远程仓库里快照版本的下载。有了releases和snapshots这两组配置,POM就可以在每个单独的仓库中,
为每种类型的构件采取不同的策略。
例如,可能有人会决定只为开发目的开启对快照版本下载的支持。参见repositories/repository/releases元素 -->
<snapshots>
<enabled>true</enabled>
</snapshots>
<!--用于定位和排序构件的仓库布局类型-可以是default(默认)或者legacy(遗留)。
Maven 2为其仓库提供了一个默认的布局;然而,Maven 1.x有一种不同的布局。
我们可以使用该元素指定布局是default(默认)还是legacy(遗留)。 -->
<layout>default</layout>
</repository>
<repository>
<id>maven-snapshots</id>
<url>http://nexus-snapshots</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</repository>
</repositories>
<!-- 插件仓库列表,maven插件的仓库从这里下载 -->
<pluginRepositories>
<pluginRepository>
<id>maven-releases</id>
<url>http://nexus-releases</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
<pluginRepository>
<id>maven-snapshots</id>
<url>http://maven-snapshots</url>
<releases>
<enabled>true</enabled>
</releases>
<snapshots>
<enabled>true</enabled>
</snapshots>
</pluginRepository>
</pluginRepositories>
</profile>
</profiles>
<!-- 手动激活profiles的列表,按照profile被应用的顺序定义activeProfile。
该元素包含了一组activeProfile元素,每个activeProfile都含有一个profile id。
任何在activeProfile中定义的profile id,不论环境设置如何,其对应的 profile都会被激活。
如果没有匹配的profile,则什么都不会发生。
例如: env-test是一个activeProfile,则在pom.xml(或者profile.xml)中对应id的profile会被激活。
如果运行过程中找不到这样一个profile,Maven则会像往常一样运行。-->
<activeProfiles>
<!-- 要激活的profile id -->
<activeProfile>nexus</activeProfile>
</activeProfiles>
</settings>
maven 拉取资源的优先顺序
<!--
基本优先级顺序:本地仓库 > settings.xml的profile的仓库 > pom.xml的profile的仓库 > pom.xml的仓库 > 中央仓库
如果仓库的id设置成“central”,则该仓库会覆盖maven默认的中央仓库配置
(这种情况会影响基本优先级,例如在setting.xml中配置了一个仓库,且id为“central”,此时这个仓库覆盖了中央仓库,但是优先级变为小于pom.xml的profile的仓库, 大于pom.xml的仓库)。
如果发现该仓库有镜像设置,则用镜像的地址代替,例如现在进行到要在respository A仓库中查找某个依赖,但A仓库配置了mirror,则会转到从A的mirror中查找该依赖,不会再从A中查找。
如果最终下载不到需要的资源,maven则会报错。
-->
文章来源:https://blog.csdn.net/m0_58660225/article/details/135336633
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。 如若内容造成侵权/违法违规/事实不符,请联系我的编程经验分享网邮箱:veading@qq.com进行投诉反馈,一经查实,立即删除!
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。 如若内容造成侵权/违法违规/事实不符,请联系我的编程经验分享网邮箱:veading@qq.com进行投诉反馈,一经查实,立即删除!