Java开源企业信息化平台O2OA服务器源码如何编译和使用？[Windows环境]

论坛管理员

O2OA在github上开源了平台源码，用户可以Fork源码，并且自己进行服务器编译，打包。也支持对源码自行进行修改后进行服务器打包。
因为在github上Clone源码实在是太慢了，所以我们也可以使用国内的仓库gitee[码云]来下载，速度会快很多。
具体步骤如下：
一、Fork源码到自己的gitee仓库

1、访问O2OA项目的gitee仓库：https://gitee.com/liyihz2008/O2OA

2、点击Fork将O2OA源码Fork到自己的gitee[码云]仓库

二、安装Github Desktop

1、下载Github Desktop：https://desktop.github.com/


三、使用Github Desktop客户端Clone源码到本地

1）查询自己的gitee仓库[码云]中O2OA项目的Clone地址

2、打开Github Desktop客户端，从自己的github仓库中clone源码
1）打开Github Desktop客户端，点击Clone a repository form the Internet...

2）在弹出的Clone a repository对话框里选择URL选项卡，填写URL和Clone到的本地地址后，点击Clone即可开始Clone项目源码：

请注意，我们建议您Clone您之前Fork到自己的gitee仓库里的源码，可以观察一下Clone的地址：
如：https://gitee.com/您的github账号/O2OA， 而不是https://gitee.com/liyihz2008/O2OA
3）正在Clone，等等Clone完成即可。如下图所示：

从Github上Clone项目比gitee上要慢很多，可能需要更多的时间。

四、配置源码编译环境

1、安装Nodejs

nodejs下载地址：http://nodejs.cn/download/ （您也可以从官网下载：https://nodejs.org/en/）

下载windows安装程序（.mis）
下载完成后直接进行安装，直接next直至安装完成即可。如下图所示：

2、安装配置maven环境

1）Maven下载地址：http://maven.apache.org/download.cgi， 下载好之后，解压并选择存放路径

2）首先打开我的电脑->属性->高级系统设置
新建系统变量：MAVEN_HOME，复制Maven的路径

在系统变量：path中复制粘贴：%MAVEN_HOME%\bin

Win+R快捷键打开命令行，输入：mvn -v，如出现以下图样，则表示配置成功


3、安装配置ant环境

官方http://ant.apache.org/bindownload.cgi下载新版（目前为Ant1.10.5）的ant，得到的是一个apache-ant-1.10.5-bin.zip的压缩包。将其解压到你的硬盘上，例如：E:\Work\apache-ant-1.10.5。
新建系统变量：ANT_HOME，复制Ant的路径，如下图所示：

在系统变量：path中复制粘贴：%ANT_HOME%\bin：

在系统变量：classpath中复制粘贴：%ANT_HOME%\lib

Win+R快捷键打开命令行，输入：ant，如出现以下图样，则表示配置成功


五、初次编译源码

下载后o2server项目源码直接导入eclipse后会有很多依赖错误，因为大量的依赖包没有编译为jar文件，所以需要先将下载后的源码中o2server项目整体编译一次。
1、打开命令提示工具，cd到o2oa/o2server目录（或者直接在o2server目录打开powersheell(win10)）
cd E:\O2\o2oa\o2server
2、在o2server目录下直接执行命令进行编译：mvn install，开始进行源码编译：
mvn install
直到编译完成（一共57个项目，视开发机性能约需5-20分钟），如下图所示：

3、打包安装程序： ant
ant编译完成后，可直接支持ant命令进行打包：

直到打包完成（视开发机性能，约5-10分钟），如下图所示：

六、使用Eclipse导入o2oa源码

注意，当源码导入到eclipse项目后，maven会从mvn repository下载所依赖的项目jar包，可能需要一些时间，视情况在5-30分钟左右。

当所有的依赖包下载完成后，eclipse里如果仍有大量报错，请在o2server项目上执行Maven -> Update Project...
七、关于Eclipse中pom.xml报错

1、关于o2server项目的pom.xml报错：

三个相对路径依赖引用引起的pom.xml报错，可以忽略，完全不影响项目编译。
2、关于x_base_core_project项目和所有的 *_core_entity 项目中pom.xml报错

maven plugin的execution出错，可以忽略，不影响项目编译。解决方案可以百度：maven plugin的execution出错，有很多解决方案发，我们的源码会在近期更新时解决此问题。

八、单独的项目编译

将项目导入eclipse后，也可以在eclipse里使用maven插件对单个的项目进行编译。
直接打开指定项目，在pom.xml上运行Run as ... -> Maven install即可，如下图所示：

编译完成后，jar 包将编译到目录：o2oa\o2server\store\jars，war包将编译到目录：o2oa\o2server\store
以上说明希望对大家有帮助。

小风同学

博主，你好，非常感谢你们更新的源代码，我已经把项目部署好，按照您的这篇文档。我想问的是，接下来我该怎么启项目并进行编码相关的操作，需要tomcat吗，是操作target里面的Oserver还是导入eclipse里项目Oserver,求解答哈