maven 的 settings.xml 配置详解

发布时间:2024年01月02日

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
本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。