关键词:源码编译,O2OA,O2Server,编译教程
O2OA是真正全代码开源的应用开发平台,开发者可以直接使用从github或者gitee上clone的源码编译成服务器,代码可以修改,安全可靠,无限制。本文主要介绍如何从gitee上下载源码并且完成服务器编译打包工作。
O2OA在github上开源了平台源码,用户可以Fork源码,并且自己进行服务器编译,打包。也支持对源码自行进行修改后进行服务器打包。
O2OA项目的Github仓库:https://github.com/o2oa/o2oa
因为在github上Clone源码实在是太慢了(60-600KB/S左右),所以我们也可以使用国内的仓库Gitee[码云]来下载,速度会快很多,通常在(10MB/S左右)。
**
具体步骤如下,以Gitee为例,其实Github也是相同的操作方式:
一、Fork源码到自己的Gitee仓库
1、访问O2OA项目的[码云]Gitee仓库:https://gitee.com/o2oa/O2OA
2、点击Fork将O2OA源码Fork到自己的gitee[码云]仓库
二、安装Github Desktop
**
下载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/o2oa/O2OA
3)正在Clone,等等Clone完成即可。如下图所示:
从Github上Clone项目比gitee上要慢很多,可能需要更多的时间。
四、外部依赖目录下载
外部依赖下载:https://download.o2oa.net/download/commons/commons.zip
源码在经过编译打包成服务器后,运行时需要依赖一些jar包,这些jar包应该放在o2oa/o2server/commons目录下。但是因为依赖多比较多,从github和gitee上下载时时常出现下载后无法使用的问题,所以目前并没有放到github和gitee上,需要手工从官网下载解压后放入源码的o2oa/o2server目录下。
commons.zip[http://download.o2oa.net/download/commons/commons.zip]
但是这个commons.zip 包括jvm8 和jvm11,有点大,如果建议可以下载
http://download.o2oa.net/download/commons/commons_jvm8.zip
http://download.o2oa.net/download/commons/commons_jvm11.zip
解压的文件夹要命名为commons
具体的目录结构,可以参考从官网下载的可运行的服务器的实际目录解构
或者在官方提供的百度云盘中也可以下载:
百度网盘下载:https://pan.baidu.com/s/1oBQ1atXGyXdLaYE5uAqF1w 提取码:pnk9
五、JVM下载
**
与外部依赖的原因类似,所有的JVM全部放到源码仓库将会是巨大的下载开销,所以官网提供了各种源码的下载,需要手工从官网下载解压后放放源码的o2oa/o2server/jvm目录下(如果没有该目录请自行创建该目录)
JVM 下载
- AIX:https://download.o2oa.net/download/jvm/aix.zip
https://download.o2oa.net/download/jvm/aix_java11.zip - Linux x86:https://download.o2oa.net/download/jvm/linux.zip
https://download.o2oa.net/download/jvm/linux_java11.zip - MacOS:https://download.o2oa.net/download/jvm/macos.zip
https://download.o2oa.net/download/jvm/macos_java11.zip - 树莓派:https://download.o2oa.net/download/jvm/raspi.zip
https://download.o2oa.net/download/jvm/raspi_java11.zip - WIN:https://download.o2oa.net/download/jvm/windows.zip
https://download.o2oa.net/download/jvm/windows_java11.zip - Linux MIPS:https://download.o2oa.net/download/jvm/mips.zip
https://download.o2oa.net/download/jvm/mips_java11.zip - linux ARM:https://download.o2oa.net/download/jvm/arm.zip
https://download.o2oa.net/download/jvm/arm_java11.zip
或者在官方提供的百度云盘中也可以下载:
百度网盘下载:https://pan.baidu.com/s/1oBQ1atXGyXdLaYE5uAqF1w 提取码:pnk9
具体的目录结构,可以参考从官网下载的可运行的服务器的实际目录解构
六、配置源码编译环境
注意一下,我们现在使用的 JDK 8 的环境,如果没有安装请安装一下java环境!
**
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、安装配置git
从https://git-scm.com/downloads直接下载,然后直接安装就行
查看安装版本git --version,如果出现版本号就是成功的
七、编译源码
1、打开命令提示工具,cd到o2oa目录
cd E:\git\o2oa
**
npm i -g gulp-cli
npm i -g jsdoc
**
npm install
不同的目标环境,选择不同的指令,该过程时间较长,请耐心等候
npm run build:win
npm run build:linux
npm run build:aix
npm run build:kylinos
npm run build:macos
npm run build:neokylin
npm run build:rpi
成功执行
**
注意:首次编译时可能会因为编译顺序的问题导致第一次编译过程失败,此时只需要再次运行npm run build:win(目标系统)即可完成编译。
**
八、可运行的服务器
目录:target\o2server,
启动的时候,非windows系统可能会报没有权限
需要赋予权限
chmod 777 target/o2server/*.sh
或者
chmod u+x target/o2server/*.sh