技术平台

# 开发环境搭建

本篇的开发环境特指Java开发环境，后端环境需要依赖Jar包才能调用到需要的类。我们的开发环境搭建，通常就两种：一种是基于Maven的环境，一种是无Maven环境。

# 有Maven搭建环境（主推）

致远标准产品Jar包均使用内部Maven仓库管理，基于Maven搭建环境是最高效的方案。

对于二次开发用户，我们要求使用致远CTP Studio代码托管平台开发，此平台具备完整的环境搭建能力。

# 基于CTP-Studio搭建

CTP-Studio是致远面向合约客户的定制开发代码托管平台，如客户与致远签订了客开合约，则致远会负责在平台开通托管项目。为了保障安全性，代码托管平台由内网管理，外网访问需要通过致远开通VPN权限。

致远提供了ctp-studio平台供一线进行客户化开发，ctp-studio完成了源码分权控制、帐号统一管理、Maven化、代码统一管理的能力。

标准客开请统一按照致远客开总部关于CTP Studio的要求进行相关源码申请、帐号开通、环境搭建。

# 基于Gitlab搭建

内部研发采用Gitlab私服平台进行代码管理，结合Maven仓库完成快速搭建。

# 配置Gitlab

1、首先需要安装 Git GUI，Git各平台安装包下载地址为：http://git-scm.com/downloads

2、Git GUI安装完成之后，通过鼠标右键运行Git Bash Here，分别执行以下两句命令：

git config --global user.name "你的真实姓名" 
git config --global user.email "你的邮箱地址"

3、下面是获取本机的SSH Key，将其配置到gitlab代码管理平台上，配置之后，本地连接gitlab平台就无需再输入帐号密码了。以下操作也使用Git Bash命令窗口完成。

4、首先确定本机是否生成过sshkey：在C:\Users\Administrator目录下确认是否有.ssh文件夹，打开这个.ssh目录会看到id_rsa和id_rsa.pub。

5、如果未生成.ssh则执行生成公钥和私钥的命令ssh-keygen -t rsa并按回车3下（为什么按三下，是因为有提示你是否需要设置密码，如果设置了则每次使用Git都会用到密码，一般都是直接不写为空，直接回车就好了）。

ssh-keygen -t rsa

6、使用Git Bash执行查看公钥的命令

cat ~/.ssh/id_rsa.pub

1650166359109.png

7、将这段公钥复制粘贴到gitlab中：Settings->SSH Keys里面（公钥以ssh-rsa开头，末尾去掉回车）

1650166386392.png

# 拉取Gitlab工程

1、访问Gitlab，找到有权限的工程， 选择“克隆”>>“使用 SSH 克隆”，拷贝该工程的SSH地址：

2、回到本机，自己准备一个放置代码的目录，在目录下同样通过Git Bash命令窗口执行git clone命令将代码拉取到本地：

git clone git@gitlab.seeyon.com:cdp/apps-task.git

1650166406902.png

3、完成git clone之后，能在本机代码目录下见到clone下来的工程目录

1650166424550.png

# 使用Eclipse搭建环境

下面使用Eclipse搭建开发环境，本示例是通过Eclipse的Git插件直接将Gitlab私库代码拉取到工作目录。

1、首先是配置Maven仓库文件，在Windows->Preferences->搜索maven->User Settings中自定义配置前面新建的这个settings.xml。

注意：这里的settings.xml不是随便找的，一定是与项目Maven私库相关联的配置文件，这个文件一般内部相互流传。

2、Eclipse选择File->Import->Git->Projects from Git(with smart import)->Clone URI->仅输入URI即可->选择自己想要Clone的分支到本地->设置本地仓库位置->下载即可。

采用smart import能保证Eclipse自动识别工程类型，比如看到pom.xml则自动转换为maven目录结构

1650166456767.png

1650166465654.png

1650166473727.png

3、以上操作完成后，Maven插件理论会自动下载当前工程所需的jar包。

如果Maven未执行拉取，则通过选中pom.xml>鼠标右键Maven>Update Maven Project点击确定刷新工程依赖。

# IntelliJ IDEA搭建环境

下面使用IDEA工具搭建开发环境。

1、首先是配置Maven仓库文件，通过File>Settings>搜索Maven，找到配置user setting的文件，保存即可。

注意：这里的settings.xml不是随便找的，一定是与项目Maven私库相关联的配置文件，这个文件一般内部相互流传。

1650166493423.png

2、如果是新建的projects空间，先设置当前空间的JDK版本，通过FIle>Project Structure>Project Settings>project设置Project SDK为“jdk1.8”；设置project language level为8。

3、导入Gitlab工程：在上一步Project Structure界面选择Modules>选择Import Module，找到刚才git clone下来的工程目录，以Maven的形式导入。

1650166509407.png

4、初次搭建开发环境，需要等待一段时间，以上操作完成后，IDEA会自动拉取该工程所依赖的所有jar文件。

如果没有自动拉取依赖包，则可以选中pom.xml文件，鼠标右键>Maven>Reload Project来加载依赖包。

5、上一步完成之后，尝试Build编译一下本地工程：Build导航菜单>执行Build Module “工程”操作。最终编译结果生成在：你本地的Gitlab工程目录\target\classes下面。

6、V5工程非常多，如果你有多个工程权限，可以在一个IDEA Projects空间中导入多个工程。操作方式重复3、4、5步即可。

1650166528495.png

# 无Maven搭建环境（不推荐）

在早期版本，没有经过Maven控制，或者当前环境非常特殊，拿不到Maven仓库配置，故只能采用无Maven方式搭建环境。这类场景下，搭建开发环境的思路则是：直接依赖jar包完成。

无论哪种IDE开发工具，首先需要安装一套完整的OA服务，可以自己本地安装，也可以从正式服务器获取。搭建环境时需要从OA服务中依赖必要的jar包。

1714301917155.png

# Eclipse环境搭建（无Maven）

以下示例为基于Eclipse开发工具搭建环境：

1）通过Eclipse创建一个空的Dynamic Web Project，Runtime运行时环境需要依赖Tomcat和JDK：

Tomcat不用自备，第一步安装好的V5服务就是一个标准的Tomcat，选择本地安装好的V5服务Apachejeetspeed文件夹即可。

JDK是根据不同Tomcat版本做选择：比如Tomcat6对应JDK6，而本例Tomcat8.5则是JDK8，JDK开发自备。

1714301964164.png

2）一个Dynamic Web Project基本配置如下：

1714301978036.png

3）下一步，对工程添加Jar包依赖：

首先Tomcat中间件和JDK的依赖已经在创建Dynamic工程的时候引入。

下一步是引入V5需要的所有Jar，这些Jar位于OA服务A8\ApacheJetspeed\webapps\seeyon\WEB-INF\lib文件夹下，使用Add Extenrnal JARs的方式引入该目录下全部jar包。

1714301993287.png

4）尝试是否能引用到OA相关API：如下图所示，可以建一个Java类，尝试引用com.seeyon下面V5的API，如果下图所示引入成功，则说明环境搭建完成。

1714302009111.png

# IntelliJ IDEA环境搭建（无Maven）

以下示例为基于IDEA开发工具搭建环境，本次演示条件是“有一个源码工程，但没有Maven”的场景，看下如何搭建。

1）假设只有一个apps-task工程，但我没有该工程所依赖的Maven环境，也download不到相关依赖包。

1650166558423.png

2）基于以上背景，我们还是要首先安装与这个工程相匹配的OA服务环境，我们需要依赖这个OA服务下的jar包文件，安装过程在这里略过。

3）如果IDEA是新建的projects空间，先设置当前空间的JDK版本，通过FIle>Project Structure>Project Settings>project设置Project SDK为“jdk1.8”；设置project language level为8。

同时通过File>Setting>Java Compiler设置确保项目是JDK8编译。

4）在上一步Project Structure界面选择Modules>选择Import Module，找到刚才git clone下来的工程目录，同样以Maven的形式导入。

虽然无法成功连接Maven私库，但这样做的目的是让工程在IDEA中以Maven约定的结构展现。

1650166587928.png

5）为了确保编译成功，通过FIle>Project Structure>Modules选中当前项目，在右侧选择Dependencies引入Jar报依赖，需要分别引入Tomcat和安装好的OA下的WEB-INF\lib所有jar。

1650166604934.png

6）最后Build工程，如果发现还有编译报错就确认自己哪里弄错了。如果是test目录下的单元测试编译不通过，建议删除单元测试模块代码，像TestCaseBase的依赖只有Maven私库才有。

# 扩展资料

# Eclipse重要插件

# decompiler反编译

  • Eclipse Marketplace搜索decompiler，安装enhanced class decompiler
  • 重启后Preferences中搜索File Associations可查看反编译设置，设置.class without source文件defualt以decompiler插件启动

# FileSync文件同步

  • Eclipse Marketplace搜索搜索file sync，安装FileSync
  • 使用场景：将Eclipse中的project代码同步到本地OA服务器对应目录下

1650166625862.png

# ResourceBundle Editor国际化插件

  • Eclipse Marketplace搜索i18n，安装ResourceBundle Editor
  • 使用场景：同级目录下同名不同语种的国际化properties可以一同编辑修改自动排序

1650166644599.png

# IntelliJ IDEA推荐插件

插件搜索和安装方法：IDEA > File > Settings > Plugins

# 通义灵码

通义灵码，一款基于通义大模型的智能编码辅助工具，提供行级/函数级实时续写、自然语言生成代码、单元测试生成、代码注释生成、代码解释、研发智能问答、异常报错排查等能力，并针对阿里云 SDK/API 的使用场景调优，为开发者带来高效、流畅的编码体验。

安装方式：Marketplace应用市场搜索“tongyi”，找到TONGYI Lingma，安装即可。

1713949696921.png

创建人：admin
修改人：het、admin

快速跳转

← 代码管理Git&SVN →