Java全开源O2OA开发平台源码编译教程

获取源码

O2OA是全开源的系统，完整的源码可以免费从gitee或者codechina获取。仓库地址是：

gitee： https://gitee.com/o2oa/O2OA.git

codechina: https://codechina.csdn.net/O2OA/o2oa.git

gitee仓库

我们打开gitee上的 O2OA仓库，可以看到源码：（操作：浏览器打开项目仓库主页）

（操作：展开分支）

我们来介绍一下几个主要有的分支：

如果你需要历史版本的源码，可以切换到对应的tag。（打开标签）

克隆源码

建议您先Fork源码到您自己的空间。

然后进入自己fork的仓库，复制克隆地址:

首先我们确保我们自己的机器上安装了git工具，如果没有的话：

windows系统可以到下面的地址下载： https://git-scm.com/download/win

centos使用命令：

yum install -y git

Ubuntu使用命令：

sudo apt-get install git

然后我们进入自己机器需要获取源码的目录，启动终端或使用git bash，输入以下命令clone源码：

git clone https://xxxxx

红色部分替换为你自己Fork的仓库地址。如：

git clone https://gitee.com/hq1980/O2OA.git

clone完成后，就可以看到O2OA的源码目录了。

编译源码

获取了源码后，我们就可以将源码编译为可运行的O2OA服务器了。

准备编译环境

在编译源码之前，我们需要准备编译环境，O2OA编译需要以下环境：

上述环境安装，在此就不赘述了。

切换到要编译的分支

环境准备好后，我们打开终端或windows的命令行提示符，进入O2OA源码目录。默认情况先，现在是主分支，就是develop分支，如果我们需要编译其它分支，通过以下git命令切换，如切换到master分支：

git checkout master

编译

切换到您需要的分支后，需要先使用npm安装编译脚本所需要的依赖包，使用以下命令安装：（安装过程可能需要几分钟）

npm install

如果没有安装过gulp和jsdoc，需要先执行以下命令安装：

npm install -g gulp-cli
npm install -g jsdoc

然后就可以使用以下命令编译了：

npm run build_ci

整个编译过程大概需要30分钟。编译完成后，会在目录下生成target/o2server目录，这就是可运行的服务器目录。可以将它拷贝到服务器，运行相应start_xxx命令就可以运行O2OA了。这个等会编译完成后，我们再看。

优化编译

等待编译过程中，我们可以先介绍一下不同的编译命令，以及优化编译速度。

编译特定操作系统版本的O2OA

如果我们要编译指定操作系统版本的O2OA，可以使用以下命令：

#编译windows版本
npm run build_ci:win

#编译linux x86版本
npm run build_ci:linux
                
#编译aix版本
npm run build_ci:aix

#编译linux arm版本
npm run build_ci:arm

#编译windows版本
npm run build_ci:macos

#编译linux mips版本
npm run build_ci:mips

#编译树莓派版本
npm run build_ci:rpi

编译脚本功能清单

编译脚本的功能清单如下：

源码文件结构解析

趁服务器编译的过程，我们简单介绍一下源码文件结构。（打开gitee项目主页）

更目录下主要文件和目录：

o2web目录结构说明

前端的源码都放置在o2web目录，其中代码部分都在o2web/source/目录下，其他一些是相关的配置和打包脚本文件，所以我们简单介绍一下o2web/source/目录的内容

o2server目录结构说明