sqlite学习笔记（3）用Doxygen辅助看代码

最新推荐文章于 2024-05-24 23:32:46 发布

偏test

最新推荐文章于 2024-05-24 23:32:46 发布

阅读量828

点赞数

分类专栏： SQLite

本文链接：https://blog.youkuaiyun.com/pfysw/article/details/78503687

版权

SQLite 专栏收录该内容

43 篇文章

订阅专栏

工欲善其事必先利其器，上一篇讲了用eclipse搭建源码环境，操作比较麻烦，图方便的可以下载我建好的工程。

https://pan.baidu.com/s/1hrSJ3j2#list/path=%2F%E6%88%91%E7%9A%84%E8%B5%84%E6%BA%90

由于sqlite3工程比较庞大，调用关系比较复杂，虽然eclipse有很强大的关键字搜索和函数调用关系搜索，但是看起来还是很累，现在借助Doxygen和GraphViz来生成函数调用关系图。

具体的基本操作步骤就不说了，可以参考以下链接，讲的很详细

http://blog.youkuaiyun.com/u010740725/article/details/51387810

我补充一些上面没讲到的或不一样的，在wizard->mode里选对C语言优化，在output里不用勾选latex，因为这里没有数学公式可以减少生成的文件。在Expert标签的HTML栏里把SEARCHENGINE勾去掉，否则可能会出现报“error: When enabling GENERATE_HTMLHELP the search engine (SEARCHENGINE) should be disabled.”的错误。

下面是比较关键的预处理部分，在Expert标签的Preprocessor栏里，MACRO_EXPANSION的勾要打上，这个让Doxygen编译时展看代码的宏，另外不要把EXPAND_ONLY_PREDEF的勾打上，否则就不会处理代码里的宏了。在INCLUDE_PATH添加头文件路径，这个和eclipse一样，告诉Doxygen头文件在哪里。

PREDEFINED定义控制编译条件的宏，比如我添加了_WIN32，把windows的api编译进去，还有__declspec(x)=把__declspec的宏设为空，有些函数前面有这个，这个编译器能识别，但是Doxygen识别不了会把它当函数名处理，结果后面真正的函数显示不出来。EXPAND_AS_DEFINED这个暂时不知道什么作用。

clip_image002[12]

在Expert标签的Dot栏里，DOT_GRAPH_MAX_NODES控制每张调用图显示的最大节点数，我设的是100，如果超出了会作优化，把一些复杂的函数用红框框起来。

配置完了点run doxygen，可能要等20多分钟吧，生成完后点show html output就可以看了，可以看函数的调用了哪些函数，也可以看这个函数被谁调用，点击方框可以进到这个函数里，非常方便

还有一点要注意的是，用来生成doxygen的源码目录下，把sqlite3ext.h头文件删掉，这个头文件对api函数重新定义成了宏来供动态库调用，doxygen可能会将函数以宏定义处理，也就不会在函数调用关系里展示出来了，奇怪的是我就用sqlite3ext.h、sqlite3.h、shell.c这3个文件做测试却是可以的，整个工程就不行，所以简单处理就把sqlite3ext.h文件删除。最后来展示一下open_db()函数的调用和被调用关系