Mac 下 CMake 的配置与使用

这篇具有很好参考价值的文章主要介绍了Mac 下 CMake 的配置与使用。希望对大家有所帮助。如果存在错误或未考虑完全的地方,请大家不吝赐教,您也可以点击"举报违法"按钮提交疑问。

安装与配置

  1. 进入 官网下载 dmg 文件:
    Mac 下 CMake 的配置与使用

(在红圈中根据自己的Mac版本任选一个 dmg 下载)

  1. 安装完成后,从菜单栏选择:Tools–How to Install For Command Line UseMac 下 CMake 的配置与使用

  2. 在终端命令行中输入弹出弹窗中第二项 to install symlinks to '/usr/local/bin', run: 的指令:
    Mac 下 CMake 的配置与使用

  3. 检查是否配置成功:
    Mac 下 CMake 的配置与使用

cmake --version 可以正常识别,配置成功。


编译单个源文件

编译前的准备

使用 CMake 进行编译之前需要具备三大内容:
Mac 下 CMake 的配置与使用

他们的作用及内容如下:

源文件 main.cpp

#include <iostream>

int main(int argc, const char * argv[]) {
    // insert code here...
    std::cout << "Hello, World!\n";
    return 0;
}

cmake 构建规则 CMakeLists.txt

CMAKE_MINIMUM_REQUIRED(VERSION 2.6) 
# cmake最低版本需求,不加入此行会受到警告信息

PROJECT(HELLO) 
# 项目名称,同时会自动生成 PROJECT_NAME 变量,
# 使用${PROJECT_NAME} 即可访问到 hello_cmake。

AUX_SOURCE_DIRECTORY(. SRC_LIST) 
# 把当前目录(.)下所有源代码文件和头文件加入变量SRC_LIST

ADD_EXECUTABLE(hello ${SRC_LIST}) # 生成应用程序 hello

在编译单个文件时,也可以不添加第三句规则,而是直接在第四句规则中指定编译的文件,例如,删除第三句,并将第四句改为如下内容,本编译规则依然有效:

ADD_EXECUTABLE(hello main.cpp) #生成应用程序 hello

AUX_SOURCE_DIRECTORY

  • 第一个参数是目录的路径
  • 第二个参数是变量名。当我们使用这个命令时,就会将指定目录下的所有源文件保存到指定的变量名中。
  • 这里将名为 main.cpp 的源文件编译成一个名称为 hello 的可执行文件。

保存临时构建文件和目标文件的文件夹 build

  • 本示例中,该步骤本质上是创建一个可以位于文件系统上任何位置的构建文件夹(这里只是选择了在当前文件夹中创建)。 所有临时构建和目标文件都位于此目录中,以保持源代码树的整洁。该种构建方式为外部构建
  • 其实也可以没有这个文件夹,而是以内部构建的形式直接在源文件目录构建项目,只是会导致临时文件和源代码放在一起,不好清理。

开始编译

  • 通过 cmake .. 命令开始进行编译:

Mac 下 CMake 的配置与使用

  • 使用 cmake 生成的 makefile 编译得到可执行文件

Mac 下 CMake 的配置与使用

  • 此时在当前目录下,就会生成可执行文件 hello

Mac 下 CMake 的配置与使用

  • 将其运行查看是否成功编译:

Mac 下 CMake 的配置与使用


编译多个源文件

多个源文件在同一目录下

与编译单个源文件相比,难点主要是对 AUX_SOURCE_DIRECTORY 命令的使用。

如果不想使用 AUX_SOURCE_DIRECTORY 命令,也可以使用 set 来手动将多个源文件保存到变量名中:

set(SRC_LIST
    other.cpp
    main.cpp
)

多个源文件在不同目录下

.
├── CMakeLists.txt
├── main.cc
└── math
    ├── CMakeLists.txt
    ├── MathFunctions.cc
    └── MathFunctions.h

在多个目录下有着多个源文件的情况下,需要在每个目录中都编写一个 CMakeLists.txt。这里为了方便,我们可以将 math 里的文件编译为一个静态库再通过 main 函数调用。

math 目录下的 CMakeLists.txt

math 目录下的 CMakeLists.txt 主要做的事是将当前目录下的文件编译为一个静态库:

# 查找当前目录下的所有源文件
# 并将名称保存到 DIR_LIB_SRCS 变量
aux_source_directory(. DIR_LIB_SRCS)

# 指定生成 MathFunctions 链接库
add_library (MathFunctions ${DIR_LIB_SRCS})
  • add_library:用于从某些源文件创建一个库,默认生成在构建文件夹。
    • 第一个参数为库名(不需要 lib 前缀,会自动添加)
    • 第二个参数用于指定 SHARED(动态库)、STATIC(静态库)(如果不写,则通过全局的 BUILD_SHARED_LIBSFALSETRUE 来指定。上例中就没有写)
    • 第三个参数即为源文件列表。

根目录的 CMakeLists.txt

# CMake 最低版本号要求
cmake_minimum_required (VERSION 2.8)

# 项目信息
project (Demo3)

# 查找目录下的所有源文件
# 并将名称保存到 DIR_SRCS 变量
aux_source_directory(. DIR_SRCS)

# 添加 math 子目录
add_subdirectory(math)

# 指定生成目标
add_executable(Demo ${DIR_SRCS})

# 添加链接库
target_link_libraries(Demo MathFunctions)
  • add_subdirectory:用于表示该项目包含一个子目录,此时会去处理子目录下的 CMakeLists.txt 与源文件。
  • target_link_libraries:该命令用于指明可执行文件 Demo 需要链接 MathFunctions 库。
    • 第一个参数为可执行文件名
    • 第二个参数为访问权限(PUBLICPRIVATEINTERFACE,默认为 PUBLIC
    • 第三个参数为库名(这里库名使用了 math 目录下的 CMakeLists.txt 中生成的 MathFunctions 链接库)
    • 【后两个参数可以为多个】

option 选项

面对 库文件很大 或者 库文件依赖第三方库 的时候,我们可能希望将 该库文件作为一个可选项(而不是非得链接不可)

  1. 这里仍以 MathFunctions 为例进行实现。首先在 顶层CMakeLists.txt 文件添加一个选项 option ,其基本格式如下:
option (USE_MYMATH "should we use our own math functions?" ON) 
  • 第一个参数定义选项名称。
  • 第二个参数说明选项的含义。
  • 第三个参数定义选项默认状态,一般是 OFF 或者 ON,除去 ON 之外,其他所有值都被认为是 OFF
  1. 接下来就是将构建和连接 MathFunctions 设置为可选项。修改 顶层CMakeLists.txt 文件如下所示:
if (USE_MYMATH)
  include_directories ("${PROJECT_SOURCE_DIR}/MathFunctions")
  add_subdirectory (math)
  # 将 ${EXTRA_LIBS} 变量中旧有的内容和 MathFunctions 
  # 都加入到EXTRA_LIBS变量中
  set (EXTRA_LIBS ${EXTRA_LIBS} MathFunctions)
endif (USE_MYMATH)
 
# add the executable
add_executable(Demo ${DIR_SRCS})
target_link_libraries(Demo ${EXTRA_LIBS})

PS: 这里我们使用了 USE_MYMATH 这个宏,倘若在源码中也想使用它,那么需要由 CMake 通过在配置文件 Config.h 添加以下代码:

#cmakedefine USE_MYMATH

之后源码 include 该头文件(Config.h)来实现。


导入外部库

本地导入(find_package)

本节示例的目录结构如下:

.
├── CMakeLists.txt
├── main.cpp
└── README.adoc

boost 为例,演示如何导入一个本地的第三方库, MakeLists.txt 内容如下:

cmake_minimum_required(VERSION 3.5)

# Set the project name
project (third_party_include)
# 使用库文件系统和系统查找 boost install
# 注意这是第三方库,而不是自己生成的静态动态库
find_package(Boost 1.46.1 REQUIRED COMPONENTS filesystem system)
if(Boost_FOUND)
    message ("boost found")
else()
    message (FATAL_ERROR "Cannot find Boost")
endif()

# Add an executable
add_executable(third_party_include main.cpp)

# link against the boost libraries
target_link_libraries( third_party_include
    PRIVATE
    Boost::filesystem
)

使用 find_package 命令来在本地搜索对应的第三方库,它的参数的含义如下:

  • Boost 代表需要查询的库名称;
  • 1.46.1 代表需要库的最低版本;
  • REQUIRED 表示该库是必须的,如果找不到会报错;
  • COMPONENTS 用于检测该库的对应组件是否存在,如果不存在则认为找到的库不满足条件。
  • filesystemsystem 代表搜索的位置,分别是 库文件系统文件系统

外部导入(FetchContent)

FetchContent3.11.0 版本开始提供的功能,只需要一个 URL 或者 Git 仓库即可引入一个库,这里以 GoogleTest 库为例:

cmake_minimum_required(VERSION 3.14)
project(my_project)

# GoogleTest requires at least C++11
set(CMAKE_CXX_STANDARD 11)

include(FetchContent)
FetchContent_Declare(
  googletest
  URL https://github.com/google/googletest/archive/609281088cfefc76f9d0ce82e1ff6c30cc3591e5.zip
)
# 对于Windows:防止重写父项目的编译器/链接器设置
set(gtest_force_shared_crt ON CACHE BOOL "" FORCE)
FetchContent_MakeAvailable(googletest)
  1. include(FetchContent) :表示引入 FetchContent
  2. FetchContent_Declare(第三方库) :获取第三方库,可以是一个 URL 或者一个 Git 仓库。
  3. FetchContent_MakeAvailable(第三方库) :将这个第三方库引入项目。
  4. target_link_libraries(主项目 PRIVATE 子模块::子模块) :链接这个第三方库。

安装与测试

安装

示例的目录结构如下:

.
├── CMakeLists.txt
├── config.h.in
├── License.txt
├── main.cc
└── math
    ├── CMakeLists.txt
    ├── MathFunctions.cc
    └── MathFunctions.h

math 目录下的 CMakeLists.txt

# 查找当前目录下的所有源文件
# 并将名称保存到 DIR_LIB_SRCS 变量
aux_source_directory(. DIR_LIB_SRCS)

# 指定生成 MathFunctions 链接库
add_library (MathFunctions ${DIR_LIB_SRCS})

# 指定 MathFunctions 库的安装路径
install (TARGETS MathFunctions DESTINATION lib)
install (FILES MathFunctions.h DESTINATION include)

通过 install 命令:

  • 静态库 MathFunctions 安装到 /usr/local/lib 目录下
  • 头文件 MathFunctions.h 安装到 /usr/local/include 目录下。

根目录 下的 CMakeLists.txt 中的 install 内容:

# 指定安装路径
install (TARGETS Demo DESTINATION bin)
install (FILES "${PROJECT_BINARY_DIR}/config.h"
         DESTINATION include)
  • 可执行程序 Demo 安装到了 /usr/local/lib 目录下;
  • 头文件 config.h 安装到 /usr/local/lib 目录下。

PS:/usr/local/ 是默认安装的根目录,可以通过修改 CMAKE_INSTALL_PREFIX 变量来指定文件安装文件的根目录


测试

CMake 提供了一个名为 CTest 的测试工具。它通过 add_test 命令来进行相关测试,项目根目录的 CMakeLists.txt 文件中的 add_test 命令内容如下:

# 启用测试
enable_testing()

# 测试程序是否成功运行
add_test (test_run Demo 5 2)

# 测试帮助信息是否可以正常提示
add_test (test_usage Demo)
set_tests_properties (test_usage
  PROPERTIES PASS_REGULAR_EXPRESSION "Usage: .* base exponent")

# 测试 5 的平方
# add_test (test_5_2 Demo 5 2)

# set_tests_properties (test_5_2
#  PROPERTIES PASS_REGULAR_EXPRESSION "is 25")

# 测试 10 的 5 次方
# add_test (test_10_5 Demo 10 5)

# set_tests_properties (test_10_5
#  PROPERTIES PASS_REGULAR_EXPRESSION "is 100000")

# 测试 2 的 10 次方
# add_test (test_2_10 Demo 2 10)

# set_tests_properties (test_2_10
#  PROPERTIES PASS_REGULAR_EXPRESSION "is 1024")


# 如果觉得上述过程过于复杂
# 也可以定义一个宏,用来简化测试工作
macro (do_test arg1 arg2 result)
  add_test (test_${arg1}_${arg2} Demo ${arg1} ${arg2})
  set_tests_properties (test_${arg1}_${arg2}
    PROPERTIES PASS_REGULAR_EXPRESSION ${result})
endmacro (do_test)

# 利用 do_test 宏,测试一系列数据
do_test (5 2 "is 25")
do_test (10 5 "is 100000")
do_test (2 10 "is 1024")
  • enable_testing:用于启动测试。
  • add_test:用于添加测试
    • 第一个参数为测试名;
    • 第二个参数为可执行程序;
    • 剩下的为可执行程序的参数。
  • set_tests_properties:测试的提示信息。
  • PASS_REGULAR_EXPRESSION :测试属性(正则表达式)来验证输出中是否包含了特定的字符串。这里验证开方是否正确并且在计算错误时输出输出对应信息。
  • macro:宏,用于编写一个重复性操作来简化测试用例的编写。
  • do_test:编写的测试宏。

生成安装包

如果想要生成安装包,则需要使用 CMake 提供的打包工具 CPack。此时需要在 CMakeLists.txt 中添加以下内容:

# 构建一个 CPack 安装包
include (InstallRequiredSystemLibraries)
set (CPACK_RESOURCE_FILE_LICENSE
  "${CMAKE_CURRENT_SOURCE_DIR}/License.txt")
set (CPACK_PACKAGE_VERSION_MAJOR "${Demo_VERSION_MAJOR}")
set (CPACK_PACKAGE_VERSION_MINOR "${Demo_VERSION_MINOR}")
include (CPack)
  • include (InstallRequiredSystemLibraries):导入 InstallRequiredSystemLibraries 模块。
  • 设置一些 CPack 相关变量。
  • include (CPack):导入 CPack 模块。

接着执行 cmakemake 构建工程,此时再执行 cpack 命令即可生成安装包:

#生成二进制安装包
cpack -C CPackConfig.cmake

#生成源码安装包
cpack -C CPackSourceConfig.cmake

当命令执行成功后,就会在当前目录下生成 *.sh*.tar.gz*.tar.Z 这三个格式的安装包。文章来源地址https://www.toymoban.com/news/detail-401776.html

到了这里,关于Mac 下 CMake 的配置与使用的文章就介绍完了。如果您还想了解更多内容,请在右上角搜索TOY模板网以前的文章或继续浏览下面的相关文章,希望大家以后多多支持TOY模板网!

本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若转载,请注明出处: 如若内容造成侵权/违法违规/事实不符,请点击违法举报进行投诉反馈,一经查实,立即删除!

领支付宝红包 赞助服务器费用

相关文章

  • Linux:tomcat (源码包安装)(官网下载-安装-启动-配置-等等等-----从入门到入土)

    Apache Tomcat®软件是一个开源实现 Jakarta Servlet、Jakarta Server Pages、Jakarta Expression Language、Jakarta WebSocket、Jakarta Annotations 和 Jakarta Authentication 规范。 这些规范是Jakarta EE平台的一部分。 Apache Tomcat软件是在开放和参与式中开发的。 环境,并在 Apache 许可证版本 2 下发布。这

    2024年02月10日
    浏览(53)
  • postman下载安装和基础使用教程(官网)

    一、下载 1.百度搜索postman,找到官网,点击进去 2.点击Windows的图标,进入下载页面 3.点击Windows64位下载   4.下载完如图所示,双击或右击进行安装 二、安装、使用  5.点击第一个即可  6.此时浏览器会打开一个网址,注册postman账号即可  7.注册账号登录后,打开postman 8.点击

    2024年02月15日
    浏览(97)
  • Ubuntu系统 不使用snap安装firefox,使用firefox官网下载的安装包安装firefox

    某天,我嫌弃snap占内存,然后我使用以下命令卸载snap 然后无事发生… 后来我关机,在开机—— 然后???? 我的firefox不见了,还有其他的软件不见了… 重新装snap (为了卸载干净,之前没有先卸载snap安装的包,就直接 sudo apt autoremove --purge snapd ,是卸载不干净的;也是为

    2024年02月07日
    浏览(38)
  • 如何在Oracle官网下载JAVA SE 8版本(JDK 1.8.0)并在Linux系统下安装jdk及环境配置

    1.下载安装包 Java Archive Downloads - Java S 8 进入Oracle官网选择Linux版本jdk8  它会需要一个Oracle账号,如果无法注册可选择百度云下载 链接: https://pan.baidu.com/s/1IrWKc4R9BDPfI56sL7fXCg 提取码: 8888  2.指定安装目录 ① 将该压缩包放到 /usr/local 目录下 ② 然后解压该压缩包,如下指令:

    2024年04月25日
    浏览(63)
  • Mac下载安装Redis以及配置

    使用Homebrew安装Redis 1、安装HomeBrew之前,需要你安装Node.js和npm。这里去Node.js官网下载16.20.0版本的或者之前的也可以,但是18和以后的一些版本,项目是跑不起来的。 node-v16.20.0 安装之后,会自动安装Node.js和npm管理工具: 在终端中可以通过node -v 或者 npm -v查看版本号,npm安装

    2024年02月07日
    浏览(46)
  • mac 下载、安装、配置mysql详细教程

    一、官网下载安装包 打开官网后,按下图选择: 拉到最下面选择社区版本: 选择 MySQL Community Server 版本: 下面一定要选择dmg格式文件: 选择不登陆,直接安装: 二、安装指南 双击dmg文件解压,然后双击pkg文件 点击允许: 继续: 继续: 一定要选择Use Legacy Password Encrypti

    2024年02月16日
    浏览(56)
  • Charles下载安装及配置之Mac

    因工作需要用到抓包工具,但Fiddler不能在mac上使用,所以找到了Charles,Charles其实是一款代理服务器,通过过将自己设置成系统(电脑或者浏览器)的网络访问代理服务器,然后截取请求和请求结果达到分析抓包的目的。该软件是用Java写的,能够在Windows,Mac,Linux上使用。安

    2024年02月04日
    浏览(33)
  • Mac golang下载安装以及环境变量配置

    下载地址: All releases - The Go Programming Language

    2024年02月19日
    浏览(61)
  • Mac配置CMake

    1、本文内容 Mac上配置CMake 2、平台 Mac 3、转载请注明出处: https://blog.csdn.net/qq_41102371/article/details/131807995 通过brew安装,先安装brew https://blog.csdn.net/hechenhongbo/article/details/121658811 下载CMake https://cmake.org/download/ 根据自己的系统选择dmg文件 打开dmg,点击CMake,将左侧CMake图标往app

    2024年02月07日
    浏览(28)
  • Mac安装cmake实践

    去cmake官网下载对应版本的binaries or source code archives。 我 电脑:Apple M1 Pro 、 macOS:版本13.0.1 (22A400) ,下载的 cmake-3.26.0-rc2-macos-universal.dmg 版本 点击dmg拖拽安装后实验失败 于是在电脑 Launchpad(启动台) 找到 CMake 图标,点击启动 点击 Tools ,选择 How to Install For Command Line Use 给了

    2024年02月16日
    浏览(31)

觉得文章有用就打赏一下文章作者

支付宝扫一扫打赏

博客赞助

微信扫一扫打赏

请作者喝杯咖啡吧~博客赞助

支付宝扫一扫领取红包,优惠每天领

二维码1

领取红包

二维码2

领红包