一、环境说明:
操作系统: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
|
~/下载$
tar
-zxvf apache-maven-3.2.2-bin.
tar
.gz
|
将apache-maven-3.2.2目录移动到/usr/local目录:
1
|
~/下载$
sudo
mv
apache-maven-3.2.2/
/usr/local/
|
四、设置环境变量
以root身份打开并编辑profile文件:
1
|
~/下载$
sudo
gedit
/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
保存并关闭。
要使配置生效必须重启机器或者在命令行输入:
查看maven是否安装成功:
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目录:
将/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
7
8
|
<
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 下载
08 | < mirrorOf >*</ mirrorOf > |
09 | < name >Nexus osc</ name > |
10 | < url >http://maven.oschina.net/content/groups/public/</ url > |
补充:
如果还需要osc的thirdparty仓库或多个仓库,需要如下修改:详情
08 | < mirrorOf >central</ mirrorOf > |
09 | < name >Nexus osc</ name > |
10 | < url >http://maven.oschina.net/content/groups/public/</ url > |
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 > |
这里是配置 Maven 的 mirror 地址指向OSChina 的 Maven 镜像地址。 在执行 Maven 命令的时候, Maven 还需要安装一些插件包,这些插件包的下载地址也让其指向 OSChina 的 Maven 地址。修改如下内容。
11 | < name >local private nexus</ name > |
12 | < url >http://maven.oschina.net/content/groups/public/</ url > |
14 | < enabled >true</ enabled > |
17 | < enabled >false</ enabled > |
24 | < name >local private nexus</ name > |
25 | < url >http://maven.oschina.net/content/groups/public/</ url > |
27 | < enabled >true</ enabled > |
30 | < enabled >false</ enabled > |
按照如上修改 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 > |
12 | < groupId >junit</ groupId > |
13 | < artifactId >junit</ artifactId > |
14 | < version >3.8.1</ version > |
19 | < finalName >oschina.simple</ finalName > |
在 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 地址,可以看到您配置的各种依赖包都下载到您本地文件夹了,下次您再使用这些包的时候就不需要再次下载了,项目构建速度也会提高很多。