标签：xml maven 配置文件 Maven setting profile 激活

前言

maven官网：

Maven – Welcome to Apache Maven

菜鸟教程：

Maven 教程 | 菜鸟教程 (runoob.com)

Maven仓库：

Maven Repository: Search/Browse/Explore (mvnrepository.com)

  本机使用的Maven 版本：apache-maven-3.6.0 JDK1.8 镜像仓库：如果仓库 X 可以提供仓库 Y 存储的所有的内容，那么仓库 X 就可以说是 仓库 Y 的镜像(也就是说能从仓库 Y 获取的内容，从仓库 X 也能获取) maven的setting.xml文件一般会存在两个地方： 1. 在maven安装目录（全局）：apache-maven-3.6.0/conf/setting.xml  2. 在用户安装目录下（当前用户下）：${user.home}\.m2\settings.xml 。 配置文件这里对于本地IDEA开发会遇到一个坑，留给大家吧   属性解析   setting

<setting>setting 文件的根元素</setting>

  localRepository

<localRepository>本地仓库</localRepository>
<!-- 该属性一般需要自己设置
     不设置的话，本地仓库默认地址为-->
<localRepository>usr/.m2/repository</localRepository>

 

interactiveMode

<interactiveMode>Maven 是否与用户交互</interactiveMode>
<!-- 该属性一般按照默认配置(设置为 true )
     设置为 false 时，Maven 会基于一些其他设置参数，配置一个默认值-->
<interactiveMode>true</interactiveMode>

  offline

<offline>离线模式</offline>
<!-- 该属性一般按照默认设置(设置为 false)
     该属性值 Maven 构建时是否连接网络，会产生 jar 包下载、部署及其他错误影响-->
<offline>false</offline>

  pluginGroups

<pluginGroups>插件组</pluginGroups>

 

proxies

<!-- 
    | 代理主机信息
    | 当公司网络与公网隔离，需要代理主机才能访问公网时，需要设置该属性 
-->
<proxies>
    <proxy>
      <!-- (自定义id名称即可) -->
      <id>optional</id>
      <!-- (是否激活该代理) -->
      <active>true</active>
      <!-- (使用的代理协议) -->
      <protocol>http</protocol>
      <!-- (用户名) -->  
      <username>proxyuser</username>
      <!-- (密码) -->
      <password>proxypass</password>
      <!-- (代理服务器地址) -->
      <host>proxy.host.net</host>
      <!-- (代理服务器端口) -->
      <port>80</port>
      <!-- (指定那些主机地址不需要代理)
          | 支持 “ | ” 分隔多个主机地址 
        | 支持 “ * ” 适配符 例如 *.baidu.com 表示所有以 baidu.com 结尾的主机地址,都不会走代理
      -->
      <nonProxyHosts>local.net|some.host.com</nonProxyHosts>
    </proxy>
</proxies>
<!-- 
     | 支持配置多个 proxy ，默认是第一个 proxy 配置生效
-->

 

servers

<!-- 
    | 仓库/镜像仓库的认证信息
-->
<servers>
     <server>   
      <!-- (自定义id名称) 
          | id 属性，需要与下面讲述的 mirror 、profile 属性中的 id 保持一致
      -->
      <id>deploymentRepo</id>
      <!-- (用户名) -->
      <username>repouser</username>
      <!-- (密码) -->
      <password>repopwd</password>
    </server>
</servers>

 

mirrors

<!--
    | 镜像仓库
-->
<mirrors>
    <mirror>
      <!-- (自定义id名称) -->
      <id>mirrorId</id>
      <!-- (镜像仓库匹配范围) 
        | “ * ”表示匹配所有远程仓库，任何对远程仓库的请求，都会转到该镜像地址下
        | “ external:* ”表示匹配所有远程仓库(localhost、file://协议、这两种除外)即匹配不在本机上的所有远程仓库
        | “ repo1,repo2 ”表示匹配 repo1、repo2 两个远程仓库，可以使用逗号分隔多个远程仓库
        | “ *,!repo1”表示匹配所有远程仓库，但是 repo1 远程仓库除外          
      -->
      <mirrorOf>repositoryId</mirrorOf>
      <!-- (镜像名称) -->
      <name>Human Readable Name for this Mirror.</name>
      <!-- (镜像地址) -->
      <url>http://my.repository.com/repo/path</url>
    </mirror>
</mirrors>
<!--    
    | 镜像仓库的常用方式：结合私服使用
        | 说明：因为私服，可以代理任何外部公共仓库，那么，可以使用一个私服地址，代理所有需要的外部公共仓库，简化 Maven 的配置。
               这种情况下，私服可以说所有需要的外部公共仓库的镜像；    
    | 如果镜像需要认证信息，同样是在 servers 中增加 server 信息
    | 镜像仓库完全屏蔽了被镜像仓库，当镜像仓库不稳定或停止服务的时候，Maven 将无法方位被镜像仓库，因为无法下载内容
-->

 

profiles

<!-- 
    | 配置文件列表
    | 不同环境的构建大概率是不同的，比如数据库配置、使用特殊版本的依赖、配置插件使用本地文件，为了让构建能在不同环境移植，Maven 引入 Profile 
-->
<profiles>
    <profile>
        <!-- (自定义id名称) -->
        <id>nexus</id> 
        <repositories> 
          <repository> 
            <id>nexus</id>
            <!-- (自定义资源名称) -->
            <name>Nexus</name>
            <!-- 仓库地址 -->
            <url>http://100.4.252.5:18080/nexus/content/groups/public</url>
            <releases>
                <!-- 是否允许该仓库为构件提供 发布版 / 快照版 下载功能 -->
                <enabled>true</enabled>
                <!-- 每次执行构建命令时, Maven 会比较本地 POM 和远程 POM 的时间戳, 该元素指定比较的频率 
                    | always（每次构建都检查）
                    | daily（默认, 距上次构建检查时间超过一天）
                    | interval: x（距上次构建检查超过 x 分钟）
                    | never（从不）
                -->
                <updatePolicy>daily</updatePolicy>
                <!-- 当 Maven 验证构件的校验文件失败时该怎么做: ignore（忽略）, fail（失败）, 或者warn（警告）-->
                <checksumPolicy>warn</checksumPolicy>  
            </releases> 
            <snapshots>
                <!-- 参照 releases -->
                <enabled>true</enabled>  
                <updatePolicy>daily</updatePolicy>
                <checksumPolicy>warn</checksumPolicy>  
            </snapshots>
          </repository>
        </repositories> 
        <pluginRepositories> 
          <pluginRepository> 
            <id>nexus</id> 
            <name>Nexus</name>
            <!-- 仓库地址 -->
            <url>http://100.4.252.5:18080/nexus/content/groups/public</url>
            <!-- (发布版本的插件) -->
            <releases><enabled>true</enabled></releases> 
            <!--(快照版本的插件) -->
            <snapshots><enabled>true</enabled></snapshots> 
          </pluginRepository> 
        </pluginRepositories> 
    </profile>
</profiles>
<!-- 
     | profile 激活
        | 通过命令行激活：用户使用 mvn 命令行参数 -P 加上 profile 的id 来激活 profile，多个通过逗号分隔
        | setting.xml 配置文件显式激活：使用 activeProfiles 属性，表示 setting.xml 中的 profile 在所有项目中激活(下面会讲)
        | 系统属性激活
-->

 

profile 种类 1、pom.xml: pom 文件的 profile 只对当前项目生效 2、用户setting.xml: 用户目录下/.m2/setting.xml 文件中的 profile 只对本机该用户所有的 Maven 项目生效 3、全局setting.xml: Maven 安装目录下的 setting.xml 文件中的 profile 对本机所有的 Maven 项目生效 4、profiles.xml (Maven 2) 还可以在项目根目录下使用一个额外的 profiles.xml 声明，该特性在 Maven 3 中移除，建议将 profiles 添加到 setting.xml 中   profile激活 1、通过命令行激活：用户使用 mvn 命令行参数 -P 加上 profile 的id 来激活 profile，多个通过逗号分隔

mvn clean -Pdev-x,dev-y

 

2、setting.xml 配置文件显式激活：使用 activeProfiles 属性，表示 setting.xml 中的 profile 在所有项目中激活

<activeProfiles> 
     <activeProfile>nexus</activeProfile>  
 </activeProfiles>

 

3、系统属性激活：用户可以配置系统属性 test 存在时，自动激活 profile ，如下面第一个示例；用户可以配置系统属性存在，且系统属性值时，自动激活profile，如下面第二个示例

<!-- 第一个示例 -->
<profiles>
    <profile>
        <activeprofile>
            <property>
                <name>test</name>
            </property>
        </activeprofile>
    </profile>
</profiles>

<!-- 第二个示例 -->
<profiles>
    <profile>
        <activeprofile>
            <property>
                <name>test</name>
                <value>x</value>
            </property>
        </activeprofile>
    </profile>
</profiles>

<!-- 一定要记得，也是可以通过命令行声明系统属性激活 -->
mvn clean -Ptest=x

 

4、操作系统环境激活：profile 可以根据不同操作系统环境自动激活，如果构建在不同操作系统环境且有差异，可以把这些差异写进 profile

<profiles>
    <profile>
        <activeprofile>
            <os>
                <name>Window XP</name>
                <family>Window</value>
                <arch>X86</arch>
            </os>
        </activeprofile>
    </profile>
</profiles>

 

5、文件是否存在激活：Maven 能够根据项目中某个文件是否存在来决定是否激活 profile

<profiles>
    <profile>
        <activeprofile>
            <file>
                <missing>y.properties</name>
                <exists>x.properties</value>
            </file>
        </activeprofile>
    </profile>
</profiles>

 

activeprofile

<!-- 使用 activeProfiles 属性，表示 setting.xml 中的 profile 在所有项目中激活 -->
<activeProfiles>
    <activeProfile>central(id 需要与 profile 中的 id 保持一致)</activeProfile>
</activeProfiles>

 

补充国内常用的几个镜像地址-供本地开发学习使用：

    <mirrors>
        <mirror>
            <id>alimaven</id>
            <name>aliyun maven</name>
            <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
            <mirrorOf>central</mirrorOf>
        </mirror>
        <mirror>
            <id>alisnapshots</id>
            <name>Ali OSS snapshots</name>
            <mirrorOf>central</mirrorOf>
            <url>https://oss.sonatype.org/content/repositories/snapshots</url>
        </mirror>
        <mirror>
            <id>alirelase</id>
            <name>Ali OSS release</name>
            <mirrorOf>central</mirrorOf>
            <url>https://oss.sonatype.org/content/repositories/releases</url>
        </mirror>
        <mirror>
            <id>central</id>
            <name>Maven Repository Switchboard</name>
            <url>http://repo1.maven.org/maven2/</url>
            <mirrorOf>central</mirrorOf>
        </mirror>
        <mirror>
            <id>repo2</id>
            <mirrorOf>central</mirrorOf>
            <name>Human Readable Name for this Mirror.</name>
            <url>http://repo2.maven.org/maven2/</url>
        </mirror>
    </mirrors>

 

标签：xml,maven,配置文件,Maven,setting,profile,激活
来源： https://www.cnblogs.com/chch213/p/16304029.html

本站声明： 1. iCode9 技术分享网（下文简称本站）提供的所有内容，仅供技术学习、探讨和分享；
2. 关于本站的所有留言、评论、转载及引用，纯属内容发起人的个人观点，与本站观点和立场无关；
3. 关于本站的所有言论和文字，纯属内容发起人的个人观点，与本站观点和立场无关；
4. 本站文章均是网友提供，不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属；如您发现该文章侵犯了您的权益，可联系我们第一时间进行删除；
5. 本站为非盈利性的个人网站，所有内容不会用来进行牟利，也不会利用任何形式的广告来间接获益，纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。