源码模块关系分析工具使用说明

欢迎您使用 CnPack 开发组开发的源码模块关系分析工具 CnPack Relation Analyzer。

本工具主要用来分析 Delphi 编译生成的可执行文件内的单元与包信息,同时也可分析包之间的关联关系以及包与其使用的单元之间的关联关系。分析的结果可以保存成 ARF 文件,同时也可编辑生成关联信息记录 SMR 文件,以达到在后续开发过程中方便地查询源代码和受影响的模块之间关系的目的。

对于普通的分析,可在“分析可执行文件”页中打开一个或多个可执行文件进行分析,分析结果可保存成 ARF 文件并在“查看分析结果”页中重新加载查看。

ARF 是自动分析出来的结果,只包含 Pas 文件名和可执行文件之间的关联,不包括其他文件以及具体的路径信息。对于高级应用,可在“编辑源码模块关系”页中,将 ARF 通过手工编辑的方式生成包含完整的文件名与可执行文件之间关联关系的 SMR 文件。这样在后续的开发过程中,便可使用“查看源码模块关系”页来进行重新查看了。

 

分析可执行文件

分析可执行文件是源码模块关系分析工具的基本功能,它能分析可执行文件,得到其包列表与单元列表。它的界面如图所示:

 

 

查看分析结果

已保存的ARF的内容,可在此页重新加载供查看。重新加载后,此界面允许按一定规则查看引用关系,包括按可执行模块查看、按单元查看等,还能查找重复的单元名。它的界面如图所示:

 

编辑源码模块关系

保存的ARF内容仅仅只记录了模块名和源码文件名的简单对应关系,源码文件名不包括路径名。如果我们需要获得一个大项目中所有的具体文件名(包括路径)和其编译生成的最终模块BPL/DLL/EXE等的关系,则需要应用SMR编辑生成的方式。本界面用于编辑生成SMR文件,它的界面如图所示:

一个SMR文件记录了一批源文件以及和每个源文件有关系的可执行模块。生成一个完整的SMR文件需要源文件列表ARF文件两个要素,源文件列表可以使用“目录文件列表”功能来生成,ARF文件则来源于前两页分析保存而来的结果,两者的关系则通过本界面中的“填充”功能来实现。

查看源码模块关系

SMR文件保存后,此页中可打开已存在的SMR文件进行查看,界面和上一页类似,如下图:

查看界面与编辑SMR文件类似,此处不重复说明。

 

目录文件列表

目录文件列表功能用于根据一目录中的源文件生成一份源文件列表的文本文件供编辑SMR文件时使用,其界面如图所示,左面是查找得到的目录文件树列表,右面是生成的文件列表文本,最终需要保存的是右面的文件列表文本。

右键点击目录文件树可对目录文件树的内容进行系列操作。需要说明的是这些操作都不影响磁盘上的文件,只影响此处的列表内容与生成的文件列表文本。

本帮助文档中的抓图是本工具对Delphi 5的可执行文件以及其自带的VCL源码所分析的结果,用户可借此进行体验。

 

相关主题

CnPack 许可协议

关于 CnPack

 


(C)版权所有 2001-2014 CnPack 开发组