ubuntu maven環境安裝配置以及工程創建

一、環境說明：

操作系統：Ubuntu 12.04.2 LTS(32位)

maven：apache-maven-3.2.2

安裝maven前請先安裝好jdk，jdk安裝可參見：http://my.oschina.net/hongdengyan/blog/150342。

二、下載 maven

下載鏈接：http://maven.apache.org/download.cgi

選擇最新版本的maven安裝包，我安裝時最新安裝包是apache-maven-3.2.2-bin.tar.gz。

下載保存文件的路徑是：~/下載/。

三、解壓安裝

?

1

~$cd~/下載

解壓：

?

1	~/下載$tar-zxvf apache-maven-3.2.2-bin.tar.gz

將apache-maven-3.2.2目錄移動到/usr/local目錄：

?

1	~/下載$sudomv apache-maven-3.2.2/ /usr/local/

四、設置環境變量

以root身份打開並編輯profile文件：

?

1	~/下載$sudogedit /etc/profile

在文件最後添加：

#set maven environment
M2_HOME=/usr/local/apache-maven-3.2.2

export MAVEN_OPTS="-Xms256m -Xmx512m"

export PATH=$M2_HOME/bin:$PATH

保存並關閉。

要使配置生效必須重啓機器或者在命令行輸入：

?

1	~/下載$ . /etc/profile

查看maven是否安裝成功：

?

1	~/下載$ mvn -version

Apache Maven 3.2.2 (45f7c06d68e745d05611f7fd14efb6594181933e; 2014-06-17T21:51:42+08:00)
Maven home: /usr/local/apache-maven-3.2.2
Java version: 1.7.0_60, vendor: Oracle Corporation
Java home: /usr/local/java/jdk1.7.0_60/jre
Default locale: zh_CN, platform encoding: UTF-8
OS name: "linux", version: "3.5.0-23-generic", arch: "i386", family: "unix"

五、配置用戶範圍setting.xml

5.1  設置maven本地倉庫路徑

執行以下語句，自動生成.m2目錄：

?

1	~/下載$ mvn clean

將/usr/local/apache-maven-3.2.2/conf/settings.xml文件copy到~/.m2目錄：

?

1	~/下載$cp/usr/local/apache-maven-3.2.2/conf/settings.xml  ~/.m2/

修改~/.m2/settings.xml文件：

?

1	~/下載$ gedit ~/.m2/settings.xml

在文件中找到

?

1 2 3 4 5 6

<!-- localRepository    | The path to the local repository maven will use to store artifacts.    |    | Default: ${user.home}/.m2/repository   <localRepository>/path/to/local/repo</localRepository> -->

在其後添加內容： 

?

1 2 3 4 5 6 7 8

<!-- localRepository    | The path to the local repository maven will use to store artifacts.    |    | Default: ${user.home}/.m2/repository   <localRepository>/path/to/local/repo</localRepository>   -->    <localRepository>${user.home}/repository/maven</localRepository>

其中：${user.home}/repository/maven是你maven本地倉庫的路徑。

保存退出。

5.2  修改maven 鏡像，使用國內的倉庫

在 Maven 中使用 OSChina 的 Maven 服務還需要簡單配置一下 Maven，在 Maven 的安裝目錄下的 conf 文件下有個  settings.xml  文件，接下來我們需要對這個文件做簡單的修改，修改前您可以簡單備份下該文件。 打開  settings.xml  文件,按下面內容修改。或者點擊 settings.xml 下載

01

<mirrors>

02	<!-- mirror | Specifies a repository mirror site to use instead of a given

03	repository. The repository that | this mirror serves has an ID that matches

04	the mirrorOf element of this mirror. IDs are used | for inheritance and direct

05	lookup purposes, and must be unique across the set of mirrors. | -->

06

<mirror>

07	<id>nexus-osc</id>

08	<mirrorOf>*</mirrorOf>

09	<name>Nexus osc</name>

10	<url>http://maven.oschina.net/content/groups/public/</url>

11

</mirror>

12	</mirrors>

補充： 如果還需要osc的thirdparty倉庫或多個倉庫，需要如下修改：詳情 

01

<mirrors>

02	<!-- mirror | Specifies a repository mirror site to use instead of a given

03	repository. The repository that | this mirror serves has an ID that matches

04	the mirrorOf element of this mirror. IDs are used | for inheritance and direct

05	lookup purposes, and must be unique across the set of mirrors. | -->

06

<mirror>

07	<id>nexus-osc</id>

08	<mirrorOf>central</mirrorOf>

09	<name>Nexus osc</name>

10	<url>http://maven.oschina.net/content/groups/public/</url>

11

</mirror>

12

<mirror>

13	<id>nexus-osc-thirdparty</id>

14	<mirrorOf>thirdparty</mirrorOf>

15	<name>Nexus osc thirdparty</name>

16	<url>http://maven.oschina.net/content/repositories/thirdparty/</url>

17

</mirror>

18	</mirrors>

這裏是配置 Maven 的 mirror 地址指向OSChina 的 Maven 鏡像地址。 在執行 Maven 命令的時候， Maven 還需要安裝一些插件包，這些插件包的下載地址也讓其指向 OSChina 的 Maven 地址。修改如下內容。

01

<profile>

02	<id>jdk-1.4</id>

03

04	<activation>

05	<jdk>1.4</jdk>

06	</activation>

07

08	<repositories>

09	<repository>

10	<id>nexus</id>

11	<name>local private nexus</name>

12	<url>http://maven.oschina.net/content/groups/public/</url>

13	<releases>

14	<enabled>true</enabled>

15	</releases>

16	<snapshots>

17	<enabled>false</enabled>

18	</snapshots>

19	</repository>

20	</repositories>

21	<pluginRepositories>

22	<pluginRepository>

23	<id>nexus</id>

24	<name>local private nexus</name>

25	<url>http://maven.oschina.net/content/groups/public/</url>

26	<releases>

27	<enabled>true</enabled>

28	</releases>

29	<snapshots>

30	<enabled>false</enabled>

31	</snapshots>

32	</pluginRepository>

33	</pluginRepositories>

34	</profile>

按照如上修改  settings.xml  之後，您就可以在自己的 Maven 中使用 OSChina 爲您提供的 Maven 服務了。

五、使用 Maven 創建項目

您可以創建一個屬於自己的 Maven 項目來簡單測試一下 OSChina 的 Maven 庫。創建 Maven 項目很簡單，只需要簡單一行命令就可以搞定。 
下面是創建 Maven 項目的命令：

1	mvn archetype:create -DgroupId=oschina -DartifactId=simple -DpackageName=net.oschina.simple  -DarchetypeArtifactId=maven-archetype-webapp -DinteractiveMode=false 注意：在maven 3.0.5版本之後，將不再支持create，而是使用archetype:generate

其中   -DarchetypeArtifactId=maven-archetype-webapp   代表創建一個簡單的 webapp 項目。至於其他參數的意思，您可以查看下 Maven 的相關文檔。 在您需要創建 Maven 項目的文件夾下用命令行執行以上命令。可以看到如下輸出： 

如果順利創建成功的話，你會看到如下輸出:

如果創建失敗，就可能需要您去 Google 一下了。創建項目的時候，Maven 會下載一些需要用到的 Maven 插件。

5.1  添加包依賴

因爲只是簡單介紹下使用 OSChina 的 Maven 庫，關於 Maven 的項目編譯，打包，測試，發佈等具體細節就不多介紹了，您可以去查看 Maven 的相關文檔。
跟ant一樣，Maven 也需要通過 xml 來配置。在項目的根目錄下有一個  pom.xml  文件。

01	<project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

02	xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/maven-v4_0_0.xsd">

03	<modelVersion>4.0.0</modelVersion>

04	<groupId>oschina</groupId>

05	<artifactId>oschina.simple</artifactId>

06	<packaging>war</packaging>

07	<version>1.0</version>

08	<name>oschina.simple Maven Webapp</name>

09	<url>http://maven.apache.org</url>

10	<dependencies>

11	<dependency>

12	<groupId>junit</groupId>

13	<artifactId>junit</artifactId>

14	<version>3.8.1</version>

15	<scope>test</scope>

16	</dependency>

17	</dependencies>

18

<build>

19	<finalName>oschina.simple</finalName>

20

</build>

21	</project>

在 pom.xml 中加入您需要添加的包，如果您需要查找依賴包有哪些版本，可以在 OSChina Maven 搜索。比如輸入 jedis 的結果會如下：

在右下角的 Maven 標籤下可以看到當前選中的版本的依賴 xml，copy 該依賴 xml 到  pom.xml  的  dependencies  結點下。如果需要其他依賴包，您也繼續搜索。當然，有些偏門的 jar 可能沒有，這主要可能是它沒有提交到 Maven 的中央庫中。

5.2 將項目安裝到本地 repository

添加好包的依賴之後，您就可以開始在您的 Maven 項目下開始工作了。如果一切準備就緒，您可能需要將項目安裝到本地  repository  。
執行命令： mvn clean & mvn install 就可以把項目安裝到您配置的本地鏡像地址  .m2/repository  下了。 執行命令可以看到如下輸出： 

執行完之後，如果安裝成功會出現如下結果： 

如果失敗了，就根據失敗結果 Google 一下吧！ 接下來打開您配置的本地  repository  地址，可以看到您配置的各種依賴包都下載到您本地文件夾了，下次您再使用這些包的時候就不需要再次下載了，項目構建速度也會提高很多。