步骤 8:添加自定义命令和生成文件¶
假设,为了本教程的目的,我们决定不再使用平台提供的 log
和 exp
函数,而是希望生成一个预计算值的表格以在 mysqrt
函数中使用。在本节中,我们将把表格的创建作为构建过程的一部分,然后将该表格编译到我们的应用程序中。
首先,让我们删除 MathFunctions/CMakeLists.txt
中对 log
和 exp
函数的检查。然后从 mysqrt.cxx
中删除对 HAVE_LOG
和 HAVE_EXP
的检查。同时,我们可以删除 #include <cmath>
。
在 MathFunctions
子目录中,提供了一个名为 MakeTable.cxx
的新源文件用于生成表格。
查看文件后,我们可以看到表格是以有效的 C++ 代码形式生成的,并且输出文件名作为参数传入。
下一步是创建 MathFunctions/MakeTable.cmake
。然后,向文件中添加适当的命令来构建 MakeTable
可执行文件,并将其作为构建过程的一部分运行。需要一些命令来完成此操作。
首先,我们为 MakeTable
添加一个可执行文件。
add_executable(MakeTable MakeTable.cxx)
创建可执行文件后,我们使用 target_link_libraries()
将 tutorial_compiler_flags
添加到我们的可执行文件。
target_link_libraries(MakeTable PRIVATE tutorial_compiler_flags)
然后我们添加一个自定义命令,指定如何通过运行 MakeTable 来生成 Table.h
。
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
的源文件列表中来完成。
add_library(SqrtLibrary STATIC
mysqrt.cxx
${CMAKE_CURRENT_BINARY_DIR}/Table.h
)
我们还需要将当前二进制目录添加到包含目录列表中,以便 mysqrt.cxx
可以找到并包含 Table.h
。
target_include_directories(SqrtLibrary PRIVATE
${CMAKE_CURRENT_BINARY_DIR}
)
# link SqrtLibrary to tutorial_compiler_flags
最后一步,我们需要将 MakeTable.cmake
包含在 MathFunctions/CMakeLists.txt
的顶部。
include(MakeTable.cmake)
现在让我们使用生成的表格。首先,修改 mysqrt.cxx
以包含 Table.h
。接下来,我们可以重写 mysqrt
函数以使用该表格
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<int>(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
库。
运行教程可执行文件并验证它正在使用表格。