clang-uml 使用教程
项目介绍
clang-uml 是一个基于 Clang 的自动 C++ 到 UML 类、序列和包含图生成器,由 YAML 配置文件驱动。该项目的主要目的是在代码库中轻松维护最新的图表,或为遗留代码生成文档。clang-uml 支持生成 PlantUML、MermaidJS 和 JSON 格式的图表,目前支持 C++ 版本最高到 C++17,对 C++20 有部分支持。
项目快速启动
安装
首先,确保你已经安装了必要的依赖,包括 Clang 和 LibTooling。然后,你可以通过以下命令克隆并安装 clang-uml:
git clone https://github.com/bkryza/clang-uml.git
cd clang-uml
make install
生成图表
创建一个 YAML 配置文件 config.yaml
,内容如下:
compilation_database_dir: "build"
output_directory: "diagrams"
diagrams:
myproject_class:
type: class
glob:
- "src/*.cc"
using_namespace: myproject
include:
namespaces:
- myproject
exclude:
namespaces:
- myproject::detail
plantuml:
after:
- 'note left of [[ alias("MyProjectMain") ]]: Main class of myproject library'
运行 clang-uml 生成图表:
clang-uml config.yaml
生成的图表将位于 diagrams
目录中。
应用案例和最佳实践
案例一:文档化遗留代码
假设你有一个复杂的遗留 C++ 项目,你可以使用 clang-uml 生成类图和序列图,帮助你更好地理解代码结构和交互。通过配置文件中的 include
和 exclude
选项,你可以精确控制哪些部分被包含在图表中。
案例二:维护代码库文档
在持续开发的项目中,代码结构和交互可能会频繁变化。使用 clang-uml,你可以定期生成最新的 UML 图表,确保文档与代码同步。通过配置文件中的 glob
选项,你可以指定需要包含的文件和目录。
典型生态项目
Clang LibTooling
Clang LibTooling 是一个基于 Clang 的 C++ 库,用于创建各种工具。clang-uml 依赖于 Clang LibTooling 来解析和处理 C++ 代码。
PlantUML
PlantUML 是一种用于生成 UML 图表的语言和工具。clang-uml 支持生成 PlantUML 格式的图表,便于进一步编辑和查看。
MermaidJS
MermaidJS 是一个基于 JavaScript 的图表和图表工具。clang-uml 也支持生成 MermaidJS 格式的图表,适合在网页中嵌入和展示。
通过结合这些工具,clang-uml 提供了一个强大的生态系统,帮助开发者更好地理解和维护 C++ 项目。