组织跨平台的C/ c++项目

Organize cross-platform C/C++ project

本文关键字:c++ 项目 跨平台      更新时间:2023-10-16

如何组织多平台(Windows, Linux) C/C++库项目通常/推荐的方法是什么?

如何命名函数并提供依赖于操作系统的实现,组织包含等?请只提供建设性的意见——不要像"看看Linux.",ideas strongly welcome .

这取决于您使用的构建系统。许多跨平台构建系统都有自己的组织方式。

对于代码本身,提供一个头文件是很常见的,但是针对给定系统的实现文件的链接,所以您可能有:

system.h
system_linux.cpp
system_windows.cpp
system_osx.cpp
...

…用于收集操作系统相关的东西。

但总的来说,最好的方法是实际看看一些(比Linux小)多平台项目:p

我使用文件夹来存放依赖的头文件/源文件,如下例所示

fs/filessystem .hpp <——main通用头文件,这是你在任何项目中包含的文件,你可以在其中创建一个#define来确保一个人只包含这个文件,如果他们在下面包含一个子文件,它会给出一个编译错误,把这个文件指向要包含的文件。

fs/linux/filessystem .hpp <——linux头文件#包含在主文件#ifdef linux中

fs/windows/filessystem .hpp <——头文件#包含在主文件#ifdef windows中

fs/linux/filessystem .cpp <——linux的实现

fs/windows/filessystem .cpp <——windows实现

然后在我的构建系统中,很容易使用"$target"来包含构建中每个操作系统的相关源文件。

诀窍是创建一个可以对用户进行类型定义和隐藏的接口,以便他们只看到这个而不看到实现细节

我个人讨厌在类定义、类型、头文件等源文件中混杂着多个OS #ifdef,为了清晰和易于阅读,我更喜欢将所有内容片段化。

CMake是一个适用于许多平台的优秀元构建系统。Boost适用于大多数平台。Qt也很好。

尽量减少依赖项的数量。

CMake让你以一种与平台无关的方式询问有关平台的问题。Boost和Qt抽象了平台,所以你不必关心(那么多)。

我使用的方法是将所有特定于操作系统的函数包装到我自己的接口中。然后我在每个不同的操作系统(主要是Windows和Linux)上实现这个接口。

在编译时,我使用预处理器来检查它是哪个平台,然后包含适当的版本。

对于线程、磁盘I/O和时钟/时间,我经常这样做。

例如:

#ifdef _WIN32
#include <windows.h>
#include "windows_code.h"
#elif __linux
#include <unistd.h>
#include <pthread.h>
#include "linux_code.h"
#else
#error "Unrecognized Platform"
#endif