前言

注:为了保障开发环境能正常搭建起来,如果你对idea和gradle不是非常熟悉,请按照我们推荐的IDEA版本和GRADLE版本进行配置!

推荐:IDEA版本:2020.2版本、GRADLE 6.4版本(若使用其他版本,可能引起脚本不适配,需要自行按照对应版本的脚本语法修改插件工程的脚本!)


在前面两节中,我们已经成功的配置好了插件开发工程,但如何让插件在报表/BI环境中运行,还没有告诉开发者。接下来我们所有的操作,均在IntelliJ IDEA中进行,可以先打开IntelliJ IDEA的终端

如果遇到乱码:依次检查下面的配置

通过IDEA 选择 Help >> Edit custom VM Options 手动设置 -Dfile.encoding=UTF-8 后重启

绝大部分的乱码这个时候已经不会出现,如果还是有乱码再执行下面的操作


并修改idea_home/bin/idea.exe.vmoptions 和 idea_home/bin/idea64.exe.vmoptions 配置,在配置最后添加 -Dfile.encoding=UTF-8  之后重启

生成运行环境

在IntelliJ IDEA的终端中,执行命令

gradle install

等待依赖jar下载

当install任务结束时,可以看到在根目录下,已经生成了一个webroot目录,如下图所示

记住这个目录的地址,稍后会使用,我们假设这个地址为 $develop/report-starter-10/webroot。

启动设计器

找到com.fr.learn.Learner类并运行(如果是第一次运行会等待)

等待一段时间后,可以看到设计器已经启动,这里分两种情况:

1、已经安装过FineReport V10.0,这时候需要新建一个工作目录,工作目录地址为 $develop/report-starter-10/webroot/WEB-INF,并切换至该新建的工作目录;

2、没有安装过FineReport V10.0,会弹出一个配置工具目录的对话框,选择$develop/report-starter-10/webroot/WEB-INF之后点击确定即可

如果从来没有在这台机器上使用过FineReport V8.0之后的版本,则启动之后需要激活,可以访问http://id.fanruan.com注册并获取激活码。

安装第一个插件

1、关闭已经启动的设计器;

2、右键plugin-function,选择重新编译插件

注:如果右键rebuild没有在$develop/report-starter-10/webroot/WEB-INF/plugins/plugin-com.fr.plugin.function.test-1.0目录下生成对应的class,

则使用IDEA的终端,用cd命令把目录切换到 plugin-function目录下

然后执行 gradle build 即可

3、将plugin-function目录下的plugin.xml文件,复制到工作目录下插件目录中:$develop/report-starter-10/webroot/WEB-INF/plugins/plugin-com.fr.plugin.function.test-1.0;

再次启动设计器,可以通过插件管理器,看到测试函数插件已在安装列表中了

这时从单元格中打开公式管理器,可以从插件函数类别下看到插件添加进来的函数,如下图所示