第 4 步:安装和测试¶
现在我们可以开始为我们的项目添加安装规则和测试支持。
安装规则¶
安装规则相当简单:因为MathFunctions
我们要安装库和头文件,而对于应用程序,我们要安装可执行文件和配置的头文件。
所以在最后MathFunctions/CMakeLists.txt
我们添加:
install(TARGETS MathFunctions DESTINATION lib)
install(FILES MathFunctions.h DESTINATION include)
在顶层的末尾,CMakeLists.txt
我们添加:
install(TARGETS Tutorial DESTINATION bin)
install(FILES "${PROJECT_BINARY_DIR}/TutorialConfig.h"
DESTINATION include
)
这就是创建本教程的基本本地安装所需的全部内容。
现在运行cmake
可执行文件或 cmake-gui
配置项目,然后使用您选择的构建工具构建它。
然后使用以下install
选项 运行安装步骤cmake
命令行中的命令(在 3.15 中引入,旧版本的 CMake 必须使用)。对于多配置工具,不要忘记使用参数来指定配置。如果使用 IDE,只需构建 目标。此步骤将安装适当的头文件、库和可执行文件。例如:make install
--config
INSTALL
cmake --install .
CMake 变量CMAKE_INSTALL_PREFIX
用于确定安装文件的根目录。如果使用该 命令,可以通过 参数覆盖安装前缀。例如:cmake --install
--prefix
cmake --install . --prefix "/home/myuser/installdir"
导航到安装目录并验证安装的教程是否运行。
测试支持¶
接下来让我们测试我们的应用程序。在顶级CMakeLists.txt
文件的末尾,我们可以启用测试,然后添加一些基本测试来验证应用程序是否正常工作。
enable_testing()
# does the application run
add_test(NAME Runs COMMAND Tutorial 25)
# does the usage message work?
add_test(NAME Usage COMMAND Tutorial)
set_tests_properties(Usage
PROPERTIES PASS_REGULAR_EXPRESSION “Usage:.*number”
)
# define a function to simplify adding tests
function(do_test target arg result)
add_test(NAME Comp
<
/
s
p
a
n
>
<
s
p
a
n
c
l
a
s
s
=
"
n
t
"
>
a
r
g
<
/
s
p
a
n
>
<
s
p
a
n
c
l
a
s
s
=
"
o
"
>
<
/
s
p
a
n
>
<
s
p
a
n
c
l
a
s
s
=
"
w
"
>
<
/
s
p
a
n
>
<
s
p
a
n
c
l
a
s
s
=
"
n
o
"
>
C
O
M
M
A
N
D
<
/
s
p
a
n
>
<
s
p
a
n
c
l
a
s
s
=
"
w
"
>
<
/
s
p
a
n
>
<
s
p
a
n
c
l
a
s
s
=
"
o
"
>
{</span><span class="nt">arg</span><span class="o">}</span><span class="w"> </span><span class="no">COMMAND</span><span class="w"> </span><span class="o">
</span><spanclass="nt">arg</span><spanclass="o"></span><spanclass="w"></span><spanclass="no">COMMAND</span><spanclass="w"></span><spanclass="o">{target}
<
/
s
p
a
n
>
<
s
p
a
n
c
l
a
s
s
=
"
n
t
"
>
a
r
g
<
/
s
p
a
n
>
<
s
p
a
n
c
l
a
s
s
=
"
o
"
>
<
/
s
p
a
n
>
<
s
p
a
n
c
l
a
s
s
=
"
n
f
"
>
)
<
/
s
p
a
n
>
<
s
p
a
n
c
l
a
s
s
=
"
w
"
>
<
/
s
p
a
n
>
<
s
p
a
n
c
l
a
s
s
=
"
w
"
>
<
/
s
p
a
n
>
<
s
p
a
n
c
l
a
s
s
=
"
n
f
"
>
s
e
t
t
e
s
t
s
p
r
o
p
e
r
t
i
e
s
(
<
/
s
p
a
n
>
<
s
p
a
n
c
l
a
s
s
=
"
n
b
"
>
C
o
m
p
<
/
s
p
a
n
>
<
s
p
a
n
c
l
a
s
s
=
"
o
"
>
{</span><span class="nt">arg</span><span class="o">}</span><span class="nf">)</span><span class="w"></span> <span class="w"> </span><span class="nf">set_tests_properties(</span><span class="nb">Comp</span><span class="o">
</span><spanclass="nt">arg</span><spanclass="o"></span><spanclass="nf">)</span><spanclass="w"></span><spanclass="w"></span><spanclass="nf">settestsproperties(</span><spanclass="nb">Comp</span><spanclass="o">{arg}
PROPERTIES PASS_REGULAR_EXPRESSION ${result}
)
endfunction()
# do a bunch of result based tests
do_test(Tutorial 4 “4 is 2”)
do_test(Tutorial 9 “9 is 3”)
do_test(Tutorial 5 “5 is 2.236”)
do_test(Tutorial 7 “7 is 2.645”)
do_test(Tutorial 25 “25 is 5”)
do_test(Tutorial -25 “-25 is (-nan|nan|0)”)
do_test(Tutorial 0.0001 “0.0001 is 0.01”)
第一个测试只是验证应用程序是否运行,没有段错误或以其他方式崩溃,并且返回值为零。这是 CTest 测试的基本形式。
下一个测试使用PASS_REGULAR_EXPRESSION
test 属性来验证测试的输出是否包含某些字符串。在这种情况下,验证在提供不正确数量的参数时是否打印了使用消息。
最后,我们有一个调用函数do_test
来运行应用程序并验证计算的平方根对于给定的输入是否正确。对于 的每次调用do_test
,都会将另一个测试添加到项目中,其中包含名称、输入和基于传递的参数的预期结果。
重建应用程序,然后 cd 到二进制目录并运行 ctest
可执行文件:和。对于多配置生成器(例如 Visual Studio),必须使用标志指定配置类型。例如,要在 Debug 模式下运行测试,请使用二进制目录(而不是 Debug 子目录!)。发布模式将从同一位置执行,但使用. 或者,从 IDE构建目标。ctest -N
ctest -VV
-C <mode>
ctest -C Debug -VV
-C Release
RUN_TESTS