O2OA自定义服务-搭建自定义工程及开发（都把工程模块跑起来~）

说明：此篇文章只是为了把工程模板跑起来，因为第一次尝试中里面遇到了很多报错和问题，特记录在此，可供参考！

---

前言

前两节主要是工程模板的说明，详情可参考官方文档，第三节是本文重点内容

---

一、开发环境

• JDK 11
• maven V3.5+
• 运行环境 o2server V6.1及以上

二、搭建工程及配置

1. 工程模板下载：https://git.o2oa.net/o2oa/o2custom-sample/-/archive/master/o2custom-sample-master.zip
2. 解压o2custom-sample-master.zip，然后重命名文件夹名称为自己业务相关的名称（如：o2custom-sso）（修改了名称后，代码中其他地方也需要修改，具体参照官方文档）
3. 打开系统命令窗口（cmd），进入到2步骤的文件夹，然后执行mvn install（第一次需要下载很多依赖包比较慢），直至BUILD SUCCESS。（这里也许会出现问题，在下一节的问题总结中我会详细说明）
4. 使用idea或者eclipse导入工程（eclipse导入之前先执行mvn命令：mvn eclipse:eclipse）
5. 工程目录解析：
   store目录存储mvn install命令后打包的war包和jar包，其中x_base_core_project.jar包为系统包，不能删除（打包时需要）；
   x_program_center目录打包时生成，可以直接删除；
   x_sampleproject_assemble_control为业务应用工程，所有业务代码都写在这里；
   x_sampleproject_core_entity为实体类工程，如果业务不需要与数据库交互可以删除此工程。
   

三、问题总结

1. 在搭建工程及配置中的第三步也许你的maven会出现问题：比如控制台提示：mvn不是内部或外部命令，也不是可运行的程序或批处理文件，那么这里是因为你的maven未下载，或者是maven没有配置环境变量，这里提供一篇文章可供参考学习即可解决问题maven的下载安装配置教程（详细图文），在cmd中输入mvn -v 出现版本号即可。
   
2. mvn install没有效果？或者一直报错？
   
   

那就不用这种方法，其实之所以这么做的目的就是为了把工程模板中所需的maven放入中心仓库中，我们可以采用另一种方式达到同样的效果；
① 下载一个完整的开发平台，这里用6.2.2.Java8来进行举例说明，因为我本机只装了1.8的JDK（注意版本号要匹配） ，在官方文档中有详细的说明，以及B站有相关的视频介绍，还有源码编译-O2Server服务器源码编译教程（建议跟着视频做，但是如果出现报错，查看报错信息很大可能是因为源码和你的JDK版本不匹配）

② cmd输入命令node -v、java -version、mvn -v检查是否装配了node、JDK、maven

③ 源码编译成功后就会产生可运行的服务器(下图所示)

那么这时在maven的中心仓库中也有了相关的jar包


出现这两个文件表示已经编译成功，后面我们使用工程模板的时候只需要在pom文件中修改version即可完成。

④ 修改工程模板中的版本号，就是maven中存在的o2oa的版本。其他地方的版本也依次修改为这个版本即可

	<parent>
		<groupId>o2oa</groupId>
		<artifactId>o2server</artifactId>
		<!-- <version>6.1</version> -->
		<version>6.2.java8</version>
	</parent>

补充：如果完成以上步骤后，pom文件中没有报错，其他文件也没有报错，但是maven中还是缺少依赖，不要紧的，只要我们的o2oa没有问题，是可以打包成功的。

右击项目，执行mvn install

结果为BUILD SUCCESS即表示，工程模板成功跑起来了！！！

以上是我遇到的问题，特写文章记录解决流程，如果可以帮助到您当然最好不过了。