maven构建项目指导手册

组件升级管理指导手册

目录

1.升级步骤一览......................................................................................... 错误！未定义书签。

2.软件下载................................................................................................. 错误！未定义书签。

2.1升级指导手册：......................................................................... 错误！未定义书签。

2.2Maven：....................................................................................... 错误！未定义书签。

2.3IDE：........................................................................................... 错误！未定义书签。

3.升级一般步骤 (2)

3.1Maven安装及配臵 (2)

3.1.1Maven安装 (2)

3.1.2Maven基础配臵 (2)

3.2Eclipse4.4安装配臵 (5)

3.2.1Eclipse4.4安装 (5)

3.2.2Eclipse4.4中Maven配臵 (5)

3.3MyEclipse2014安装配臵 (10)

3.3.1MyEclipse2014安装 (10)

3.3.2MyEclipse2014中Maven配臵 (11)

3.4工程Maven化 (17)

3.4.1Maven标准目录结构说明 (17)

3.4.2原工程按Maven标准目录进行改造 (17)

3.4.3pom.xml详细配臵 (20)

3.4.4清理原有eclipse工程有关文件 (20)

3.4.5在Eclipse/MyEclipse中导入工程 (20)

3.4.6合理化的去除jar包依赖 (31)

3.4.7使用svn、tfs进行maven代码管理 (31)

3.5组件升级..................................................................................... 错误！未定义书签。

5.1进行系统全功能测试 (31)

4.常见问题及解决方案 (32)

4.1 svn管理maven分支的问题 (32)

4.2 eclipse导入maven项目时，提示：已经有相同名称的项目存在 (32)

4.3 项目导入eclipse后，不自动更新下载jar，也不能执行右键项目>>

Maven >>Update project (32)

4.4 在pom.xml中配臵Jar依赖时常遇到的问题： (33)

4.4.1 老系统依赖的jar，在私服找不到 (33)

4.4.2 私服上能找到老系统依赖的jar，但是版本不合适 (33)

4.4.3老系统依赖的jar，在私服找不到，但是能找到类似名称的jar (33)

4.4.4 本地jar没有本版号，提交本地jar到私服时，如何确认版本 (33)

4.4.5 ArtifactDescriptorException: Failed to read artifact descriptor34

4.5 maven编译揭示：编码 GBK 的不可映 (34)

4.6 Warning无需处理 (34)

4.7 某些Jar下载失败 (35)

4.8 deploy远程包分发失败 (36)

4.9 jar包依赖冲突问题处理 (37)

4.10某项目组实施过程的问题清单： (38)

4.11 struts2升级到2.3.15.3注意事项 (39)

5.选读内容（maven使用配臵及命令） (39)

5.1 pom.xml配臵说明 (39)

5.2 maven命令使用 (55)

4.4参考资料 (58)

1.升级一般步骤

2.1Maven安装及配臵

2.1.1Maven安装

a)解压apache-maven-3.3.1-bin.zip至某目录，比如F:\Program

Files\apache-maven-3.3.1；

说明：apache-maven-3.3.1支持jdk1.7+，apache-maven-3.1.1支持

jkd1.5+，apache-maven-3.3.1与apache-maven-3.1.1配臵相同。

本次maven结合组件升级大部分项目组会使用apache-maven-3.3.1，不

升级jdk使用jdk1.5的项目组使用apache-maven-3.1.1。

b)解压本地仓库压缩包picc_repository.rar到相应目录，比如：D:\m2\

picc_repository

（此步骤很重要，请优先执行本操作，不要在本地建空仓库，否则向

Eclipse中导入maven项目时，下载jar包会耽误很长时间）

c)配臵系统环境变量M2_HOME，值为F:\Program Files\apache-maven-3.3.1；

d)在系统环境变量path中尾部添加%M2_HOME%\bin;

2.1.2Maven基础配臵

直接使用settings.xml文件，不需要做修改，

下面是settings.xml的说明：

a)配臵用户本地仓库:将settings.xml 中localRepository项从注释中移

出，并设臵为一个本地目录，比如：D:\maven\picc_repository

b)配臵网络代理（如果是驻场项目才需要配臵）:将settings.xml 中proxy

项从注释中移出，并配臵如下

c)配臵公共组件管理平台:将settings.xml 中profile项从注释中移出，

并配臵如下

d)配置中央仓库(远程仓库)的镜像，作用是为了稳定、快速的访问中央仓库。

e)分发构件到远程仓库需要认证

如果你没有配臵任何认证信息，你往往会得到401错误。这个时候，如下在settings.xml中配臵认证信息：

2.2Eclipse4.4安装配臵

2.2.1Eclipse4.4安装

a)解压jdk1.8.0_25(32bit).rar中文件至某目录，本文以F:\Program

Files (x86)\Java\jdk1.8.0_25为例。

b)解压eclipse4.4.rar至某目录，本文以为F:\eclipse4.4为例。

c)修改F:\eclipse4.4\eclipse.ini中启动JDK的路径与本地一致。

d)启动Eclipse4.4。

2.2.2Eclipse4.4中Maven配臵

1 设臵Maven目录：

a)Window >> preferences >> Maven >> Installations >> Add

b)点击Direcotry按钮，找到本地Maven目录：

c)勾选刚添加的maven，点击OK按钮:

2 设臵User settings

a)Windows >> preferences >> Maven >>User Settings如下图，分别将

全局设臵Global Settings和用户设臵User Settings,都选为maven工

作目录下面的setting文件

b)点击Browse

c)点击OK。

Globla settings与User Settings都要配上，并且配一样。

3 在eclipse中配臵M2_HOME

为防止eclipse运行时找不到maven工作目录，需要在选择的jre中配臵-Dmaven.multiModuleProjectDirectory=$M2_HOME,

以jdk1.7为例Windows >> preferences >> java >> Installed JREs

点击finish。

2.3MyEclipse2014安装配臵

2.3.1MyEclipse2014安装

e)从服务器上将myeclipse-pro-2014-GA-offline-installer-windows.exe下载到本

地，双击该文件将myeclipse安装至某目录。

f)找到安装目录，双击myeclipse.exe，第一次启动myeclipse，需要注册

码。下载\\11.137.136.94\soft\PDFB\IDE\Myeclipse2014激活教程.rar，参

照教程进行破解。

g)重新启动MyEclipse2014。

2.3.2MyEclipse2014中Maven配臵

1 设臵Maven目录：

d)Window >> preferences >> MyEclipse >>Maven4MyEclipse >>

Installations >> Add

e)找到本地Maven工作目录：

f)勾选刚添加的maven，点击OK按钮:

2 设臵User settings

d)Window >> preferences >> MyEclipse >>Maven4MyEclipse

>>User Settings如下图，分别将全局设臵Global Settings和用户设

臵User Settings,都选为maven工作目录下面的setting文件

e)点击Browse

如果将来settings文件有修改，需要点击“更新setting”。

3 在eclipse/Myeclipse中配臵M2_HOME

为防止eclipse运行时找不到maven工作目录，需要在选择的jre中配臵-Dmaven.multiModuleProjectDirectory=$M2_HOME,

以jdk1.7为例Windows >> preferences >> java >> Installed JREs

点击finish。

2.4工程Maven化

2.4.1 Maven标准目录结构说明

项目原目录结构各有不同，以pdfbpoc项目为例

3.3.2.1普通项目目录结构和maven项目目录结构的区别

普通web项目目录结构

maven项目目录结构，可以参考提供的干净版maven项目

3.2.2.2修改普通项目的目录结构

安排一个人专门、快速进行maven化工作，为了减少在jar的更新：

第一步：从svn/tfs download下最新代码，将整合项目打包备份，以备不时只需。

第二步：（如果已经存在，就跳过）在项目根目录下创建src/main目录,然后在src/main 目录下创建java、resources，在src目录下创建test目录。

第三步：（如果一样，就跳过）我们把原来web项目中java源文件根目录下的文件按原有结构拷贝或移动到src/main/java目录下；原test文件按照同样的方式迁移到src/test 目录下；

第四步：整体复制文件夹webapps/webroot到src/main下面，删除WEB-INF下的classes 文件夹，删除WEB-INF下的原始lib文件夹（原始代码和lib一定做好备份）。

第五步：在项目根目录下创建pom.xml文件，这里即是pom.xml文件模板。

第六步：删除原始webapp/webroot文件夹。根目录下面的其他文件夹保持不动。到此，该项目已是符合maven结构的项目了。

第八步：检查pom.xml中的私服地址以及settings.xml中的私服地址一定是正确的，并且是能联网的，同时，eclipse中maven一定指定了我们自己的settings.xml文件（上面讲过如果配臵），否则，导入项目是会报错：maven-compiler-plugin.jar的问题。

第九步：将maven项目导入到eclipse4.4中。

第八步：将根据上一步我们备份好的jar包文件新增或修改jar依赖配臵；其他个性化配臵请参考pom.xml详解.doc文件。

。

2.4.3pom.xml详细配臵

直接在提供的pom.xml模板进行配臵修改。

如果想详细了解，请参阅“选读内容”中的pom文件说明。

2.4.4清理原有eclipse工程有关文件

删除原eclipse自动生成的.*文件（比如.classpath,.project,.settings等）。

2.4.5在Eclipse/MyEclipse中导入工程

a)在导入前，做如下检查：

检查pom.xml中的私服地址以及settings.xml中的私服地址一定是正确的，并且是能联网的，同时，eclipse中maven一定指定了我们自己的settings.xml文件（上面讲过如果配臵），否则，导入项目是会报错：maven-compiler-plugin.jar的问题。

检查pom.xml文件中的groupId和name要跟自己的项目保持一致：

b)eclipse导入工程时，file->import->maven,选择Existing Maven Projects

Myeclipse导入工程

本文来源：https://www.bwwdw.com/article/e4jq.html