Maven-setting.xml詳解

轉自: https://www.cnblogs.com/hwaggLee/p/4579418.html

settings.xml對於maven來說相當於全局性的配置,用於所有的項目,當Maven運行過程中的各種配置,例如pom.xml,不想綁定到一個固定的project或者要分配給用戶時,我們使用settings.xml中的settings元素來確定這些配置。這包含了本地倉庫位置,遠程倉庫服務器以及認證信息等。

 

settings.xml存在於兩個地方:

1.安裝的地方:$M2_HOME/conf/settings.xml

2.用戶的目錄:${user.home}/.m2/settings.xml

前者又被叫做全局配置,後者被稱爲用戶配置。如果兩者都存在,它們的內容將被合併,並且用戶範圍的配置優先。

平時配置時優先選擇用戶目錄的settings.xml

下面是settings下的頂層元素的一個概覽:

複製代碼

<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">
    <localRepository/>
    <interactiveMode/>
    <usePluginRegistry/>
    <offline/>
    <pluginGroups/>
    <servers/>
    <mirrors/>
    <proxies/>
    <profiles/>
    <activeProfiles/></settings>

複製代碼

 

settings的內容可以在下面這些地方篡改:

1.${user.home}和所有其他的系統屬性

2.${env.HOME}等環境變量

 

注意:settins.xml中profiles下定義的屬性不能被篡改。

 

簡單值
一半以上的頂級settings元素師簡單的值,代表了一直處於活躍的構建系統的元素的取值範圍。

複製代碼

<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">
    <localRepository>${user.home}/.m2/repository</localRepository>
    <interactiveMode>true</interactiveMode>
    <usePluginRegistry>false</usePluginRegistry>
    <offline>false</offline>
    ...</settings>

複製代碼

 

複製代碼

localRepository:這個值是構建系統的本地倉庫的路徑。默認的值是${user.home}/.m2/repository.如果一個系統想讓所有登陸的用戶都用同一個本地倉庫的話,這個值是極其有用的。
interactiveMode:如果Maven要試圖與用戶交互來得到輸入就設置爲true,否則就設置爲false,默認爲true。
usePluginRegistry:如果Maven使用${user.home}/.m2/plugin-registry.xml來管理plugin的版本,就設置爲true,默認爲false。
offline:如果構建系統要在離線模式下工作,設置爲true,默認爲false。如果構建服務器因爲網絡故障或者安全問題不能與遠程倉庫相連,那麼這個設置是非常有用的。

複製代碼

 

 

PluginGroups(插件組)

這個元素包含了一系列pluginGroup元素,每個又包含了一個groupId。當一個plugin被使用,而它的groupId沒有被提供的時候,這個列表將被搜索。這個列表自動的包含了org.apache.maven.plugins和org.codehaus.mojo。

複製代碼

<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">
    ...    <pluginGroups>
        <pluginGroup>org.mortbay.jetty</pluginGroup>
    </pluginGroups>
    ...</settings>

複製代碼

 

例如,有了上面的配置,Maven命令行可以使用簡單的命令執行org.morbay.jetty:jetty-maven-plugin:run,如下

mvn jetty run

 

 

Servers(服務器)

1. 定義jar包下載的Maven倉庫

   2. 定義部署服務器

用來下載和部署的倉庫是用POM中的repositories和distributionManagement元素來定義的。但是某些配置例如username和password就不應該隨着pom.xml來分配了。這種類型的信息應該保存在構建服務器中的settings.xml中。

複製代碼

<servers>
    <server>
        <id>tomcat</id>
        <username>bruce</username>
        <password>password</password>
    </server>
    <server>
        <id>shiyue</id>
        <username>admin</username>
        <password>password</password>
    </server>
  </servers>

複製代碼

tomcat: 部署服務器

shiyue: Mave私服

複製代碼

<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">
    ...    <servers>
    <server>
    <id>server001</id>
    <username>my_login</username>
    <password>my_password</password>
    <privateKey>${user.home}/.ssh/id_dsa</privateKey>
    <passphrase>some_passphrase</passphrase>
    <filePermissions>664</filePermissions>
    <directoryPermissions>775</directoryPermissions>
    <configuration></configuration>
    </server>
    </servers>
    ...</settings>

複製代碼

id:這是Server的ID(不是登錄進來的user),與Maven想要連接上的repository/mirror中的id元素相匹配。

username,password:這兩個元素成對出現,表示連接這個server需要驗證username和password。

privateKey,passphrase:與前兩個元素一樣,這兩個成對出現,分別指向了一個私鑰(默認的是${user.home}/.ssh/id_dsa)和一個passphrase。passphrase和password元素可能在將來被客觀化,但是現在必須以文本形式在settings.xml中設置。

filePermissions,directoryPermissions:當一個倉庫文件或者目錄在部署階段被創建的時候,就必須用到權限許可。他們合法的值是三個數字,就像*nix中的文件權限,例如:664,775.

注意:如果你使用了一個私鑰來登錄server,那麼password元素必須被省略,否則私鑰將被忽視。

 

密碼加密

一個新特徵:服務器password和passphrase加密已經被升到2.1.0+

 

 

 

Mirrors(鏡像)

指定倉庫的地址,則默認從指定的鏡像下載jar包及插件

複製代碼

<mirrors>
                                                                                                 
     <mirror>
      <id>mirrorId</id>
      <mirrorOf>*</mirrorOf>
      <name>Human Readable Name for this Mirror.</name>
      <url>http://host:port/nexus-2.1.2/content/groups/public</url>
    </mirror>
  </mirrors>

複製代碼

id,name:唯一的鏡像標識和用戶友好的鏡像名稱。id被用來區分mirror元素,並且當連接時候被用來獲得相應的證書。

url:鏡像基本的URL,構建系統敬將使用這個URL來連接倉庫,而不是原來的倉庫URL。

mirrorOf:鏡像所包含的倉庫的Id。例如,指向Maven central倉庫的鏡像(http://repo1.maven.org/maven2/),設置這個元素爲central。更多的高級映射例如repo1,repo2 或者*,!inhouse都是可以的。沒必要一定和mirror的id相匹配。

 

 

Proxies(代理)

有時候你所在的公司基於安全因素考慮,要求你使用通過安全認證的代理訪問因特網。這時就需要爲Maven配置HTTP代理。

複製代碼

<proxies>
    <proxy>
      <id>optional</id>
      <active>true</active>
      <protocol>http</protocol>
      <username>proxyuser</username>
      <password>proxypass</password>
      <host>proxy.host.net</host>
      <port>80</port>
      <nonProxyHosts>local.net|some.host.com</nonProxyHosts>
    </proxy>
 </proxies>

複製代碼

 

id:proxy的唯一標識,用來區別proxy元素。

active:當proxy被激活的時候爲true。當申明的代理很多的時候,這個很有用,但是同一時間僅有一個被激活。

protocol,host,port:代理地址protocol://host:port的分散形式。

username,password:兩個元素成對出現,提供連接proxy服務器時的認證。

nonProxyHosts:這裏列出了不需要使用代理的hosts。列表的分隔符是proxy服務器想要的類型。上面例子使用了pipe分隔符,逗號分隔符也比較通用。

複製代碼

<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">
    ...    <proxies>
        <proxy>
            <id>myproxy</id>
            <active>true</active>
            <protocol>http</protocol>
            <host>proxy.somewhere.com</host>
            <port>8080</port>
            <username>proxyuser</username>
            <password>somepassword</password>
            <nonProxyHosts>*.google.com|ibiblio.org</nonProxyHosts>
        </proxy>
    </proxies>
    ...</settings>

複製代碼

 

 

配置文件

settings.xml中的profile是pom.xml中的profile的簡潔形式。它包含了激活(activation),倉庫(repositories),插件倉庫(pluginRepositories)和屬性(properties)元素。profile元素僅包含這四個元素是因爲他們涉及到整個的構建系統,而不是個別的POM配置。

如果settings中的profile被激活,那麼它的值將重載POM或者profiles.xml中的任何相等ID的profiles。

 

激活(activation)

activations是profile的關鍵,就像POM中的profiles,profile的能力在於它在特定情況下可以修改一些值。而這些情況是通過activation來指定的。

複製代碼

<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">
    ...    <profiles>
        <profile>
            <id>test</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.3</value>
                </property>
                <file>
                    <exists>${basedir}/file2.properties</exists>
                    <missing>${basedir}/file1.properties</missing>
                </file>
            </activation>
            ...        </profile>
    </profiles>
    ...</settings>

複製代碼

如果所有指定的條件都達到了,那麼,activation就被觸發,而且不需要一次性全部達到。

jdk:在jdk元素中,activation有一個內建的,java版本檢測。如果檢測到jdk版本與期待的一樣,那麼就激活。在上面的例子中,1.5.0_06是滿足的。

os:os元素可以定義一些上面所示的操作系統特定的屬性。

property:如果Maven檢測到相應的名值對的屬性,那麼,這個profile將被激活。

file:如果給定的文件存在,或者不存在那麼將激活這個profile。

activation並不是唯一激活profile的途徑。settings.xml中的activeProfile包含了profile的id。他們也可以通過命令行來顯式的激活,例如-P test。

如果你想查看在一個構建過程中有哪些profile會被激活。就使用maven-help-plugin

mvn help:active-profiles

 

 

屬性(properites)

Maven的屬性是值佔位符,就像Ant中的屬性。如果X是一個屬性的話,那麼它的值在POM中可以使用${X}來進行任意地方的訪問。他們來自於五種不同的風格,所有都可以從settings.xml文件中訪問到。

1.env.X:使用“env.”前綴將會返回當前的環境變量。例如${env.PATH}就是使用了$path環境變量。

2.project.X:一個點“.”分割的路徑,在POM中就是相關的元素的值。例如:<project><version>1.0</version></project>就可以通過${project.version}來訪問。

3.settings.X:一個點“.”分割的路徑,在settings.xml中就是相對應的元素的值,例如:<settings><offline>false</offline></settings>就可以通過${settings.offline}來訪問。

4.Java系統屬性:所有通過java.lang.System.getProperties()來訪問的屬性都可以像POM中的屬性一樣訪問,例如:${java.home}

5.X:被<properties/>或者外部文件定義的屬性,值可以這樣訪問${someVar}

複製代碼

<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">
    ...    <profiles>
        <profile>
            ...            <properties>
                <user.install>${user.home}/our-project</user.install>
            </properties>
            ...        </profile>
    </profiles>
    ...</settings>

複製代碼

如果這個profile被激活,那麼屬性${user.install}就可以被訪問了。

倉庫(repositories)

倉庫是Maven用來構築構建系統的本地倉庫的遠程項目集合。它來自於被Maven叫做插件和依賴的本地倉庫。不同的遠程倉庫包含不同的項目,當profile被激活,他們就會需找匹配的release或者snapshot構件。

複製代碼

<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">
    ...    <profiles>
        <profile>
        ...        <repositories>
            <repository>
                <id>codehausSnapshots</id>
                <name>Codehaus Snapshots</name>
                <releases>
                    <enabled>false</enabled>
                    <updatePolicy>always</updatePolicy>
                    <checksumPolicy>warn</checksumPolicy>
                </releases>
                <snapshots>
                    <enabled>true</enabled>
                    <updatePolicy>never</updatePolicy>
                    <checksumPolicy>fail</checksumPolicy>
                </snapshots>
                <url>http://snapshots.maven.codehaus.org/maven2</url>
                <layout>default</layout>
            </repository>
        </repositories>
        <pluginRepositories>
        ...        </pluginRepositories>
        ...        </profile>
    </profiles>
    ...</settings>

複製代碼

releases,snapshots:這是各種構件的策略,release或者snapshot。因了這兩個集合,POM可以在單個的倉庫中不依賴於另外一個的策略而改變當前策略。例如:一個人可能只下載snapshot用來開發。

enable:true或者false,來標記倉庫是否爲各自的類型激活(release 或者 snapshot)。

updatePolicy:這個元素指明瞭更新的頻率。Maven會比較本地POM與遠程的時間戳。可選的項目爲:always,daily,interval:X,nerver。

checksumPolicy:當Maven向倉庫部署文件的時候,它也部署了相應的校驗和文件。可選的爲:ignore,fail,warn,或者不正確的校驗和。

layout:在上面描述倉庫的時候,我們提到他們有統一的佈局。這完全正確。使用這個來表明它是default還是legacy。

 

插件倉庫(plugin repositories)

倉庫包含了兩種重要類型的構件。第一種是用來做其他構件依賴的構件,這是在中央倉庫中的大多數插件。另外一種類型的構件就是插件。Maven的插件本身就是一種特殊的構件。因此,插件倉庫被從其他倉庫中分離出來。無論怎麼說,pluginRepositories元素模塊的結構與repositories模塊很相似。pluginRepository元素指向一個可以找到新插件的遠程地址。

 

激活配置(Active Profiles)

 

複製代碼

<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">
    ...    <activeProfiles>
        <activeProfile>env-test</activeProfile>
    </activeProfiles></settings>

複製代碼

settings.xml最後一個謎題是activeProfiles元素。它包含一系列的activeProfile元素,每個都有一個profile id的值,任何profile id被定義到activeProfile的profile將被激活,不管其他的環境設置怎麼樣。如果沒有匹配的profile被找到,那麼就什麼事情也不做。例如:如果env-test是一個activeProfile,一個在pom.xml或者profile.xml中的具有相應id的profile將被激活。如果沒有這樣的profile被找到,就什麼事也不做,一切照常。

 

 

 

 

詳細註解

複製代碼

<?xml version="1.0" encoding="UTF-8"?>  <settings xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"  
 xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/settings-1.0.0.xsd">  
 <!--本地倉庫。該值表示構建系統本地倉庫的路徑。其默認值爲~/.m2/repository。 -->  
 <localRepository>usr/local/maven</localRepository>  
 <!--Maven是否需要和用戶交互以獲得輸入。如果Maven需要和用戶交互以獲得輸入,則設置成true,反之則應爲false。默認爲true。-->  
 <interactiveMode>true</interactiveMode>  
 <!--Maven是否需要使用plugin-registry.xml文件來管理插件版本。如果需要讓Maven使用文件~/.m2/plugin-registry.xml來管理插件版本,則設爲true。默認爲false。-->  
 <usePluginRegistry>false</usePluginRegistry>  
 <!--表示Maven是否需要在離線模式下運行。如果構建系統需要在離線模式下運行,則爲true,默認爲false。當由於網絡設置原因或者安全因素,構建服務器不能連接遠程倉庫的時候,該配置就十分有用。 -->  
 <offline>false</offline>  
 <!--當插件的組織Id(groupId)沒有顯式提供時,供搜尋插件組織Id(groupId)的列表。該元素包含一個pluginGroup元素列表,每個子元素包含了一個組織Id(groupId)。當我們使用某個插件,並且沒有在命令行爲其提供組織Id(groupId)的時候,Maven就會使用該列表。默認情況下該列表包含了org.apache.maven.plugins。 -->  
 <pluginGroups>  
  <!--plugin的組織Id(groupId) -->  
  <pluginGroup>org.codehaus.mojo</pluginGroup>  
 </pluginGroups>  
 <!--用來配置不同的代理,多代理profiles 可以應對筆記本或移動設備的工作環境:通過簡單的設置profile id就可以很容易的更換整個代理配置。 -->  
 <proxies>  
  <!--代理元素包含配置代理時需要的信息-->  
  <proxy>  
   <!--代理的唯一定義符,用來區分不同的代理元素。-->  
   <id>myproxy</id>  
   <!--該代理是否是激活的那個。true則激活代理。當我們聲明瞭一組代理,而某個時候只需要激活一個代理的時候,該元素就可以派上用處。 -->  
   <active>true</active>  
   <!--代理的協議。 協議://主機名:端口,分隔成離散的元素以方便配置。-->  
   <protocol>http</protocol>  
   <!--代理的主機名。協議://主機名:端口,分隔成離散的元素以方便配置。  -->  
   <host>proxy.somewhere.com</host>  
   <!--代理的端口。協議://主機名:端口,分隔成離散的元素以方便配置。 -->  
   <port>8080</port>  
   <!--代理的用戶名,用戶名和密碼錶示代理服務器認證的登錄名和密碼。 -->  
   <username>proxyuser</username>  
   <!--代理的密碼,用戶名和密碼錶示代理服務器認證的登錄名和密碼。 -->  
   <password>somepassword</password>  
   <!--不該被代理的主機名列表。該列表的分隔符由代理服務器指定;例子中使用了豎線分隔符,使用逗號分隔也很常見。-->  
   <nonProxyHosts>*.google.com|ibiblio.org</nonProxyHosts>  
  </proxy>  
 </proxies>  
 <!--配置服務端的一些設置。一些設置如安全證書不應該和pom.xml一起分發。這種類型的信息應該存在於構建服務器上的settings.xml文件中。-->  
 <servers>  
  <!--服務器元素包含配置服務器時需要的信息 -->  
  <server>  
   <!--這是server的id(注意不是用戶登陸的id),該id與distributionManagement中repository元素的id相匹配。-->  
   <id>server001</id>  
   <!--鑑權用戶名。鑑權用戶名和鑑權密碼錶示服務器認證所需要的登錄名和密碼。 -->  
   <username>my_login</username>  
   <!--鑑權密碼 。鑑權用戶名和鑑權密碼錶示服務器認證所需要的登錄名和密碼。 -->  
   <password>my_password</password>  
   <!--鑑權時使用的私鑰位置。和前兩個元素類似,私鑰位置和私鑰密碼指定了一個私鑰的路徑(默認是/home/hudson/.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>  
   <!--傳輸層額外的配置項 -->  
   <configuration></configuration>  
  </server>  
 </servers>  
 <!--爲倉庫列表配置的下載鏡像列表。 -->  
 <mirrors>  
  <!--給定倉庫的下載鏡像。 -->  
  <mirror>  
   <!--該鏡像的唯一標識符。id用來區分不同的mirror元素。 -->  
   <id>planetmirror.com</id>  
   <!--鏡像名稱 -->  
   <name>PlanetMirror Australia</name>  
   <!--該鏡像的URL。構建系統會優先考慮使用該URL,而非使用默認的服務器URL。 -->  
   <url>http://downloads.planetmirror.com/pub/maven2</url>  
   <!--被鏡像的服務器的id。例如,如果我們要設置了一個Maven中央倉庫(http://repo1.maven.org/maven2)的鏡像,就需要將該元素設置成central。這必須和中央倉庫的id central完全一致。-->  
   <mirrorOf>central</mirrorOf>  
  </mirror>  
 </mirrors>  
 <!--根據環境參數來調整構建配置的列表。settings.xml中的profile元素是pom.xml中profile元素的裁剪版本。它包含了id,activation, repositories, pluginRepositories和 properties元素。這裏的profile元素只包含這五個子元素是因爲這裏只關心構建系統這個整體(這正是settings.xml文件的角色定位),而非單獨的項目對象模型設置。如果一個settings中的profile被激活,它的值會覆蓋任何其它定義在POM中或者profile.xml中的帶有相同id的profile。 -->  
 <profiles>  
  <!--根據環境參數來調整的構件的配置-->  
  <profile>  
   <!--該配置的唯一標識符。 -->  
   <id>test</id>  
   <!--自動觸發profile的條件邏輯。Activation是profile的開啓鑰匙。如POM中的profile一樣,profile的力量來自於它能夠在某些特定的環境中自動使用某些特定的值;這些環境通過activation元素指定。activation元素並不是激活profile的唯一方式。settings.xml文件中的activeProfile元素可以包含profile的id。profile也可以通過在命令行,使用-P標記和逗號分隔的列表來顯式的激活(如,-P test)。-->  
   <activation>  
    <!--profile默認是否激活的標識-->  
    <activeByDefault>false</activeByDefault>  
    <!--當匹配的jdk被檢測到,profile被激活。例如,1.4激活JDK1.4,1.4.0_2,而!1.4激活所有版本不是以1.4開頭的JDK。-->  
    <jdk>1.5</jdk>  
    <!--當匹配的操作系統屬性被檢測到,profile被激活。os元素可以定義一些操作系統相關的屬性。-->  
    <os>  
     <!--激活profile的操作系統的名字 -->  
     <name>Windows XP</name>  
     <!--激活profile的操作系統所屬家族(如 'windows')  -->  
     <family>Windows</family>  
     <!--激活profile的操作系統體系結構  -->  
     <arch>x86</arch>  
     <!--激活profile的操作系統版本-->  
     <version>5.1.2600</version>  
    </os>  
    <!--如果Maven檢測到某一個屬性(其值可以在POM中通過${名稱}引用),其擁有對應的名稱和值,Profile就會被激活。如果值字段是空的,那麼存在屬性名稱字段就會激活profile,否則按區分大小寫方式匹配屬性值字段-->  
    <property>  
     <!--激活profile的屬性的名稱-->  
     <name>mavenVersion</name>  
     <!--激活profile的屬性的值 -->  
     <value>2.0.3</value>  
    </property>  
    <!--提供一個文件名,通過檢測該文件的存在或不存在來激活profile。missing檢查文件是否存在,如果不存在則激活profile。另一方面,exists則會檢查文件是否存在,如果存在則激活profile。-->  
    <file>  
     <!--如果指定的文件存在,則激活profile。 -->  
     <exists>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/</exists>  
     <!--如果指定的文件不存在,則激活profile。-->  
     <missing>/usr/local/hudson/hudson-home/jobs/maven-guide-zh-to-production/workspace/</missing>  
    </file>  
   </activation>  
   <!--對應profile的擴展屬性列表。Maven屬性和Ant中的屬性一樣,可以用來存放一些值。這些值可以在POM中的任何地方使用標記${X}來使用,這裏X是指屬性的名稱。屬性有五種不同的形式,並且都能在settings.xml文件中訪問。  
   1. env.X: 在一個變量前加上"env."的前綴,會返回一個shell環境變量。例如,"env.PATH"指代了$path環境變量(在Windows上是%PATH%)。  
   2. project.x:指代了POM中對應的元素值。  
   3. settings.x: 指代了settings.xml中對應元素的值。  
   4. Java System Properties: 所有可通過java.lang.System.getProperties()訪問的屬性都能在POM中使用該形式訪問,  
    如/usr/lib/jvm/java-1.6.0-openjdk-1.6.0.0/jre。  
   5. x: 在<properties/>元素中,或者外部文件中設置,以${someVar}的形式使用。 -->  
   <properties>  
    <user.install>/ebs1/build-machine/usr/local/hudson/hudson-home/jobs/maven-guide-</user.install>  
   </properties>  
   <!--遠程倉庫列表,它是Maven用來填充構建系統本地倉庫所使用的一組遠程項目。 -->  
   <repositories>  
    <!--包含需要連接到遠程倉庫的信息 -->  
    <repository>  
     <!--遠程倉庫唯一標識-->  
     <id>codehausSnapshots</id>  
     <!--遠程倉庫名稱 -->  
     <name>Codehaus Snapshots</name>  
     <!--如何處理遠程倉庫裏發佈版本的下載-->  
     <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就可以在每個單獨的倉庫中,爲每種類型的構件採取不同的策略。例如,可能有人會決定只爲開發目的開啓對快照版本下載的支持。參見repositories/repository/releases元素-->  
     <snapshots>  
      <enabled/><updatePolicy/><checksumPolicy/>  
     </snapshots>  
     <!--遠程倉庫URL,按protocol://hostname/path形式 -->  
     <url>http://snapshots.maven.codehaus.org/maven2</url>  
     <!--用於定位和排序構件的倉庫佈局類型-可以是default(默認)或者legacy(遺留)。Maven 2爲其倉庫提供了一個默認的佈局;然而,Maven 1.x有一種不同的佈局。我們可以使用該元素指定佈局是default(默認)還是legacy(遺留)。 -->  
     <layout>default</layout>  
    </repository>  
   </repositories>  
   <!--發現插件的遠程倉庫列表。倉庫是兩種主要構件的家。第一種構件被用作其它構件的依賴。這是中央倉庫中存儲的大部分構件類型。另外一種構件類型是插件。Maven插件是一種特殊類型的構件。由於這個原因,插件倉庫獨立於其它倉庫。pluginRepositories元素的結構和repositories元素的結構類似。每個pluginRepository元素指定一個Maven可以用來尋找新插件的遠程地址。-->  
   <pluginRepositories>  
    <!--包含需要連接到遠程插件倉庫的信息.參見profiles/profile/repositories/repository元素的說明-->  
          <pluginRepository>             
     <releases>        
      <enabled/><updatePolicy/><checksumPolicy/>  
     </releases>  
     <snapshots>  
      <enabled/><updatePolicy/><checksumPolicy/>  
     </snapshots>  
     <id/><name/><url/><layout/>  
          </pluginRepository>  
        </pluginRepositories>  
        <!--手動激活profiles的列表,按照profile被應用的順序定義activeProfile。 該元素包含了一組activeProfile元素,每個activeProfile都含有一個profile id。任何在activeProfile中定義的profile id,不論環境設置如何,其對應的  
        profile都會被激活。如果沒有匹配的profile,則什麼都不會發生。例如,env-test是一個activeProfile,則在pom.xml(或者profile.xml)中對應id的profile會被激活。如果運行過程中找不到這樣一個profile,Maven則會像往常一樣運行。 -->  
   <activeProfiles>  
    <!-- -->  
    <activeProfile>env-test</activeProfile>  
   </activeProfiles>  
  </profile>  
 </profiles>  </settings>

複製代碼

 

知識只有共享才能傳播,才能推崇出新的知識,才能學到更多,這裏寫的每一篇文字/博客,基本都是從網上查詢了一下資料然後記錄下來,也有些是原滋原味搬了過來,也有時加了一些自己的想法


發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章