使用cmake和llvm

这里主要讨论使用clion写工程时使用llvm需要注意的东西。

编译llvm

如果想在代码中使用 llvm ，需要下载源码手动编译。方法是下载 llvm 的源代码，放到任何位置，然后在 llvm 的根目录下执行如下操作:

mkdir build
cd build
cmake -DCMAKE_BUILD_TYPE=Release ..
make
 

设置环境变量 $LLVM_DIR :

export LLVM_DIR=/Users/seviezhou/llvm/build
 

头文件引用

为了能够正确的引用 llvm 的头文件，需要在 CMakeLists.txt 中添加:

cmake_minimum_required(VERSION 3.6)
project(kaleidoscope)
 
set(CMAKE_CXX_STANDARD 11)
 
# 使用llvm来设置路径
find_package(LLVM REQUIRED CONFIG)
 
# 打印信息
message(STATUS "Found LLVM ${LLVM_PACKAGE_VERSION}")
message(STATUS "Using LLVMConfig.cmake in: ${LLVM_DIR}")
 
set(SOURCE_FILES top.cpp)
 
# 添加头文件包含路径
include_directories(${LLVM_INCLUDE_DIRS})
add_definitions(${LLVM_DEFINITIONS})
 
add_executable(kaleidoscope ${SOURCE_FILES})
 

如果在 clion 中， log 会输出:

/Applications/CLion.app/Contents/bin/cmake/bin/cmake -DCMAKE_BUILD_TYPE=Debug -G "CodeBlocks - Unix Makefiles" /Users/seviezhou/CLionProjects/kaleidoscope
-- include path: /Users/seviezhou/llvm/include;/Users/seviezhou/llvm/build/include
-- Configuring done
-- Generating done
-- Build files have been written to: /Users/seviezhou/CLionProjects/kaleidoscope/cmake-build-debug
 

这时就能正确的包含 llvm 的所有头文件了。

使用llvm库

接下来如果使用了 llvm 库的代码，还需要在链接时加上库文件一起编译，否则有可能报如下的错误:

Undefined symbols for architecture x86_64
 

在 CMakeLists.txt 中需要添加用到的库，完整的 CMakeLists.txt 如下:

cmake_minimum_required(VERSION 3.6)
project(kaleidoscope)
 
set(CMAKE_CXX_STANDARD 11)
# 定义需要的库
set(LLVM_LINK_COMPONENTS
        Core
        Support
        )
 
# 使用llvm
find_package(LLVM REQUIRED CONFIG)
 
set(SOURCE_FILES top.cpp)
 
# 添加头文件路径
message(STATUS "include path: ${LLVM_INCLUDE_DIRS}")
include_directories(${LLVM_INCLUDE_DIRS})
 
add_executable(kaleidoscope ${SOURCE_FILES})
 
# 寻找对应的库
llvm_map_components_to_libnames(llvm_libs ${LLVM_LINK_COMPONENTS})
 
# 将库与目标代码一起链接
target_link_libraries(kaleidoscope ${llvm_libs})
 

也可以直接包含所有的库:

set(LLVM_LINK_COMPONENTS
        all
        )
 

rtti

rtti 是 run-time type information ，在使用 C++ 的多态特性时需要 rtti 的支持，如果编译时报如下错误说明链接时少了支持 rtti 的参数:

Undefined symbols for architecture x86_64:
  "typeinfo for llvm::raw_ostream", referenced from:
 

在 CMakeLists.txt 中加一句话:

set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -fno-rtti")
 

就可以正确的编译链接。