激活Maven profile的几种方式

首先简单介绍下 Maven 的 profile 是什么。对于人来说，profile 是指人的肖像，轮廓，比如论坛里每个人注册了帐号后，可以设置自己的 profile，放上照片，介绍等等。对于 Maven 来说又是怎样呢？整个项目定义好了项目对象模型（POM），就像论坛为每个人提供了默认的行为功能，如果我想改变我机器上的 POM 呢？这时就可以使用 profile。下面举个例子：

  <profiles>
    <profile>
      <id>jdk16</id>
      <activation>
        <jdk>1.6</jdk>
      </activation>
      <modules>
        <module>simple-script</module>
      </modules>
    </profile>
  </profiles>

这个 profile 的意思是，当机器上的 JDK 为1.6的时候，构建 simple-script 这个子模块，如果是1.5或者1.4，那就不构建，这个 profile 是由环境自动激活的。

 

我们需要在合适的地方使用合适的 profile ，并且在合适的时候用合适的方式将其激活，你不能在构建服务器上激活非公共的 profile，你也不能要求开发人员写很复杂的命令来使用常规的 profile。因此这里介绍一下几种 profile 的激活方式。

 

1. 根据环境自动激活。

如前一个例子，当 JDK 为1.6的时候，Maven 就会自动构建 simple-script 模块。除了 JDK 之外，我们还可以根据操作系统参数和 Maven 属性等来自动激活 profile，如：

    <profile>
      <id>dev</id>
      <activation>
        <activeByDefault>false</activeByDefault>
        <jdk>1.5</jdk>
        <os>
          <name>Windows XP</name>
          <family>Windows</family>
          <arch>x86</arch>
          <version>5.1.2600</version>
        </os>
        <property>
          <name>mavenVersion</name>
          <value>2.0.5</value>
        </property>
        <file>
          <exists>file2.properties</exists>
          <missing>file1.properties</missing>
        </file>
      </activation>
      ...
    </profile>

2. 通过命令行参数激活。

这是最直接和最简单的方式，比如你定义了一个名为 myProfile 的 profile，你只需要在命令行输入 mvn clean install -Pmyprofile 就能将其激活，这种方式的好处很明显，但是有一个很大的弊端，当 profile 比较多的时候，在命令行输入这写 -P 参数会让人觉得厌烦，所以，如果你一直用这种方式，觉得厌烦了，可以考虑使用其它自动激活的方式。

 

3. 配置默认自动激活。

方法很简单，在配置 profile 的时候加上一条属性就可以了，如：

    <profile>
      <id>dev</id>
      <activation>
        <activeByDefault>true</activeByDefault>
      </activation>
      ...
    </profile>

在一个特殊的环境下，配置默认自动激活的 profile 覆盖默认的 POM 配置，非常简单有效。

 

4. 配置 settings.xml 文件 profile 激活。

settings.xml 文件可以在 ~/.m2 目录下，为某个用户的自定义行为服务，也可以在 M2_HOME/conf 目录下，为整台机器的所有用户服务。而前者的配置会覆盖后者。同理，由 settings.xml 激活的 profile 意在为用户或者整个机器提供特定环境配置，比如，你可以在某台机器上配置一个指向本地数据库 URL 的 profile，然后使用该机器的 settings.xml 激活它。激活方式如下：

<settings>
  ...
  <activeProfiles>
    <activeProfile>local_db</activeProfile>
  </activeProfiles>
</settings>

 

Maven 提供的 profile 功能非常强大和灵活，用得好的话，可以有效的隔离很多特殊的配置，使得整个项目能在不同环境中顺利的构建。但是，强大和灵活带来得问题是相对难掌握，希望本文能对 Maven 使用者有帮助。

评论

13 楼 wuliupo 2014-03-12  

zyp731 写道

两个问题：
1：多个profile,如何执行？
   mvn clean install -P id1
这种方式不行啊。

2：通过属性去激活，这些属性我从哪里去取得呢？
我在服务器上执行uname -a,显示如下内容。
Linux rel_usf.nhncorp.cn 2.6.9-78.ELsmp #1 SMP Fri Jul 25 00:04:28 EDT 2008 i686 i686 i386 GNU/Linux

我该怎么添写那些属性啊，呵呵！！

mvn clean install -Pid1,id2,id3

12 楼 hhh099074082 2013-11-22  

              
                <profile>
<id>jdk17</id>
<activation>
<jdk>1.6</jdk>
</activation>
<modules>
<module>simple-webapp</module>
</modules>
</profile>

你好，这是我的配置文件激活部分，怎么没效果？设置任何的版本的JDK都能激活simple-webapp模块？？？

11 楼 hasayaqi 2012-08-10  

您好！
   我在apache的jetspeed的pom文件中，发现有这样的结构：

profile/build/plugins/plugin

请问这里出现的build怎么理解？

10 楼 juvenshun 2009-12-22  

kingxip 写道

有几个问题，maven中文论坛访问不了，我就这里请教了吧：
1) mvn install代表什么？ 他将项目所依赖的artifact安装到本地仓库，那么在项目中定义的那些module有关系吗？我的意思是他在install这个周期是怎么讲一个一个的artifact装进去的
2） profile，这个profile如果重复了会怎么样？就是说一个多项目模块中，如果定义了多个相同名称的profile

说实话我没看懂你的问题，这里只能尽量回答了。
1) 我猜测你指的是多模块项目，maven构建多模块项目时，会根据依赖关系和继承关系计算反应堆(reactor)顺序，然后根据这个顺序执行你从命令行输入的mvn install命令，因此，每个模块会依次被安装到本地仓库中，至于反应堆顺序是什么，你可以查看构建输出。
2) 对于单个POM来说，不可能定义两个相同ID的profile（maven会报错），对于多模块项目中的两个模块，使用同样ID的profile不产生任何冲突（作用范围不一样），如果一个profile在父模块定义，而子模块有一个profile使用同样的ID，那么子模块定义的profile会覆盖父模块定义的profile。

PS：google讨论组被墙了，但是目前仍然可以使用邮件列表功能，发邮件至[e-mail]即可。当然，前提是你已经是其成员。

9 楼 kingxip 2009-12-22  

有几个问题，maven中文论坛访问不了，我就这里请教了吧：
1) mvn install代表什么？ 他将项目所依赖的artifact安装到本地仓库，那么在项目中定义的那些module有关系吗？我的意思是他在install这个周期是怎么讲一个一个的artifact装进去的
2） profile，这个profile如果重复了会怎么样？就是说一个多项目模块中，如果定义了多个相同名称的profile

8 楼 juvenshun 2009-12-21  

phoenixup 写道

引用

3. 配置默认自动激活。
方法很简单，在配置 profile 的时候加上一条属性就可以了，如：

    <profile>
      <id>dev</id>
      <activation>
        <activeByDefault>[color=red][size=medium]true[/size][/color]</activeByDefault>
      </activation>
      ...
    </profile>

貌似默认激活为true~~

已修复，谢谢

7 楼 phoenixup 2009-12-21  

引用

3. 配置默认自动激活。
方法很简单，在配置 profile 的时候加上一条属性就可以了，如：

    <profile>
      <id>dev</id>
      <activation>
        <activeByDefault>[color=red][size=medium]true[/size][/color]</activeByDefault>
      </activation>
      ...
    </profile>

貌似默认激活为true~~

6 楼 releasa 2009-10-09  

不错，我很喜欢。需要细细体会。。

5 楼 juvenshun 2009-03-10  

nbaertuo 写道

mvn -P equinox,it clean install 同时执行equinox和it两个profile

谢谢补充！

4 楼 nbaertuo 2009-03-10  

mvn -P equinox,it clean install 同时执行equinox和it两个profile

3 楼 zyp731 2008-10-30  

两个问题：
1：多个profile,如何执行？
   mvn clean install -P id1
这种方式不行啊。

2：通过属性去激活，这些属性我从哪里去取得呢？
我在服务器上执行uname -a,显示如下内容。
Linux rel_usf.nhncorp.cn 2.6.9-78.ELsmp #1 SMP Fri Jul 25 00:04:28 EDT 2008 i686 i686 i386 GNU/Linux

我该怎么添写那些属性啊，呵呵！！

2 楼 juvenshun 2008-08-20  

已修正，谢谢 

1 楼 xl515331 2008-08-20  

<profile>  
   <id>dev</id>  
   <activation>  
     <activeByDefault>false</activeByDefault>  
   <activation>  
   ...  
</profile> 

少了一个 结束标记 <activation>