FindGTest¶

定位 Google C++ 测试框架。

版本 3.20 新增: 如果可能，则使用上游 GTestConfig.cmake。

导入目标¶

版本 3.20 新增: 此模块定义了以下 IMPORTED 目标

GTest::gtest: 如果找到 Google Test gtest 库；自动添加 Thread::Thread
GTest::gtest_main: 如果找到 Google Test gtest_main 库

版本 3.23 新增。

GTest::gmock: 如果找到 Google Mock gmock 库；自动添加 Thread::Thread
GTest::gmock_main: 如果找到 Google Mock gmock_main 库

版本 3.20 起已弃用: 为了向后兼容，此模块还定义了以下已弃用的 IMPORTED 目标（自 3.5 版本起可用）

GTest::GTest: 如果找到 Google Test gtest 库；自动添加 Thread::Thread
GTest::Main: 如果找到 Google Test gtest_main 库

结果变量¶

此模块将在您的项目中设置以下变量

GTest_FOUND: 找到 Google 测试框架
GTEST_INCLUDE_DIRS: 包含 Google Test 头文件的目录

以下库变量设置为普通变量。当找到调试库时，这些变量包含 debug/optimized 关键字。

GTEST_LIBRARIES: Google Test gtest 库；请注意，它还需要与适当的线程库链接
GTEST_MAIN_LIBRARIES: Google Test gtest_main 库
GTEST_BOTH_LIBRARIES: gtest 和 gtest_main 两者

缓存变量¶

以下缓存变量也可能被设置

GTEST_ROOT: Google Test 安装的根目录（也可以设置为环境变量）
GTEST_MSVC_SEARCH: 如果使用 MSVC 编译，则可以将此变量设置为 MT 或 MD（默认值）以启用搜索 GTest 构建树

示例用法¶

enable_testing()
find_package(GTest REQUIRED)

add_executable(foo foo.cc)
target_link_libraries(foo GTest::gtest GTest::gtest_main)

add_test(AllTestsInFoo foo)

与 CTest 的更深集成¶

有关 gtest_add_tests() 和 gtest_discover_tests() 命令的信息，请参阅 GoogleTest。

版本 3.9 变更: 之前的 CMake 版本在此模块中定义了 gtest_add_tests() 宏。