基于LLVM开发属于本身Xcode的Clang插件

---

开发的插件效果以下

简介：

本开发是基于LLVM，那么咱们先来简单了解一下LLVM：

• LLVM项目是模块化、可重用的编译器以及工具链技术的集合
• 美国计算机协会 (ACM) 将其2012 年软件系统奖项颁给了LLVM，以前曾经得到此奖项的软件和技术包括:Java、Apache、 Mosaic、the World Wide Web、Smalltalk、UNIX、Eclipse等等。
• LLVM的创始人 Chris Lattner，也是swift之父（也就是下面的这位）
  LLVM官网连接

而什么是Clang呢？

• Clang是LLVM项目的一个子项目

• 基于LLVM架构的C/C++/Objective-C编译器前端
  Clang传送门

  简单上图看一眼两者之间的关系
  
  
  

  实战分析

  基本文件

• 新建文件夹llvm，下载LLVM（预计大小 648.2 M）
  $ git clone https://git.llvm.org/git/llvm.git/
• 下载clang（预计大小 240.6 M）
  $ cd llvm/tools
$ git clone https://git.llvm.org/git/clang.git/

• 注意 ：
  clang的下载目录应在llvm/tools下（如图）
  
  
  

  编译工具

• 这里推荐使用ninja和cmake（先安装brew，https://brew.sh/）
  $ brew install cmake
$ brew install ninja

• ninja若是安装失败，能够直接从github获取release版放入【/usr/local/bin】目录中
  ninja的GitHub传送门

编译方式

一、ninja编译

• 在LLVM源码同级目录下新建一个【llvm_build】目录(最终会在【llvm_build】目录下生成【build.ninja】)

• 同时在LLVM源码同级目录下新建一个【llvm_release】目录(最终编译文件会在llvm_release文件夹路径下)
  $ cd llvm_build
$ cmake -G Ninja ../llvm -DCMAKE_INSTALL_PREFIX=‘安装路径’（本机为/Users/xxx/Desktop/LLVM/llvm_release）

• 依次执行编译、安装指令
  $ ninja

  编译完毕后， 【llvm_build】目录大概 21.05 G(仅供参考)

  $ ninja install

  安装完毕后，安装目录大概 11.92 G(仅供参考)

• 最终生成build.ninja以及llvm_release文件夹位置以下图
  
  

二、Xcode编译

• 做为iOS开发者，使用Xcode则是更加驾轻就熟，可是Xcode编译的速度较慢，亲测在一个小时以上
• 在llvm同级目录下新建一个【llvm_xcode】目录，而后开始编译
  $ cd llvm_xcode
$ cmake -G Xcode ../llvm
• 完成后咱们将看到熟悉的打开方式
• 打开project后咱们选择Auto的方式来建立scheme
• 而后选择ALL_BUILD进行编译，此处应有1+小时的休息时间，而后就能够开始插件的编写

编写插件

1.目录

• 在【clang/tools】源码目录下新建一个插件目录，假设叫作【JJPlugin】(以下图"JJPlugin目录"红色箭头所示)
• 在【clang/tools/CMakeLists.txt】(以下图"JJPlugin目录"绿色箭头所示) 最后添加内容: add_clang_subdirectory(JJPlugin)，小括号里是插件目录名
  
• 在【JJPlugin】目录下新建一个【CMakeLists.txt】 (以下图黄色箭头所示)，文件内容是: add_llvm_loadable_module(JJPlugin JJPlugin.cpp)
  
• 在【JJPlugin】目录下]新建一个【JJPlugin.cpp】$ touch JJPlugin.cpp (以下图黄色箭头所示)

• 目录文件建立完成后，须要利用cmake从新生成一下Xcode项目
  $ cmake -G Xcode ../llvm
• 插件源代码在【Sources/Loadable modules】目录下能够找到，这样就能够直接在Xcode里编写插件代码
  

2.代码

• 这里提供了类名中下划线的检测以及类首字母小写的警告
  github连接
  

3.编译

• 选择咱们的插件进行编译
  
• 而后就能看到咱们编译的lib
  
  

4.加载

• 在Xcode项目中指定加载插件动态库:BuildSettings > OTHER_CFLAGS
  -Xclang -load -Xclang 动态库路径 -Xclang -add-plugin -Xclang 插件名称
  

5.Hack Xcode

• 首先咱们要对Xcode进行Hack，才能修改默认的编译器
• 找到本身编译好的clang的路径，也就是在咱们前面定义的release的bin目录下。
• 下载XcodeHacking.zip，解压，右键【HackedClang.xcplugin】点击"显示包内容"打开修改【HackedClang.xcplugin/Contents/Resources/HackedClang.xcspec】的内容
  
• 把这个路径修改成上面本身编译好的clang的路径
  

• 而后在XcodeHacking目录下进行命令行，将XcodeHacking的内容剪切到Xcode内部

  $ sudo mv HackedClang.xcplugin `xcode-select -print-
  path`/../PlugIns/Xcode3Core.ideplugin/Contents/SharedSupport/Developer/Library/Xcode/Plug-ins

$ sudo mv HackedBuildSystem.xcspec `xcode-select -print- path`/Platforms/iPhoneSimulator.platform/Developer/Library/Xcode/Specifications

6.使用

• 重启Xcode，修改Xcode的编译器，转而使用咱们本身的编译器
  
• 编译后若是代码存在语法问题，便能看到本文开头的错误提示
  

总结

Clang 的开源给了咱们更多的操做空间，咱们能够利用clang的API针对语法树(AST)进行相应的分析和处理，进一步完善咱们的需求，也能更好地提高咱们代码的规范和质量。
附上关于语法树AST的资料：
https://clang.llvm.org/doxygen/namespaceclang.html
https://clang.llvm.org/doxygen/classclang_1_1Decl.html
https://clang.llvm.org/doxygen/classclang_1_1Stmt.html