跳到主要内容
版本：v9

IDE 使用之 Eclipse IDE

<< 回到上一步：开发环境搭建

视频教程​

本文介绍如何完成春松客服开发环境的搭建，面向企业/开发者提供关于春松客服二次开发的相关知识，从入门到掌握全部开发技能请学习《春松客服大讲堂》。

安装和下载 Eclipse​

下载安装包​

安装 Eclipse：https://www.eclipse.org/downloads/ 本文下载时，版本为：Eclipse IDE 2021‑09

下载 Eclipse

下载过程大约需要 10 mins。

安装 Eclipse​

双击安装包，按照提示进行安装。

安装 Eclipse

安装 STS​

STS 最简单的安装方式，就是启动 Eclipse 后，在 Eclipse Marketplace 中安装。

打开 Marketplace。

Marketplace。

搜索，Spring Tool Suite。

Spring Tool Suite

点击【Install】。

Install

至少选择以上几项，在授权声明页面，选择 【I accept】，点击【Finish】。 安装过程可能会持续半个小时，视网络情况。

STS 安装完成，下一步导入项目。

导入项目​

初始化 Contact Center 项目描述文件​

春松客服提供初始化脚本，在命令行执行：

cd cskefu.osc/contact-center
./admin/gen-eclipse.sh

完成后有如下提示：

导入项目

该命令生成了被 Eclipse 识别的项目导入文件。

导入到 Eclipse​

打开 Eclipse，选择 File - Import, 导航到 cskefu.osc/contact-center/app，点击 【Select Folder】。

导入到 Eclipse

在提示界面，选择 Projects: contact-center.

选择项目

导入完成。

导入完成

启动和调试​

设置 JDK 为 Corretto 8 或 11​

在上一篇《开发环境搭建》文档中，介绍安装 Corretto 8 或 11，此时，需要将该 JDK 设置为 Eclipse 中 contact-center 项目依赖的 JDK，方法如下：

首先，在左侧 contact-center 右键，选择 Build path, configure Build Path ...

设置 Build path

然后，选择 Add Library, JRE System Library。

Add Library

然后，添加 JDK 8 路径。

设置路径

点击 【Finish】。确认依赖 JDK。

添加完成，回到 Java Build Path 配置页面，确认 Libraries 中，依赖了 Corretto JDK。

确认 SDK

修改配置文件​

在目录中添加 application-dev.properties 文件

具体操作，复制 contact-center/src/main/resources/application.properties 为 /contact-center/src/main/resources/application-dev.properties。

根据数据库信息，或其它信息进行必要的更改。

参考上一篇《开发环境搭建》里的内容。

创建项目 debug 调试​

点击 Debug 启动按钮下拉中的 Debug Configurations, 在左侧找到 Spring Boot App，右键，选择新建配置。

启动 Debug

在配置页面，填写应用名称：contact-center - Application，project 选择 contact-center, Main Type 选择 com.cskefu.cc.Application。

然后点击 Environment，点击 Add 添加：Name - SPRING_PROFILES_ACTIVE， Value - dev，字符串无空格。

设置环境变量

点击【Apply】。然后点击【Debug】。

此时，滚动出大量的日志。

查看日志

调试项目​

在项目提示： c.c.socketio.SocketIOServer - SocketIO server started at port，代表项目启动成功。

断点调试的基本知识​

第一步： 设置断点：在该行最前面边框双击 或快捷键：Ctrl + Shift + B

第二步： Debug 运行启动

第三部： 运行到断点后，使用快捷键F5，F6，F7单步执行。

  • F5 - Step into/跳入方法/进入该行的函数内部；
  • F6 - Step over/向下逐行调试/一行一行执行；
  • F7 - Step return/跳出方法/退出当前的函数；
  • F8 - 直接跳转到下一个断点。

更多相关内容参考网络文章​

Trouble Shooting​

报错：com.sun.net.ssl.internal.ssl.Provider​

日志

解决办法：

日志

  • 修改 Project JRE 为前面安装的 Java8 JRE

修正中文显示​

解决办法详细介绍。

显示中文

下一步​

回到上一步：开发环境搭建完成后续步骤。