请上传宽度大于 1200px,高度大于 164px 的封面图片
    调整图片尺寸与位置
    滚轮可以放大缩小图片尺寸,按住图片拖动可调整位置,多余的会自动被裁剪掉
取消
Alex-ce(uid:65456)
职业资格认证:尚未取得认证
插件开发---菜鸟入门及坑点全解
亲们,最近是不是看到传说哥发了很多插件开发招标,但想做又找不到方向?或者做到一半又各种坑?现在,我亲自经历的坑点教程来啦~~~大家一起来拍砖~~不对,一起来撒花~~{:4_260:},废话不多说,下面都是坑。。 一 开发环境搭建和Debug 开发工具:Intellij IDE v15 (本来想用eclipse的,但我按传说哥的那个eclipse搭建教程实在不行,所以还是用这个吧) JDK: 1.8 (JDK怎么装这个就不要写了吧,自己度娘去) 安装好后,首先去把源码clone下来。在这里要说一下,论坛里也有教程是教大家直接新建一个插件的工程,然后再引用fineReport的核心包。这样也行,但个人觉得还是看一下源码比较好,这样对我们理解fineReport的类结构和实现逻辑有很大帮助;其次,FR的API说明文档真的很坑爹啊,说明简单到简直是惜字如金啊,看了没有看一个样啊(要变身咆哮哥的节奏~~)。所以,还是看一下源码吧~ 源码的下载(点击这里)跟配置方法看这个链接(点击这里)。注意:这里有两个坑!! 1.进行到上面教程的第四步的时候,也就是配置好class输出路径的时候,你会发现有一大堆红点!! 34514 没错,聪明的你发现有个setup sdk,这里是要设置java的JDK。大胆点击进去,你就会弹出一个框让你选择JDK安装路径(我的是C:\Program Files\Java\jdk1.8.0_66)。选择后就会发现红点都消失啦。 2.上面教程的第12步,要在plugins文件夹里再新建一个文件夹保存plugin.xml,一定要新建一个文件夹,新建一个文件夹,新建一个文件夹(重要事情说三次),一个插件一个文件夹,不是直接把plugins放在里面,这样是不行的。 好了,上面的教程你通过而且没有任何问题的话,你可以入手开发了。这时候你可能想骂娘了,TMD这源码我看都看不懂啊,那个组件的代码在哪里都不知道,开发条毛线啊(摔~)!!!不急,大神们早就想到你们这小样,已经给了查找目标组件代码的解决方法(点击这里),而且也给了很多现成的插件源码例子(点击这里),可以找一些跟你开发相关的插件来看(TMD一大堆我怎么知道那个是我需要的啊~~这,你调戏传说哥去吧,他应该知道(传说哥别拿板砖拍我啊~~{:4_120:}))。 二 插件工程及配置文件分析 1.plugin.xml文件配置 经过上面的行动,你已经有信心开始入手开发了,这时候我们开始新建一个插件Module,配置plugin.xml文件,配置文件的各个节点意义可以看这里。 可能有哥们说,看完我不知道有什么用。呵呵,我不会笑你的,因为我看完了也不知道。所以我加了下面两个图作对比: 34523 34522 图1是我本地的plugin配置文件,图2是安装这个插件后显示的信息,可以很清楚的看到,在changenote之前的定义的元素就是用来显示安装后的信息,,, 这三个才是我们插件程序需要使用的加载入口,当然,按照大神们写的节点说明,可用的加载入口有六个,分别对应不同模块,而class的值就是我们写的插件目标类,以我写的为例子,里的LocaleFinder用于加载国际化资源,里的CellAttributeProvider就是我的插件初始化入口。 有哥们可能会说,我直接复制你的下来改,怎么还不可以初始化我写的插件!!来,哥给你列一下坑点: A. 你加载的模块入口选对了吗?extra-core里的东西不可以用extra-designer来加载,首先要找到正确的加载入口。不知道是那个?请教插件群里的大神吧。 B. 你加载的标签写对了吗?同样是extra-core模块,但有多个加载标签,LocaleFinder用于加载国际化文件;JavaScriptFileHandler用于加载js和css;而且一个模块可以有多个加载标签,你写对了吗?如果不知道,请教群里的大神吧。如果有下载源码,也可以自己加载类的顶级接口,例如我写的这个CellConditionAttributeTableProvider,它的顶级接口为CellAttributeProvider,里有个MARK_STRING = "CellAttributeProvider"的字段,这个值就是加载的标签。 C. 你更新了WebReport/WEB-INF/plugins对应文件夹里对应的plugin.xml文件了吗?上一个大坑里的第二个小坑你还记得吗?里面的plugin文件要跟插件里的文件同步,要不然你改得飞起都没用。 2.properties文件配置 ok,上面的坑你都跳过了,开始进入调试,但你发现你在国际化文件里配置的property都只是显示key而已。不用问,肯定是加载国际化文件的类里获取配置文件方法有问题啦,正确的应该如下图所示: 34526 注意,上面find方法获取的值只要写到properties的前缀就可以啦,记得不要写后缀哦~~ 三 打包测试及发布 1.打包 经过你一夜的通宵搬砖,你把插件代码捣鼓完了。恭喜你已经完成了一半。现在就要进行打包测试,用ant的打包教程可以看这个,如果不想这么麻烦,也可以学坛友wzh5788教我们的另一种打包方法,就是找一个原来打好的jar包,用解压的方式打开并替换里面的class文件,如下图: 34528 (此图版权归@wzh5788 所有) ps:记得换上你自己的plugin.xml文件哦 打包出jar后,将它和你的plugin文件一起压缩成一个zip,注意,plugin.xml不是打进jar里面的,而是要放在jar外面。 2.测试 打包好之后我们要进行本地测试一下,打开fineReport设计器(这个不是指我们启动源码工程的设计器,而真正安装的FineReport),然后点击服务器,选择插件管理, 34529 进入后选择第三个tab下面的 从本地安装 ,如图: 34530 之后会弹出一个重启生效提示,确定后就可以重启进行插件测试了。 3.发布 发布比较简单,首先在论坛的左上角那里进入 应用中心,登录后进入 用户中心,在左边的菜单可以让你注册成功开发者,注册ok后跟传说哥说让他审核,通过后你就可以看到发布插件的菜单。这里就不详细说了。 四 后话 经过上面的一大堆后,你就可以等审批通知啦。从个人来说,过程虽然繁杂,但并不是什么困难,只要按步骤做好就可以了。此外群里也有很多大神,很多问题他们都会非常耐心的给你们解答,在这里我也要对他们和传说哥表示感谢,因为如果没有他们的帮助,我们这些新手肯定要走很多弯路,再次感谢。其次还有个小建议,就是API文档说明可以弄详细点更好,因为我们不可能每个方法都去问,而有文档的帮助可以大大提高新手对源码的理解程度(就像我当初看了半天都不知道populate()是更新显示而update()是保存。。。{:4_102:})。最后,祝大家搬砖顺利{:4_120:}
个人成就
内容被浏览24,708
加入社区8年48天
返回顶部