参考书:《Getting Started with LLVM Core Libraries》
书里边只介绍了makefile形式,我这里介绍了两种方式,我自己觉得Xcode要方便一点,因为可以直接调试(纯小白可能看起来费力一点)。
一、MakeFile项目:
包含一个makefile文件和一个cpp文件,书中的源代码是基于llvm3的,我自己是基于llvm9.0的,所以基于他书中给出的代码做了修改。
-
书中的源代码:
- 我贴一下我自己的代码:
MakeFile 文件:
路径根据自己电脑的llvm项目更改;
- LLVM_CONFIG 获取编译参数、链接参数
- CXXINCLUDE、ISYSROOT 是我自己根据电脑路径添加的,因为我电脑上编译的话会报错,添加的C++标准库头文件路径和mac上SDK的路径,这样才能编译通过
- LIB 这个LLVM的库
- 其余的设置参考书中就行,没什么变化,路径需要根据自己电脑上来设置。
(书中是只用到了几个核心的llvm库,我是直接用了整个库libLLVM.dylib,因为我改了点代码,为了方便)
LLVM_CONFIG ?= /Users/qinyao/LLVM/LLVM-9.0.0/build-release/bin/llvm-config
# CXX = /Users/qinyao/LLVM/LLVM-9.0.0/build-release/bin/clang++
CXXINCLUDE+=/Applications/Xcode.app/Contents/Developer/Toolchains/XcodeDefault.xctoolchain/usr/include/c++/v1
# CXXINCLUDE+=/Users/qinyao/LLVM/LLVM-9.0.0/build-release/include/c++/v1
ISYSROOT+=/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.14.sdk
LIB+=/Users/qinyao/LLVM/LLVM-9.0.0/build-release/lib
ifndef VERBOSE
QUIET:=@
endif
SRC_DIR?=$(PWD)
LDFLAGS+=$(shell $(LLVM_CONFIG) --ldflags)
COMMON_FLAGS=-Wall -Wextra -I$(CXXINCLUDE) -isysroot $(ISYSROOT)
CXXFLAGS+=$(COMMON_FLAGS) $(shell $(LLVM_CONFIG) --cxxflags)
CPPFLAGS+=$(shell $(LLVM_CONFIG) --cppflags) -I$(SRC_DIR)
HELLO=helloworld
HELLO_OBJECTS=hello.o
default: $(HELLO)
%.o : $(SRC_DIR)/%.cpp
@echo Compiling $*.cpp
$(QUIET)$(CXX) -c $(CPPFLAGS) $(CXXFLAGS) $<
$(HELLO) : $(HELLO_OBJECTS)
@echo Linking $@
$(QUIET)$(CXX) -o $@ $(CXXFLAGS) $(LDFLAGS) $^ -L$(LIB) -lLLVM
clean::
$(QUIET)rm -f $(HELLO) $(HELLO_OBJECTS)
#-DLLVM_ENABLE_PROJECTS="clang;libcxx;libcxxabi"
#$(QUIET)$(CXX) -o $@ $(CXXFLAGS) $(LDFLAGS) $^ `$(LLVM_CONFIG) --libs bitreader core support` `$(LLVM_CONFIG) --system-libs`
hello cpp 文件:
改了一点写法,解析一个bc文件,遍历module,拿到函数列表,遍历这个函数迭代器,输出函数名和函数包含的基础块。
#include "llvm/Bitcode/BitcodeReader.h"
#include "llvm/Bitcode/BitcodeWriter.h"
#include "llvm/IR/Function.h"
#include "llvm/IR/Module.h"
#include "llvm/Support/CommandLine.h"
#include "llvm/Support/MemoryBuffer.h"
#include "llvm/Support/raw_os_ostream.h"
#include "llvm/IRReader/IRReader.h"
#include "llvm/Support/SourceMgr.h"
// #include "llvm/Support/system_error.h"
#include <iostream>
using namespace llvm;
static cl::opt<std::string> FileName("qy-file", cl::desc("input one Bitcodefile"), cl::Required);
int main(int argc, char** argv) {
cl::ParseCommandLineOptions(argc, argv, "LLVM hello world\n");
LLVMContext Context;
SMDiagnostic Err;
// std::cout<<FileName<<std::endl;
std::unique_ptr<Module> M = parseIRFile(FileName, Err, Context);
if (!M) {
Err.print(FileName.c_str(), errs());
return false;
}
for(auto &func : M->functions()){
llvm::StringRef func_name = func.getName();
}
raw_os_ostream OUT(std::cout);
for (Module::const_iterator i = M->getFunctionList().begin(),e = M->getFunctionList().end(); i != e; ++i) {
if (!i->isDeclaration()) {
OUT << i->getName() << " has " << i->size() << " basicblock(s).\n";
}
}
std::cout<<"hello,world."<<std::endl;
return 0;
}
-
上面没问题了就直接make:
make可能会遇到各种问题,需要注意路径正确。
-
运行:
需要设置一下库搜索路径:
二、Xcode创建:
-
创建一个Xcode 命令行项目:
代码直接贴进去,和上边的cpp代码一样
环境配置:
-
头文件路径:使用llvm9.0编译出来的debug模式的头文件,后面方便调试
-
库搜索路径:
-
编译参数:这个是解决一个链接问题
-
导入llvm的库:
这些参数设置正确后应该可以编译通过。
运行参数:
static cl::opt<std::string> FileName("qy-file", cl::desc("input one Bitcodefile"), cl::Required);
-
运行时库搜索路径:
至此,可以直接编译运行了。
总结:这里仅仅是熟悉了项目创建,代码的编写还需要实践的更多才能熟悉。