本文的目标读者是从零开发插件的新手,如果您对Java及环境配置非常了解,请直接参阅链接从了解到入门。
面对空空如也的编辑器,也许您会感到手足无措,我们要从哪里开始开发呢?帆软开源了部分代码,使得您可以快速开始插件编写。这篇文章将教您如何自己编译一个FinereportV8。
1.假设我们在C:\developer目录下存储开发工程和代码,如果没有,则自己新建一个这样的目录(当然位置和名字随意)。
2.我们需要额外的工具来帮助我们实现克隆操作(可以理解为下载),这里我们推荐git,git是一款非常棒的版本管理工具,因为帆软的代码是会随着开发进度而不断变更的,为了保证代码的同步,我们需要依赖git工具同步而不是直接下载原始文件。MacOS自带git无需安装,Windows请下载相对应的版本。
一路默认安装即可发现右键菜单中多了git的选项。这里我们以env文件夹为例,介绍如何在Windows环境下使用git克隆源代码。下面是需要克隆的地址。
我的电脑中打开C:\developer目录,右键选择Git GUI Here,在弹出面板中选择第二项clone
在第一行填入上面列表中env的地址https://git.oschina.net/fanruan/env.git,第二行填入目录名env,点击确认Clone,耐心等待片刻(注意这个过程没有进度提示)即可完成。
出现此界面即表示成功。关闭即可。
依照相同的步骤完整拷贝所有的目录,得到如下的developer文件夹。
5.打开刚才安装的IntelliJ IDEA,把project目录作为工程打开。
打开工程以后,就可以直接启动设计器了
在启动设计器的地方,我们可以看到有一个向下拉的三角,我们点开以后,可以看到三种启动方式
分别是:直接启动设计器(Designer),启动设计器界面调试(Designer4Debug),直接启动服务器(tomcat)。
其中直接启动设计器没什么好说的,就是常规的设计器启动主函数。
启动设计器界面调试时为了方便的根据设计器上的组件找到对应的代码,具体可参见这里。
直接启动tomcat则用于真实的服务器环境调试。
注意: 设计器同时只能打开一个, 如果代码启动, 没看到设计器界面出来, 就退出了, 有可能是程序没关掉。
6.点击菜单项build-->rebuild,等候工程编译,再选择直接启动设计器,可以发现是不是跟官网上下载的产品一模一样了呢。
如果出现JDK找不到的问题,需要自行配置一个名字叫1.8的JDK。