tl;dr 问题在底部。

我是一名尝试新事物的开发人员 - 我的最后一毒是 C++。由于我一半时间花在我的 linux 笔记本电脑上，另一半时间花在 Win XP PC 上，我试图找到一种方法来创建基本的准系统项目，使用良好的 c++ 实践(好吧，我从经验中不知道它们，我刚刚读到它们)。现在我的项目在使用 cmake 时几乎可以正常工作。 && make 在 linux 上(当头文件和源文件位于同一文件夹中时它有效，当我将它们分开以包含/src 文件夹时失败)。我在 Windows 上使用 nuwen 的 mingw 发行版(我知道工具链正在运行，它从 Eclipse 中编译项目没有任何问题)。

我的项目目录如下所示:

engine 
    |
    |- main
         |
         |- include
                 |
                 |- App.h  
                 |- CMakeLists.txt (2)
         |- src
             |
             |- main.cc
             |- App.cc
             |- CMakeLists.txt (3)

    |- CMakLists.txt (1)

文件的内容非常简单(为清楚起见，我将删除包含保护等)

应用.h:

class App {
   public:
      App();
      int onExecute();
};

App.cc:

#include <iostream>
#include "App.h"

App::App() {
}

int App::onExecute() {
   std::cout << "inside app.." << '\n';
   return 0;
}

主.cc:

#include <iostream>
#include "App.h"

using namespace std;

int main(int argc, char* argv[]) {
  App a;

  a.onExecute();
  std::cout << "inside main.." << '\n';
}

CMakeLists.txt (1) - 主要部分:

cmake_minimum_required (VERSION 2.6)
set (CMAKE_CXX_COMPILER "g++")

project (gameengine)

add_definitions ( "-Wall -ansi -pedantic")

add_subdirectory (${CMAKE_SOURCE_DIR}/main/include)
add_subdirectory (${CMAKE_SOURCE_DIR}/main/src)

add_executable (engine ${CMAKE_SOURCE_DIR}/main/src/main.cc)
target_link_libraries (engine Application)

CMakeLists.txt (2) - 在包含目录中

add_library (Application App)
set_target_properties (Application PROPERTIES LINKER_LANGUAGE CXX)

CMakeLists.txt (3) - src 目录内

include_directories (../include)

这就是我所得到的 - 通过一些更改(即将 App.cc 移动到 include 目录)整个东西在 linux 上编译和运行良好 - 但我无法让 mingw 生成器在 Win XP 上工作.我手动调整了文件 CMakeCache.txt 中的 CMAKE_MAKE_PROGRAM 以指向正确的 make.exe(我知道这应该定义为系统变量但是因为我在许多不同的 PC 上工作，我不想在之后留下垃圾我)。

我的问题是:

1) 编写多平台 CMakeLists.txt 文件的指南是什么(它将独立于操作系统和项目文件的位置工作)，这最好能让我轻松地将我的项目配置从一个操作系统切换到另一个操作系统？

2) 如何解决找不到头文件的错误 (make gives: (...)\engine\main\src\main.cc:2:17: fatal error: App.h: No such文件或目录)？

感谢您的宝贵时间和帮助。

最佳答案

1) what are the guidelines for writing multiplatform CMakeLists.txt file (which will work independly of the os and the location of the project files), which preferably will allow me to easy swich my project configuration from one os the other one?

嗯，我当然不是专家，但我可以分享我 10 个月的跨平台基于 cmake 项目的经验。

马上我认为您真的应该使用源代码之外的构建。这意味着您不会在代码所在的同一目录中运行 cmake；相反，您创建一个新文件夹，例如engine/build然后运行 ​​cmake ../main从那里。这样你就不会用 cmake 的东西破坏你的源文件，比如 CMakeCache.txt 等。你甚至可以使用一些宏来禁止你的用户进行源内构建。

我还发现创建一组宏文件有助于为不同平台设置编译器选项。在工作中，我们有诸如 ADD_GCC_FLAG 之类的宏。或 ADD_MSVC_FLAG它检查当前的编译器并相应地添加标志。

我认为使用单个 .cmake 是个好习惯将所有项目配置集中在一个地方的文件。在工作中我们所有的CMakeLists.txt从 include( ../cmake/configs.cmake ) 开始.该文件设置各种选项，例如标准包含目录、默认编译器标志等。

为了解决包含目录的问题，我建议您在源文件中使用绝对路径而不是相对路径。定义一个标准的包含目录，例如 engine/main/include总是#include相对于该路径的文件。在您的示例中，如果您想包含 engine/main/include/somefolder/header.h , 你会写 #include <somefolder/header.h> (使用 <> 而不是引号告诉 C++ 预处理器在查找文件时跳过当前目录)。

2) how can I address the error of not finding the header file (make gives: (...)\engine\main\src\main.cc:2:17: fatal error: App.h: No such file or directory) ?

您的 cmake 布局存在许多问题，但您收到该错误的原因是您需要调用 include_directories在 CMakeLists.txt (1)

除此之外，你的另一个CMakeLists.txt文件也有问题。在 CMakeLists.txt (2) , add_library 的参数错了;应该是../src/App.cc ，否则你只是添加一个空库。你不需要那个 set_target_properties要么，至少如果你得到 add_library 就不会论据对。您还需要一个 include_directory调用相同的 CMakeLists.txt那就是添加库；把它放在 (3)并没有真正做任何事情。

实际上，您不需要 CMakeLists.txt文件在 include目录，因为那里没有什么可构建的。最好把add_library来电CMakeLists.txt (3) , 在调用 include_directories 之后.

我希望这能消除您的一些疑虑。

关于c++ - 设置基本的多平台启用 cmake 的项目时需要帮助，我们在Stack Overflow上找到一个类似的问题： https://stackoverflow.com/questions/4084917/