官方推荐让用户使用IntelliJ IDEA来进行插件的开发，但是作为一名用惯了eclipse 的java 开发人员，变更一种开发工具，多少有点“巧妇难为无米之炊”的感觉。工具的熟练使用， 也能帮我们在开发中起到事半功倍的效果。为了解决这个问题，笔者坚持要用eclipse来进行环境的搭建。下面就让我们进行配置之旅吧。
1.同步代码，了解代码结构。 根据官方提供的文档，首先我们要进行代码的同步。帆软的代码是在Bitbucket 平台上用git做管理的。所以我们需要用git 工具把代码同步到本地。Git 如何使用请参考官方文档。 Down下来的代码如下：
下面简单的对代码结构进行下描述，方便让你对整体有个初步认识。 | 模块名 | | | 设计器的核心代码库，包含以下四个子模块。 Designer 总的入口 designer_base 基本核心的类 designer_chart 图表相关 designer_form 表单相关 从包名上可以看出，就是根据设计器的功能，做了初步的结构划分。 | | 环境，该包下包含WebReport 目录。 WEB-INF\web.xml WEB-INF\resources --资源文件 WEB-INF\plugins --插件安装目录 WEB-INF\lib –第三方库 一看就是web工程的标准配置，所以该目录主要是web页面的报表平台的入口。以及在插件开发有些web预览功能的入口。 | | 设计器依赖的第三方库 Jetty ----jetty内置服务依赖包。这个就是从设计器内嵌jetty发布webReport web应用的依赖包 Report –--帆软设计器、报表等一些核心的依赖包 还有一些数据库驱动包、设计器桌面应用的绘制包 | | 插件开发模块，内置了两个插件例子。 plugin-charts-demo plugin-theme-green | | | | | | | | 服务器模块，就是一个免安装的tomcat-8.0.33 服务器 |
看了以上的内容，相信你已经对代码有了大致的了解。其实已经很明朗，整个项目的核心就是设计器桌面应用 + webReport的web应用。设计器通过内置jetty服务器，或者提供的tomcat等，可以发布web应用。先来看下出来后的效果吧。
设计器截图
报表平台截图：
设计器上预览功能的截图：
2.搭建eclipse工程项目。
打开eclipse项目，创建一个java应用。为了跟官方一致，我们也命名为project吧。笔者当时命名为plugins-development 。项目最后的结构是这样的。
如果你已经知道了，那就快去搭建吧。如果你不是很清楚，那我们一步一步来。 a. 创建java项目： Java需要是1.8以后，官方v8要求的。
b. 源码引入设计器代码
点击项目右键—build path—》config build path 打开构建配置面板
点击link Source按钮，找到你同步代码的目录，笔者是放在D:\JOBS\finereportnew 目录下。Design包下的designer模板的src 目录。 注意：引入的必须是src目录。会提示说 已经存在一个src 目录，那么你可以在folder name 里给src起个别名，如designer-src。
同样引入design包下其他的子模块。这样design包的四个模块源码就引入项目中了。
此时会发现有报错，是因为依赖的jar包还没有引入。那么再去点击Libraries 标签， 点击Add External JARs ，讲同步的项目里 lib 下面所有的jar包导入。点击OK。 如果发现代码还有错误，那么可能还是缺少部分jar包。笔者遇到过 POI包缺少的情况，可以自己从网上找，增加进去即可。
c. 启动设计器并指定工作目录
找到Designer.java ，右键运行该类。你可以发现启动类已经启动了。
注意：启动的过程中，会提示你要注册码。可以到官方申请，如果开发不想要那么麻烦，可以直接去代码里注释掉，即可。
第一次启动设计器，会提示你设置自己的工作目录。即需要指定webReport的目录。你可以将同步源码的WebReport/WEB-INF 目录，指定成你的工作目录。如果考虑到代码同步会出现覆盖，那么建议你复制下该目录，再指定。
再指定工作目录的时候，有人会出现如下问题，原因就是没有指定到webReport目录上，因为缺少web.xml 这样的web应用的配置文件，所以导致web页面工作不正常。 看到这里，恭喜你，你已经启动了设计器，并可以打开报表平台页面了，正如本文一开始截的图一样。
d. 下载插件demo，并导入项目源码 那么有人问了，这就出来了，那插件怎么开发啊？ 根据官方文档的说明，我们用这个例子来看下： 下载该插件源码。解压如下：
我们把src目录的内容，拷贝到我们的eclipse项目里。并把plugin.xml 和build.xml 拷贝进来，如下： 这个时候，我们就可以看下代码如何实现了，也可以修改了。插件的开发明细可参考官方文档。插件可以通过ant 打包成zip格式，从设计器上安装，也可以直接按官方的说明文档，将plugin.xml文件，放到webReport/WEB-INF/plugins/[自定义插件文件名] 目录下。
e. 配置插件，调试。
这时候，再次找到designer.java 文件，重新运行。在设计器的插入图表—》图表类型中，就可以找到该插件了。
编辑于 2019-9-13 17:49
| 
谢谢咯。
