MAVEN指南-二、settings 文件節點配置詳解

基本結構

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

 

localRepository： 表示本地庫的保存位置，也就是maven2主要的jar保存位置，默認在${user.dir}/.m2/repository，若是須要另外設置，就換成其餘的路徑。

如： 

<localRepository>d:\oceanic_workspace\oceanic_maven_repo\repository</localRepository>

 

offline： 若是不想每次編譯，都去查找遠程中心庫，那就設置爲true。固然前提是你已經下載了必須的依賴包。 默認false。

<offline>false</offline>

 

Servers ：在POM中的 distributionManagement元素定義了開發庫。然而，特定的username和pwd不能使用於pom.xml，因此經過此配置來保存server信息。

• id:server 的id,用於匹配distributionManagement庫id，比較重要。
• username, password:用於登錄此服務器的用戶名和密碼
• privateKey, passphrase：設置private key，以及passphrase
• filePermissions, directoryPermissions：當庫文件或者目錄建立後，須要使用權限進行訪問。

<servers> 
        <server> 
          <id>server001</id> 
          <username>my_login</username> 
          <password>my_password</password> 
          <privateKey>${usr.home}/.ssh/id_dsa</privateKey> 
          <passphrase>some_passphrase</passphrase> 
          <filePermissions>664</filePermissions> 
          <directoryPermissions>775</directoryPermissions> 
          <configuration></configuration> 
        </server>
        <server> 
          <id>server002</id> 
          <username>my_login</username> 
          <password>my_password</password> 
          <privateKey>${usr.home}/.ssh/id_dsa</privateKey> 
          <passphrase>some_passphrase</passphrase> 
          <filePermissions>664</filePermissions> 
          <directoryPermissions>775</directoryPermissions> 
          <configuration></configuration> 
        </server>
    </servers>

 

Mirrors
表示鏡像庫，指定庫的鏡像，用於增長其餘庫 

• id,name:惟一的標誌，用於區別鏡像
• url:鏡像的url
• mirrorOf：此鏡像指向的服務id

<mirrors> 
    <mirror> 
      <id>planetmirror.com</id> 
      <name>PlanetMirror Australia</name> 
      <url>http://downloads.planetmirror.com/pub/maven2</url> 
      <mirrorOf>central</mirrorOf> 
    </mirror> 
  </mirrors>

 <mirrorOf> 表示只爲central倉庫作鏡像，若是想爲全部的倉庫作鏡像那麼能夠改成：<mirrorOf>*</mirrorOf>

 

Proxies 
此代理設置，主要用於沒法直接訪問中心的庫用戶配置。

• id:代理的標誌
• active：是否激活代理
• protocol, host, port:protocol://host:port 代理
• username, password：用戶名和密碼
• nonProxyHosts: 不須要代理的host

<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>

 

Profiles 
  相似於pom.xml中的profile元素

  主要包括activation,repositories,pluginRepositories 和properties元素 
  剛開始接觸的時候，會比較迷惑，這是maven2中比較強大的功能——個性配置。 
  單獨定義profile後，並不會生效，須要經過知足條件來激活。 

repositories 和pluginRepositories 依照以下的配置，定義了本地開發庫，用於release 發佈。

<repositories> 
    <repository> 
        <id>repo-local</id> 
        <name>Internal 開發庫</name> 
        <url>http://192.168.0.2:8082/repo-local</url> 
        <releases> 
            <enabled>true</enabled> 
            <updatePolicy>never</updatePolicy> 
            <checksumPolicy>warn</checksumPolicy> 
        </releases> 
        <snapshots> 
            <enabled>false</enabled> 
        </snapshots> 
        <layout>default</layout> 
    </repository> 
</repositories> 

<pluginRepositories> 
    <pluginRepository> 
        <id>repo-local</id> 
        <name>Internal 開發庫</name> 
        <url>http://192.168.0.2:8082/repo-local</url> 
        <releases> 
            <enabled>true</enabled> 
            <updatePolicy>never</updatePolicy> 
            <checksumPolicy>warn</checksumPolicy> 
        </releases> 
        <snapshots> 
            <enabled>false</enabled> 
        </snapshots> 
        <layout>default</layout> 
    </pluginRepository> 
</pluginRepositories>

releases, snapshots:每一個產品的版本的Release或者snapshot(注：release和snapshot的區別，release通常是比較穩定的版本，而snapshot基本上不穩定，只是做爲快照） 

 

properties做爲placeholder值，如ant的properties。 

包括如下的5種類型值： 

1. env.X，返回當前的環境變量
2. project.x:返回pom中定義的元素值，如project.version
3. settings.x：返回settings.xml中定義的元素
4. java 系統屬性：全部通過java.lang.System.getProperties()返回的值
5. x：用戶本身設定的值

 

Activation 用於激活此profile 

• jdk:若是匹配指定的jdk版本，將會激活
• os:操做系統
• property：若是maven能檢測到相應的屬性
• file: 用於判斷文件是否存在或者不存在

<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>

 

Active Profiles 

除了使用activation來激活profile，一樣能夠經過activeProfiles來激活 

env-test 表示指定的profile id 

　　<activeProfiles> 
　　　　<activeProfile>env-test</activeProfile> 
　　</activeProfiles>

 

 

interactiveMode：表示是否使用交互模式，默認是true；若是設爲false，那麼當Maven須要用戶進行輸入的時候，它會使用一個默認值。

<interactiveMode>true</interactiveMode>

 

pluginGroups：在pluginGroups元素下面能夠定義一系列的pluginGroup元素。表示當經過plugin的前綴來解析plugin的時候到哪裏尋找。pluginGroup元素指定的是plugin的groupId。默認狀況下，Maven會自動把org.apache.maven.plugins和org.codehaus.mojo添加到pluginGroups下。

<pluginGroups>
    <pluginGroup>com.your.plugins</pluginGroup>
  </pluginGroups>