單元測試是對軟件基本組成單元進行的測試舟茶，可以用于對某個功能或者某個類或某個函數(shù)進行測試。善用單元測試可以有效提高開發(fā)效率堵第，使用單元測試編寫代碼的也更加可靠性吧凉。GTest 全程 Google Test，是 Google 推出的 C++ 測試框架型诚，可以提高編寫單元測試用例的效率客燕。本文示例是基于 clion 編寫的程序，這是至今最好用的 C++ IDE之一狰贯，極力推薦使用也搓。
下載GTest到項目
首先到 googletest 下載源碼赏廓，由于項目中已經(jīng)包含了 CMakeLists.txt 文件，只需要把代碼復(fù)制到項目中傍妒，如果 cmake 的版本低于 3.11.0幔摸，推薦通過 git submodule 方式引入到項目，cmake 3.11.0 以上通過 FetchContent 添加依賴颤练，不需要把源碼拷貝進來正式項目既忆。
目錄結(jié)構(gòu)
這里推薦把 gtest 源碼拷貝到 third_party 目錄下。
├── CMakeLists.txt
├── src
│ ├── CMakeLists.txt
│ ├── add.cpp
│ └── add.h
├── test
│ ├── CMakeLists.txt
│ ├── main.cpp
│ └── test.cpp
└── third_party
└── gtest
├── googletest
├── CMakeLists.txt
└── ...
編寫代碼
src/add.h
#ifndef ADD_HPP
#define ADD_HPP
int add(int a, int b);
#endif // ADD_HPP
src/add.cpp
#include "add.h"
int add(int a, int b) {
return a + b;
}
src/CMakeLists.txt
cmake_minimum_required(VERSION 3.10.2)
project(src)
# 定義需要參與編譯的源文件
aux_source_directory(. source)
# 把源碼添加進來參與編譯
add_library(${PROJECT_NAME} ${source})
# 定義需要暴露的頭文件
target_include_directories(${PROJECT_NAME} PUBLIC ${PROJECT_SOURCE_DIR})
編寫單元測試用例
test/CMakeLists.txt
cmake_minimum_required(VERSION 3.17)
project(test)
add_executable(${PROJECT_NAME} main.cpp test.cpp)
target_link_libraries(${PROJECT_NAME} gtest src)
test/test.cpp
#include "gtest/gtest.h"
#include "add.h"
int main(int argc, char **argv) {
testing::InitGoogleTest(&argc, argv);
return RUN_ALL_TESTS();
}
TEST(SuiteName, TestName1) {
int expected = 3;
int actual = add(1, 2);
ASSERT_EQ(expected, actual);
}
TEST(SuiteName, TestName2) {
int expected = 3;
int actual = add(1, 3);
ASSERT_EQ(expected, actual);
}
main.cpp
#include "gtest/gtest.h"
#include "add.h"
int main(int argc, char **argv) {
testing::InitGoogleTest(&argc, argv);
return RUN_ALL_TESTS();
}
根目錄 CMakeLists.txt
cmake_minimum_required(VERSION 3.17)
project(gtest_example)
set(CMAKE_CXX_STANDARD 14)
add_subdirectory(src)
add_subdirectory(test)
add_subdirectory(third_party/gtest)
運行用例
運行所有用例
可以通過運行 main 函數(shù)嗦玖，會運行所有的測試用例患雇。
對單個文件所有用例測試
右擊頁面的空白處，可以對整個文件的用例進行測試宇挫。
測試單個用例
也可以點擊測試用例的前面的運行按鈕對用例進行單獨測試苛吱。
示例源碼
https://github.com/taoweiji/cpp-cmake-example/tree/master/gtest-sample
