Using Clang as a Library----Choosing the Right Interface for Your Application---翻译

原文地址：http://clang.llvm.org/docs/Tooling.html

译者：史宁宁（snsn1984）

为你的程序选择正确的接口

       Clang为实现须要一个程序的语法和语义信息的工具提供了基础设施。（（译者注：为了便于理解，再意译一句）若是你想实现一个工具，而这个工具须要获取一个程序的语法和语义信息，那么恭喜你，Clang能够为你提供一些基础实现。）这个文档将给出使用不一样的方法去实现基于Clang的工具的一个简短介绍，包括它们的优势和缺点。

LibClang

LibClang是一个稳定的高层次的Clang的C语言接口。若是不肯定LibClang是你想要用的接口，只有当你有一个好的理由不用LibClang的时候，这个时候你才能够去用别的接口。

若是遇到以下状况，那么就是典型的使用LibClang的时候：

• Xcode
• Clang Python Bindings

若是遇到下列状况，请使用LibClang:

• 想使用Clang除了C++以外的编程语言的接口
• 须要一个稳定的接口能够向后博啊吃兼容
• 须要一个十分强大的高层次的抽象，好比：像一个光标同样遍历AST，或者不想去学习Clang的AST的全部的细节问题

若是遇到下列状况，请不要使用LibClang:

• 想彻底控制Clang AST

Clang Plugins

Clang Plugins容许你在AST之上运行一些额外的动做，而这些动做做为编译的一部分。Plugins是运行的时候被编译器加载的动态库，她们很容易合并到你的构建环境中。

若是遇到以下状况，那么就是典型的使用Clang Plugins的时候：

• 你的工程有特殊的lint风格的警告或者错误
• 从一个单独的编译步骤要建立额外的构建神器
  

若是遇到下列状况，请使用Clang Plugins:

• 须要你的工具去返回任何依赖关系的变化
• 想让你的工具去执行或者跳出一次构建
• 须要彻底控制Clang AST

若是遇到下列状况，请不要使用Clang Plugins:

• 想在你的构建环境的外部运行工具
• 想彻底控制Clang如何创建起来，包括内存虚文件的映射
• 想去运行你工程中的一部分特殊的文件，而这部分文件和触发从新构建是没有必要联系的

LibTooling

LibTooling是一个C++接口，它的目标在于实现彻底独立的工具，而这些工具就像是被集成到运行Clang工具的服务中了同样。
若是遇到以下状况，那么就是典型的使用LibTooling的时候：

• 一个简易的语法检查器
• 重构工具

若是遇到下列状况，请使用LibTooling:

• 想在独立于构建系统的单个文件或者一系列特殊的文件上运行工具
• 想彻底控制Clang AST
• 想和Clang Plugins共享代码

若是遇到下列状况，请不要使用LibTooling:

• 想做为能够被依赖关系改变而触发的构建系统的一部分运行
• 想要一个稳定的接口，不须要由于AST API的改变而改变你的代码
• 想要一个高层次的抽象像光标和在盒子以外完成的代码
• 不想使用C++去实现你的工具

Clang tools是一系列基于LibTooling架构基础之上构建的特殊的开发者工具，它们是Clang工程的一部分。它们的目标是自动化和改善C/C++开发者的核心开发活动。

咱们已经在构建或者计划构建的做为Clang工程的一部分例子工具备：

• 语法检查 (clang-check)
• 自动修复编译错误 (clang-fixit)
• 自动代码格式化 (clang-format)
• 新语言标准的新特性的迁移工具（cpp11-migrate，译者注）
  
• 核心重构工具
• -------------------------------------------------------------------------------------------结束-------------------------------------------------------------------------------------------------------------------------------