邢台网站建设的地方,建站产品,郑州app制作一个需要多少钱,中文网站建设教程简介
本博客主要介绍cmake的基本指令#xff0c;同时#xff0c;很多使用Visual Studio小白从Gitbub下载项目源码后#xff0c;看到CMakeLists.txt#xff0c;不知道如何使用Visual Studio编译源码#xff1b;针对以上问题#xff0c;做一下简单操作与解释#xff0c;方…简介
本博客主要介绍cmake的基本指令同时很多使用Visual Studio小白从Gitbub下载项目源码后看到CMakeLists.txt不知道如何使用Visual Studio编译源码针对以上问题做一下简单操作与解释方便小白入门大佬就没必要继续看啦…
CMakeLists.txt的作用
基本来说CMakeLists.txt的主要作用有
告诉编译器源码之间的目录关系告诉编译器该怎么编译链接源码
第一种就是告诉编译器我要include的文件放在了哪里我要的静态库动态库放在了哪个文件夹内第二种主要是理解项目源码的编译过程这方面自行百度了解。接下来用几个基本操作说明
示例一
源码目录一结构
先简单的写一个cpp文件在include文件夹下放置test.h和test.cpp文件LearnCmake.cpp主要包含main函数test.h和test.cpp的主要内容是
//test.h的内容
#pragma once
#include iostream
void fun();//test.cpp的内容
#include test.h
void fun()
{std::cout 测试函数 std::endl;
}LearnCmake.cpp的内容是
#include iostream
#include test.h
using namespace std;
int main()
{fun();cout 输出结果 endl;system(pause);return 0;
}实操的话源码目录我已上传 cmake示例
这里并没有使用编译器生成项目文件仅仅是编写了源码源码的目录结构是
MyProject/|── CMakeLists.txt|── LearnCmake.cpp|── include/| |──test.h| └──test.cpp在main函数的同级目录下定义了CMakeLists.txt文件内容是
#所需的最低版本
cmake_minimum_required(VERSION 3.0)#本CMakeLists.txt的project名称用于生成learnCmake.sln
project(learnCmake)#设置生成文件的路径这将会把生成的可执行文件放置在 ${CMAKE_BINARY_DIR}/bin 文件夹中
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)#设置include文件夹路径可以理解为附加包含目录
include_directories(include)#先添加test.cpp文件到一个名为test_lib的库
add_library(test_lib include/test.cpp)#将.cpp/.c/.cc文件生成可执行文件a就是a.exe
add_executable(a LearnCMake.cpp)# 将test_lib链接到a.exe一定是先add_executable,再target_link_libraries
target_link_libraries(a test_lib)注意以上指令的顺序首先先将test.cpp编译成一个静态库同时生成一个a.exe再将静态库链接到a.exe内顺序不能错了不能先链接到exe(因为此时exe还未生成)再生成exe;这样从cmake里就能看到源码编译的过程也是上面我说的第二条也能更好地理解编译的过程
同时add_library里需要将一个cpp文件编译成lib文件这里的include/test.cppinclude就是CMakeLists.txt同一级目录源码项目以CMakeLists.txt为起点这样便说明了test.cpp所在源码的相对位置这就是上面我说的第一条
使用cmake-gui将源码目录一生成Visual Studio项目
项目源码写好之后不同的平台不同的编译器会根据CMakeLists.txt里的指令生成各自的项目文件在Windows平台上可以使用cmake-gui根据CMakeLists.txt里的指令生成你电脑上安装好的Visual Studio项目。
这里介绍使用camke-gui调用刚才的源码里的CMakeLists.txt 可以看到在2步骤下的文件目录下已经生成了Visiual Studio的项目项目名称是learnCmake.sln这与上面cmake指令project(learnCmake) 一致。 打开项目可以看到解决方案有 其中ALL_BUILD用于编译整个项目的工程。ALL_BUILD相当于makefile里面的默认目标构建整个项目但不包括install和单元测试等。ZERO_CHECK监视CMakeLists.txt如果CMakeLists.txt发生变化则告诉编译器重新构建整个工程环境。ZERO_CHECK是首先执行的构建目标会检查生成出的VS项目相比CMakeLists.txt是否过期如果过期会首先重新生成VS项目。所有其它目标都会依赖这个ZERO_CHECK于是构建别的目标都会先走一下ZERO_CHECK保证了所生成项目的即时性。可以直接将a设定启动项目。右键a项目属性内可以看到 已经按照cmake的指令将附加包含目录和静态依赖库文件写好了这就是对应上面的第一和第二条。 直接运行a项目便可以生成exe了结果是
示例二
有的源码项目内会出现多个CMakeLists.txt,比如这样的目录结构
MyProject/
|── CMakeLists.txt
|── main.cpp
|── include/
| |──test.h
| |──test.cpp
| └──CMakeLists.txt和main同一级的CMakeLists.txt的内容如下
#所需的最低版本
cmake_minimum_required(VERSION 3.0)#本CMakeLists.txt的project名称生成learnCmake.sln
project(learnCmake)#设置生成文件的路径这将会把生成的可执行文件放置在 ${CMAKE_BINARY_DIR}/bin 文件夹中
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)#设置include文件夹路径可以理解为附加包含目录
include_directories(include)#添加执行子目录的CMakeLists.txt
add_subdirectory(include)#连接静态库
link_libraries(test)#将.cpp/.c/.cc文件生成可执行文件a就是a.exe
add_executable(a LearnCMake.cpp)和test.cpp同一级的CMakeLists.txt的内容如下
#搜索当前目录下所有源文件
aux_source_directory(./ SRC)#编译静态库文件
add_library(test ${SRC})可以这样理解先将test.cpp编译成test.lib再将静态库编译到a.exe内
示例三
源码项目内需要链接别人的lib文件并且需要拷贝dll文件比如这样的目录结构
MyProject/
|── CMakeLists.txt
|── LearnCmake.cpp
|── lib/
| └──testDll.lib
|── include/
| |──test.h
| |──test.cpp
| └──testDll.h
|── dll/
| └──testDll.dllCMake指令需要这样写
#所需的最低版本
cmake_minimum_required(VERSION 3.0)#本CMakeLists.txt的project名称生成learnCmake.sln
project(learnCmake)#生成的类型,Debug后不能缺少分号
set(CMAKE_CONFIGURATION_TYPES Debug;)#设置生成文件的路径这将会把生成的可执行文件放置在 ${CMAKE_BINARY_DIR}/bin 文件夹中
set(CMAKE_RUNTIME_OUTPUT_DIRECTORY ${CMAKE_BINARY_DIR}/bin)#设置include文件夹路径可以理解为附加包含目录
include_directories(include)#先添加test.cpp文件到一个名为test_lib的库
add_library(test_lib include/test.cpp)#将.cpp/.c/.cc文件生成可执行文件a就是a.exe
add_executable(a LearnCMake.cpp)# 将test_lib链接到a.exe一定是先add_executable,再target_link_libraries
target_link_libraries(a test_lib)#这里相当于VS的附加依赖项将testDll.lib链接到a.exe,注意这里带后缀名
target_link_libraries(a ${CMAKE_CURRENT_SOURCE_DIR}/lib/testDll.lib)# 将testDll.dll 复制到a.exe所在的目录,这里仅仅起拷贝的作用
add_custom_command(TARGET a POST_BUILDCOMMAND ${CMAKE_COMMAND} -E copy_if_different${CMAKE_CURRENT_SOURCE_DIR}/dll/testDll.dll$TARGET_FILE_DIR:a
)Github项目源码通过cmake-gui生成VS项目示例
这里下载一个github上的一个C热门入门项目项目链接为 MyTinySTL 可以看到项目目录中的CMakeLists.txt
使用camke-gui生成VS项目后可以看到sln文件 打开项目文件将stltest设为启动项目编译后可以看到
结尾
关于cmake的指令比我这篇博客讲的更多这里仅入门讲解还是推荐小白下载项目目录后亲自测试一遍可能心得体会更多