Clang是llvm的编译器前端,非常适合进行源码分析.目前开源的oclint就是基于clang进行的代码静态检查.工作中遇到了一些问题需要进行代码分析,所以学习了插件的开发流程.既然开发插件就要有合适的IDE,Mac上最合适的无疑是xcode了.本文将讲述如何使用xcode开发clang插件,在此之前请先了解clang的相关知识.
a.查看xcode对应的clang版本 https://trac.macports.org/wiki/XcodeVersionInfo
b.官网查询对应发布版本 https://opensource.apple.com/source/clang/
c.根据官网用的代码查找github查找对应分支并下载代码
https://github.com/llvm-mirror/llvm
a.创建插件所在文件夹(示例代码见 demo)
b.编写cmakelists文件
c.添加插件代码
有两种编译方式，一种使用cmake直接编译，一种使用IDE。这里介绍下使用xcode的编译方式。
a. 生成 xcodeproj 文件
cd /opt
sudo mkdir llvm
sudo chown `whoami` llvm
cd llvm
export LLVM_HOME=`pwd`
git clone -b release_39 git@github.com:llvm-mirror/llvm.git llvm
git clone -b release_39 git@github.com:llvm-mirror/clang.git llvm/tools/clang
git clone -b release_39 git@github.com:llvm-mirror/clang-tools-extra.git llvm/tools/clang/tools/extra
git clone -b release_39 git@github.com:llvm-mirror/compiler-rt.git llvm/projects/compiler-rt
mkdir llvm_build
cd llvm_build
cmake -G Xcode ../llvm -DCMAKE_BUILD_TYPE:STRING=MinSizeRel备注：官网教程 http://llvm.org/docs/CMake.html
b. 选择自动生成 schmema
c. 编译 clang，myplugin 和 libclang
d. 最终效果
a. 执行以下两个命令
sudo mv HackedClang.xcplugin `xcode-select -print-path`/../PlugIns/Xcode3Core.ideplugin/Contents/SharedSupport/Developer/Library/Xcode/Plug-inssudo mv HackedBuildSystem.xcspec `xcode-select -print-path`/Platforms/iPhoneSimulator.platform/Developer/Library/Xcode/Specifications如果自定义 clang 路径和展示的名称，则修改以下文件
b. Xcode 配置
c. 添加 other_flags
-Xclang -load -Xclang /opt/llvm/clangplugin/libONEExtractVCPlugin.dylib -Xclang -add-plugin -Xclang ONEExtractVCPlugin -I/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/include/c++/v1/opt/llvm/clangplugin/libMyPlugin.dylib:是动态库地址
MyPlugin：插件名称
/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/include/c++/v1:使用的c++库
直接替换红框的 clang 为自己编译的 clang 即可
a. 注册插件
static clang::FrontendPluginRegistry::Add<my::MyASTAction>
X("MyPluginName", "MyPlugin description");
第一个参数是插件名称,第二个是插件描述
b. 传递参数到插件
bool MyASTAction::ParseArgs(const CompilerInstance &CI, const std::vector<std::string>& args) {
size_t cnt = args.size();
for(int i = 0;i < cnt;i++){
cout<<"myparam:"<<args.at(i)<<endl;
}
return true;
}
编译的时候添加plugin对应的param就可以通过该方法将param获取到.例如在other_cflag除了上期配置外添加中添加-Xclang -plugin-arg-MyPlugin -Xclang $SRCROOT/..,就可以将srcroot的路径打印出来
void MyASTConsumer::HandleTranslationUnit(ASTContext &context){}
:interfDecl->getSuperClass()->>getNameAsString()
是否是实现类：if(isa<ObjCImplDecl>(decl)){}
是否是category： if(isa<ObjCCategoryDecl>(decl)){}
if(isa<ObjCProtocolDecl>(decl)){}
if(isa<ObjCPropertyDecl>(decl)){}
是否是实例变量:objcIsInstanceMethod = propertyDecl->isInstanceProperty();
property类型(修饰符例如NSString):propertyDecl->getType().getAsString();
getter方法名称:propertyDecl->getGetterName().getAsString()
setter方法名称:propertyDecl->getSetterName().getAsString()
是否只读:propertyDecl->isReadOnly()
是否是类property:propertyDecl->isClassProperty()
是否是原子性:propertyDecl->isAtomic()
b. 是否是成员变量 ：if (isa<ObjCIvarDecl>(decl)) {}
成员变量名称:ivarDecl->getNameAsString()
c. 是否是参数 : if (isa<ObjCTypeParamDecl>(decl)){}
@interface NSDictionary<Key : id<NSCopying>, Value>@end
key,value就是paramterif(isa<ObjCMethodDecl>(decl)){}
是否是实例方法: methodDecl->isInstanceMethod()
selector名称: methodDecl->getSelector().getAsString()
返回值类型:methodDecl->getReturnType().getAsString()
参数:
for(ArrayRef<ParmVarDecl *>::iterator it = methodDecl->param_begin();it!=methodDecl->param_end();it++){
cout<<"参数:"<<((*it)->getNameAsString())<<"参数类型:"<<(*it)->getType().getAsString()<<endl;
}d. 是否是变量方法枚举等 if(isa<DeclRefExpr>(s)){}
声明的名称:callExpr->getDecl()->->getNameAsString()
是否是变量:isa<VarDecl>(decl)
是否是函数:isa<FunctionDecl>(decl)
是否是枚举:isa<EnumConstantDecl>(decl)
e. 向object-c对象发送消息 isa<ObjCMessageExpr>(s)
调用者:objcExpr->getSelector().getAsString()
函数本身名称: objcExpr->getSelector().getAsString()
接受消息类型:objcExpr->getReceiverType().getAsString()
xcodebuild clean
xcodebuild -workspace OneTravel.xcworkspace -scheme OneTravel CODE_SIGN_IDENTITY="" CODE_SIGNING_REQUIRED=NO -dry-run -configuration Release| ruby onepretty
解释：
CODE_SIGN_IDENTITY=”” CODE_SIGNING_REQUIRED=NO：表示不需要证书编译
-dry-run:只获取编译命令，执行
onepretty: 从xcpretty中抽取的工具，移除了无用代码，添加了复制头文件软连接功能
a.移除-gmodules： 这个命令会打包编译信息，自定义的libtool不支持，而且也没有用。
b.移除 -c和-o及其参数: 仅解析ast，这是无用参数
c.添加引用c++库（如果要解析一些.cpp和.mm文件）: -I/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/include/c++/v1
d.替换工具: 将 clang 替换成自己的工具，如onec -- -x --后面对应对应,双横线参见
示例如下（精简版）：
/Users/xx/Documents/plugin/bin/bin/onec /Users/xx/Documents/conn_connection.cpp -outdir=~/Desktop -- -x c++ -arch armv7 -isysroot /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/SDKs/iPhoneOS10.3.sdk -I/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/include/c++/v1
进入 llvm_build 文件夹清空原来的文件，重新编译代码 cmake -G Xcode ../llvm -DCMAKE_BUILD_TYPE:STRING=MinSizeRel
一些clang组件的作用：
libclangLex：预处理、词法分析、宏处理、词元（token）、语法构造；
libclangAST：该库是用来建立、管理、遍历AST
libclangParse：语法分析，用来解析词法分析后的结果
libclangSema：语义分析
libclangCodeGen：目标相关的代码分析
libclangAnaylysis：用于进行静态分析用的
libclangRewrite：代码重新写入（不知道该怎么解释，稍后理解了再做解释）
libclangBasic：clang的基础杂项库
http://clang.llvm.org/docs/InternalsManual.html
| 插件 | libtool |
|---|---|
| 解析速度 | 稍快 |
| 包大小 | 大 |
| 获取编译命令 | 直接使用 xcodebuild 生成的命令 |
| 与 xcode 集成 | 可以 |
由于 libtool 和clang 插件的大部分api可以通用，因此实际工作用中选择哪个都可以，如果出现问题，两者的代码可以低成本的相互迁移。
