网上学习资料一大堆,但如果学到的知识不成体系,遇到问题时只是浅尝辄止,不再深入研究,那么很难做到真正的技术提升。
一个人可以走的很快,但一群人才能走的更远!不论你是正从事IT行业的老鸟或是对IT行业感兴趣的新人,都欢迎加入我们的的圈子(技术交流、学习资源、职场吐槽、大厂内推、面试辅导),让我们一起学习成长!
新手写CMakeLists.txt简直就是实力劝退,各种命令让很多人头大,如何写一个最基础的CMakeLists.txt呢?本文从一个实例出发,教你编写的基本流程。
CMakeLists.txt的基本结构
编写CMakeLists.txt
最常用的功能就是调用其他的.h头文件和.so/.a库文件,将.cpp/.c/.cc文件编译成可执行文件或者新的库文件。
命令的官方网站:CMake Reference Documentation
最常用的命令如下(仅供后期查询,初期不需要细看):
# 本CMakeLists.txt的project名称
# 会自动创建两个变量,PROJECT_SOURCE_DIR和PROJECT_NAME
# ${PROJECT_SOURCE_DIR}:本CMakeLists.txt所在的文件夹路径
# ${PROJECT_NAME}:本CMakeLists.txt的project名称
project(xxx)
# 获取路径下所有的.cpp/.c/.cc文件,并赋值给变量中
aux_source_directory(路径 变量)
# 给文件名/路径名或其他字符串起别名,用${变量}获取变量内容
set(变量 文件名/路径/...)
# 添加编译选项
add_definitions(编译选项)
# 打印消息
message(消息)
# 编译子文件夹的CMakeLists.txt
add_subdirectory(子文件夹名称)
# 将.cpp/.c/.cc文件生成.a静态库
# 注意,库文件名称通常为libxxx.so,在这里只要写xxx即可
add_library(库文件名称 STATIC 文件)
# 将.cpp/.c/.cc文件生成可执行文件
add_executable(可执行文件名称 文件)
# 规定.h头文件路径
include_directories(路径)
# 规定.so/.a库文件路径
link_directories(路径)
# 对add_library或add_executable生成的文件进行链接操作
# 注意,库文件名称通常为libxxx.so,在这里只要写xxx即可
target_link_libraries(库文件名称/可执行文件名称 链接的库文件名称)
通常一个CMakeLists.txt需按照下面的流程:
project(xxx) #必须
add_subdirectory(子文件夹名称) #父目录必须,子目录不必
add_library(库文件名称 STATIC 文件) #通常子目录(二选一)
add_executable(可执行文件名称 文件) #通常父目录(二选一)
include_directories(路径) #必须
link_directories(路径) #必须
target_link_libraries(库文件名称/可执行文件名称 链接的库文件名称) #必须
除了这些之外,就是些set变量的语句,if判断的语句,或者其他编译选项的语句,但基本结构都是这样的。
实例
我以自己曾经写的一段实际代码为例,来讲解究竟该怎么写CMakeLists
。
实例地址:
GitHub:https://github.com/yngzMiao/protobuf-parser-tool
实例的功能是生成和解析proto
文件,分为C++
和python
版本。其中,C++
版本就是采用CMakeLists.txt
编写的,目录结构如下:
|---example_person.cpp
|---proto_pb2
|--Person.pb.cc
|--Person.pb.h
|---proto_buf
|---General_buf_read.h
|---General_buf_write.h
|---protobuf
|---bin
|---...
|---include
|---...
|---lib
|---...
目录结构含义:
- protobuf:
Google
提供的相关解析库和头文件,被proto_pb2
文件夹内引用; - proto_pb2:封装的
Person
结构和Person
相关的处理函数,被proto_buf
文件夹内引用; - proto_buf:封装的
read
和write
函数,被example_persom.cpp
文件引用。
也就是说:
example_person.cpp
–>proto_buf
文件夹–>proto_pb2
文件夹–>protobuf
文件夹
步骤
CMakeLists.txt的创建
在需要进行编译的文件夹内编写CMakeLists.txt
,即含有.cpp/.c/.cc
的文件夹内:
即目录结构如下:
|---example_person.cpp
|---CMakeLists.txt
|---proto_pb2
|--Person.pb.cc
|--Person.pb.h
|--CMakeLists.txt
|---proto_buf
|---General_buf_read.h
|---General_buf_write.h
|---protobuf
|---bin
|---...
|---include
|---...
|---lib
|---...
CMakeLists.txt的编写
本项目的CMakeLists.txt
的文件数量是2个,目录层次结构为上下层关系。通常的解决方案,就是将下层目录编译成一个静态库文件,让上层目录直接读取和调用,而上层目录就直接生成一个可执行文件。
既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,涵盖了95%以上C C++开发知识点,真正体系化!
由于文件比较多,这里只是将部分目录截图出来,全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频,并且后续会持续更新
也有适合3年以上经验的小伙伴深入学习提升的进阶课程,涵盖了95%以上C C++开发知识点,真正体系化!**
由于文件比较多,这里只是将部分目录截图出来,全套包含大厂面经、学习笔记、源码讲义、实战项目、大纲路线、讲解视频,并且后续会持续更新