<<Modern CMake>> 翻译 2.4 项目目录结构

本节内容有点跑题。但我认为这是一个很好的方法。我将告诉你如何规划项目的目录。这是基于惯例，但将帮助您：

轻松阅读其他按照相同模式的项目，
避免导致冲突的模式，
避免混淆和使构建变得复杂。

首先，如果您的项目被叫做 project，包含一个链接库叫做 lib，一个可执行文件叫做 app，那么您的文件目录应该类似以下结构：

- project

  - .gitignore

  - README.md

  - LICENCE.md

  - CMakeLists.txt

  - cmake

    - FindSomeLib.cmake

  - include

    - project

      - lib.hpp

  - src

    - CMakeLists.txt

    - lib.cpp

  - apps

    - CMakeLists.txt

    - app.cpp

  - tests

    - testlib.cpp

  - docs

    - Doxyfile.in

  - extern

    - googletest

  - scripts

    - helper.py

名字不是绝对的; 你经常会看到关于 test/ vs. tests/ 的争论，应用程序文件夹可能被叫做其他名称（对于仅限库的项目不存在）。您还有时会看到 python 目录用于 python 绑定，或者一个 CMake 文件夹，来放置 CMake 助手文件，例如 Find<library>.cmake 文件。但主要文件夹上面都列出来了。

注意一些已经很明显的事情; CMakeLists.txt 文件被分别放置在所有源目录中，但 include 目录中没有。这是因为您应该能够拷贝 include 目录到 /usr/include 或者类似的地方（配置头文件除外，我将在另一章中介绍），没有任何额外的文件或导致任何冲突。这也是为什么在 include 目录中有一层 project 目录的原因。使用 add_subdirectory 来添加包含 CMakeLists.txt 文件的子目录。

您经常需要一个 cmake 目录来放置所有构造助手模块。这是你的 Find*.cmake 文件该存放的地方。一组常见的助手文件可以在这里看到 github.com/CLIUtils/cmake。

可以这样将此文件夹添加到 CMake 路径上：

set(CMAKE_MODULE_PATH "${PROJECT_SOURCE_DIR}/cmake" ${CMAKE_MODULE_PATH})

您的 extern 文件夹应该只包含 git 子模块。这样，您可以显式控制依赖项的版本，同时可以轻松升级。有关添加子模块的示例，请参阅“测试”一章。

在你的 .gitignore 中，你应该有一些像这样的东西 /build*，让用户可以在源代码目录创建编译目录，并在这些目录中构建项目。一些软件包禁止这样做，但它比做一个真正的源外构建要好得多，因为那样每次构建你必须为你构建的软件包键入不同的命令行。

如果要避免在源文件夹中直接进行构建，你可以将其下面这些行添加到你的 CMakeLists.txt 文件的顶部附近：

### Require out-of-source builds

file(TO_CMAKE_PATH "${PROJECT_BINARY_DIR}/CMakeLists.txt" LOC_PATH)

if(EXISTS "${LOC_PATH}")

    message(FATAL_ERROR "You cannot build in a source directory (or any directory with a CMakeLists.txt file). Please make a build subdirectory. Feel free to remove CMakeCache.txt and CMakeFiles.")

endif()

巴特西

<<Modern CMake>> 翻译 2.4 项目目录结构

<<Modern CMake>> 翻译 2.4 项目目录结构

最新文章

热门文章