CMake官方教程中文翻译 Step 8: Adding a Custom Command and Generated File

Coastalforest

已于 2024-01-31 16:55:22 修改

阅读量579

点赞数 16

分类专栏： CMake 文章标签：机器人 linux c++ ubuntu

于 2024-01-31 15:36:59 首次发布

本文链接：https://blog.csdn.net/coastalforest/article/details/135953645

版权

CMake 专栏收录该内容

12 篇文章 0 订阅

订阅专栏

鉴于自己破烂的英语，所以把cmake的官方文档用谷歌翻译翻译下来方便查看。
英语好的同学建议直接去看cmake官方文档（英文）学习：地址点这里
或复制：https://cmake.org/cmake/help/latest/guide/tutorial/index.html

谷歌翻译可能有错，此文档的目的仅是加快观看英文官方文档的速度，所以请结合英文官方文档观看

Step 8: Adding a Custom Command and Generated File

假设，出于本教程的目的，我们决定永远不想使用平台 log 和 exp 函数，而是希望生成一个预计算值表以在 mysqrt 函数中使用。在本节中，我们将在构建过程中创建表，然后将该表编译到我们的应用程序中。

首先，我们删除 MathFunctions/CMakeLists.txt 中对 log 和 exp 函数的检查。然后从 mysqrt.cxx 中删除对 HAVE_LOG 和 HAVE_EXP 的检查。同时，我们可以删除#include 。

在 MathFunctions 子目录中，提供了一个名为 MakeTable.cxx 的新源文件来生成该表。

查看该文件后，我们可以看到该表是作为有效的 C++ 代码生成的，并且输出文件名作为参数传入。

下一步是创建 MathFunctions/MakeTable.cmake。然后，将适当的命令添加到文件中以构建 MakeTable 可执行文件，然后将其作为构建过程的一部分运行。需要一些命令来完成此操作。

首先，我们为 MakeTable 添加可执行文件。

MathFunctions/MakeTable.cmake
add_executable(MakeTable MakeTable.cxx)

创建可执行文件后，我们使用 target_link_libraries() 将tutorial_compiler_flags 添加到可执行文件中。

MathFunctions/MakeTable.cmake
target_link_libraries(MakeTable PRIVATE tutorial_compiler_flags)

然后我们添加一个自定义命令，指定如何通过运行 MakeTable 生成 Table.h。

MathFunctions/MakeTable.cmake
add_custom_command(
OUTPUT ${CMAKE_CURRENT_BINARY_DIR}/Table.h
COMMAND MakeTable ${CMAKE_CURRENT_BINARY_DIR}/Table.h
DEPENDS MakeTable
)

接下来我们必须让 CMake 知道 mysqrt.cxx 依赖于生成的文件 Table.h。这是通过将生成的 Table.h 添加到库 SqrtLibrary 的源列表中来完成的。

MathFunctions/CMakeLists.txt
add_library(SqrtLibrary STATIC
mysqrt.cxx
${CMAKE_CURRENT_BINARY_DIR}/Table.h
)

我们还必须将当前二进制目录添加到包含目录列表中，以便 mysqrt.cxx 可以找到并包含 Table.h。

MathFunctions/CMakeLists.txt
target_include_directories(SqrtLibrary PRIVATE
${CMAKE_CURRENT_BINARY_DIR}
)

link SqrtLibrary to tutorial_compiler_flags

作为最后一步，我们需要将 MakeTable.cmake 包含在 MathFunctions/CMakeLists.txt 的顶部。

MathFunctions/CMakeLists.txt
include(MakeTable.cmake)

现在让我们使用生成的表。首先，修改 mysqrt.cxx 以包含 Table.h。接下来，我们可以重写 mysqrt 函数来使用该表：

MathFunctions/mysqrt.cxx
double mysqrt(double x)
{
if (x <= 0) {
return 0;
}

// use the table to help find an initial value
double result = x;
if (x >= 1 && x < 10) {
std::cout << "Use the table to help find an initial value " << std::endl;
result = sqrtTable[static_cast(x)];
}

// do ten iterations
for (int i = 0; i < 10; ++i) {
if (result <= 0) {
result = 0.1;
}
double delta = x - (result * result);
result = result + 0.5 * delta / result;
std::cout << "Computing sqrt of " << x << " to be " << result << std::endl;
}

return result;
}
}
}

运行 cmake 可执行文件或 cmake-gui 来配置项目，然后使用您选择的构建工具进行构建。

构建此项目时，它将首先构建 MakeTable 可执行文件。然后它将运行 MakeTable 来生成 Table.h。最后，它将编译包含 Table.h 的 mysqrt.cxx 以生成 MathFunctions 库。

运行教程可执行文件并验证它是否正在使用该表。