我可以从一组较小的文件中构建 CMakeLists.txt（以提高 CMakeLists.txt 的可读性和可维护性）

Question

我正在构建一个中型 C++ 库，我的 CMakeLists.txt 文件开始变得有点长。我正在阅读 Robert Martin 的书The Clean Coder，他在其中讨论了简洁编码风格的元素，以实现代码维护和可读性。

所以我想看看是否可以将我的 CMakeLists.txt 文件分解为一组较小的文件——当我运行构建命令时它们会集成在一起。然后我可以管理这些较小的文件，就像我将类分解为单独的文件一样。现在作为警告，我不会为库的不同元素构建单独的可执行文件。我只是在构建一个包含一组其他项目所需的类和函数的库。

这是我当前的 CMakeLists.txt 文件。然后我会展示我想如何分解它。

cmake_minimum_required(VERSION 3.7)
project(tvastrCpp)
set (tvastrCpp_VERSION_MAJOR 0)
set (tvastrCpp_VERSION_MINOR 1)


# Find CGAL
find_package(CGAL REQUIRED COMPONENTS Core) # If the dependency is required, use REQUIRED option - if it's not found CMake will issue an error
include( ${CGAL_USE_FILE} )
include(ExternalProject)
set(CMAKE_CXX_STANDARD 14)
find_package(Eigen3 3.1.0)
if (EIGEN3_FOUND)
    include( ${EIGEN3_USE_FILE} )
endif()

find_package(Boost 1.58.0 REQUIRED COMPONENTS system filesystem program_options chrono timer date_time REQUIRED)

if(NOT Boost_FOUND)
    message(FATAL_ERROR "NOTICE: This demo requires Boost and will not be compiled.")
endif()

set(Boost_USE_STATIC_LIBS        ON)
set(Boost_USE_MULTITHREADED      ON)
set(Boost_USE_STATIC_RUNTIME    OFF)


INCLUDE_DIRECTORIES(${Boost_INCLUDE_DIRS})
LINK_DIRECTORIES(${Boost_LIBRARY_DIRS})

ExternalProject_Add(
        catch
        PREFIX ${CMAKE_BINARY_DIR}/catch
        GIT_REPOSITORY https://github.com/philsquared/Catch.git
        TIMEOUT 10
        UPDATE_COMMAND ${GIT_EXECUTABLE} pull
        CONFIGURE_COMMAND ""
        BUILD_COMMAND ""
        INSTALL_COMMAND ""
        LOG_DOWNLOAD ON
)

ExternalProject_Get_Property(catch source_dir)
set(CATCH_INCLUDE_DIR ${source_dir}/single_include CACHE INTERNAL "Path to include folder for Catch")

INCLUDE_DIRECTORIES ( "${EIGEN3_INCLUDE_DIR}" )

file(GLOB lib_SRC RELATIVE "lib" "*.h" "*.cpp")
file(GLOB test_SRC RELATIVE "tests" "*.h" "*.cpp")


# need to fix the instruction below to reference library
set(SOURCE_FILES ${lib_SRC})
add_library(tvastrCpp SHARED ${SOURCE_FILES})

add_executable(${PROJECT_NAME} main.cpp random_mat_vector_generator.h random_mat_vector_generator.cpp)
add_executable(my_tests testcases.cpp RipsComplex.h RipsComplex.cpp random_mat_vector_generator.h random_mat_vector_generator.cpp)
add_executable(gd_validator gudhi_validator.cpp)
TARGET_LINK_LIBRARIES( gd_validator ${Boost_LIBRARIES} )

enable_testing(true)
add_test(NAME cooltests COMMAND my_tests)

现在我想为基本设置创建一个单独的文件：

 settings.txt:
cmake_minimum_required(VERSION 3.7)
project(tvastrCpp)
set (tvastrCpp_VERSION_MAJOR 0)
set (tvastrCpp_VERSION_MINOR 1)

然后一个单独的部分用于查找 CGAL 库：

find_cgal.txt:
find_package(CGAL REQUIRED COMPONENTS Core) # If the dependency is required, use REQUIRED option - if it's not found CMake will issue an error
include( ${CGAL_USE_FILE} )
include(ExternalProject)
set(CMAKE_CXX_STANDARD 14)
find_package(Eigen3 3.1.0)
if (EIGEN3_FOUND)
    include( ${EIGEN3_USE_FILE} )
endif() 

等等。

Answer 1

将您的 CMakeLists.txt 拆分为：

项目的顶级文件：

• 包含项目的所有常用设置
• 包括外部项目
• 包括子目录
• 设置通用编译器设置
• 构建目标

可重用函数文件：

• 将您自己的 CMake 宏和函数存储到一个单独的文件中，以便在您的不同项目中重复使用它

源文件：

• 在源代码的每个子目录中放置一个 CMakeList.txt
• 将此处的源添加到变量 SOURCE 并使用 PARENT SCOPE

测试：

• 使用额外的 CMakeLists.txt 构建单元测试
• 在大型测试环境的情况下重用之前的 CMake 文件结构

我有一个包含一个 CMakeLists.txt 的小项目和一个包含最多 10 个文件的单个库的大型项目。