使用 Adobe FlexPMD 审核你的代码品质

Adobe Technical Services 发布了一款称为 FlexPMD 的工具,该工具允许您审核 ActionScript 3.0 代码的品质。

FlexPMD是一种 ActionScript 工具,类似于 JavaPMD。FlexPMD 通过审核 ActionScript 3.0 或 Flex 源目录来提高代码品质。它可以检测出品质欠佳的代码编写方法,例如未使用的代码、过度复杂的代码、过长的代码使用不正确的 Flex 组件生命周期。FlexPMD 是一种 Adobe 开放源项目。

官方网站:http://opensource.adobe.com/wiki/display/flexpmd/FlexPMD

下载地址:http://opensource.adobe.com/wiki/display/flexpmd/Downloads

Hudson插件地址:http://wiki.hudson-ci.org/display/HUDSON/PMD+Plugin (非必要)

转载请注明源:http://hi.baidu.com/taotao5453 ,感谢

多种方法来调用PMD工具,比如command line、Ant、Maven、Mac OSX automator,这里主要讲解“命令行(Command Line)”调用PMD的方法,也是最容易上手的方法。其他方法请按照官方说明尝试。以下讲解只是帮助不太会使用命令行、英语也不太过关的同学,命令行很熟练的高手达人可直接无视,直接参考官方网站说明即可。

一、下载

1、首先下载FlexPMD,当前版本是Flex PMD 1.2,我们要下载Command Line版本,下载地址是

http://opensource.adobe.com/svn/opensource/flexpmd/maven-repository/release/com/adobe/ac/flex-pmd/1.2/flex-pmd-command-line-1.2.zip

2、下载完成后解压到一个目录下,比如E:/FlexPMD,这个路径在我们使用命令行的时候要用到,解压文件如下图



-

二、测试FlexPMD是否正常

下面我们测试一下FlexPMD是否正常,

1、如果你的是XP系统,点开始->运行->键入“cmd”->回车,Win7系统点“开始 ->”后在下图中的输入框键入“cmd”->回车,打开DOS窗口,因为我的是Win7系统,所以以下截图都使用Win7内截图,XP系统命令行命令是类似的,不再单独截图了。



-


-

2、在DOS窗口中键入“e:”+回车,将操作盘指向E盘,再键入“cd FlexPMD”+回车,将文件夹指向我们解压完的FlexPMD文件夹。

3、键入“java -Xmx256m -jar flex-pmd-command-line-1.2.jar”+回车,显示出FlexPMD相应信息即表示FlexPMD工作正常,如下图


-

三、审核我们的代码

1、将你项目的src文件夹拷贝到E:/FlexPMD文件夹内,(这个项目可以是Flex项目,也可以是使用FlashBuilder创建的ActionScript项目,也可以不拷贝,只需更改下面的命令行代码,请自行钻研)。

2、在刚刚的DOS窗口中键入“java -Xmx256m -jar flex-pmd-command-line-1.2.jar -s ./src/ -o .”+回车。会有很多输出信息,等待即可,出现“It took 393 ms to write the Xml report”类似字样就表示审核完成,


我们 可以在E:/FlexPMD文件夹内看到多出来一个pmd.xml的文件,这个文件就是审核结果文件。
-

四、查看审核结果

审核结果可以通过安装Hudson插件(地址参考本文篇首)的工具来查看,详细安装过程可参考官方说明,我们这里只讲以下使用官方网页版的查看工具“PMD Violations Viewer”,

1、PMD Violations Viewer — powered by Adobe technical services工具地址: http://opensource.adobe.com/svn/opensource/flexpmd/bin/flex-pmd-violations-viewer.html
如下图:


-

2.点击“Upload your Pmd results”按钮,然后在文件系统中E:/FlexPMD 文件夹中选择我们审核过程中生成的pmd.xml文件,


-

3、选中后,网页中就会生成一个审核结果列表,如下图:


-

这个表格的上部,会显示审核出的不合格代码数量,按照官方的说法,如果这是个还没有进行过专项代码优化的大项目的话,不要为有5000多个不合格而惊奇。。。建议从项目从一开始就使用此工具审核代码,降低不合格数量。(注意:这里的Errors、Warmings不是编译器的输出错误,而是我们审核出的不适当代码)

4、选中并展开列表中的左侧文件夹List项目,会显示具体的不合格项原因说明,右侧会弹出一个界面说明此项问题出现的具体“类”、“行数”等信息,参考这个信息我们就可以进行优化我们的代码了。

-

总结:

FlexPMD 简化了审核代码的过程,而且更容易确保代码清晰且已经过优化。FlexPMD 的实际功能在于其可扩展性。作为开

发人员,您可以创建自己的规则集来审核任何代码。例如,您可以创建一组规则,用于检测大量使用的滤镜或任何其他您想要捕捉的品质欠佳的代码编写方法,方法请参考官方。


猜你喜欢

转载自blog.csdn.net/jackson_0606/article/details/8444810