源码编译-O2Server服务器源码编译教程

获取源码

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/o2oa/O2OA.git

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

编译源码

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

准备编译环境

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

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

检查当前分支是否是master分支

环境准备好后，我们打开终端或windows的命令行提示符，进入O2OA源码目录。默认情况先，现在是主分支，就是master分支，通过以下git命令检查分支

git status

编译

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

npm install

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

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

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

npm run build_ci

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

编译错误解决

如果编译的过程中出现下图错误，可通过修改maven源来解决

修改maven

<mirror>
      <id>alimaven</id>
      <name>aliyun maven</name>
      <url>https://maven.aliyun.com/repository/central</url>
      <mirrorOf>central</mirrorOf>
    </mirror>

优化编译

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

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

方法一：没有下载JVM和依赖包commons

如果您没有手工下载JVM和依赖包commons，也没有关系，我们可以使用 “build_ci:xxx” 命令：

推荐是使用此方式编译，这样可以保证编译程序找到合适的commons版本

#编译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目录结构说明