outman/googletest
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Merge f482391f3d into 445e9bd8d0

Browse Source
This commit is contained in:
jiemojiemo 2025-02-07 02:14:59 +00:00 committed by GitHub
commit 98413c2eb3
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
3 changed files with 265 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

29
docs/platforms-zh.md Normal file
View File

@ -0,0 +1,29 @@
# 支持的平台
GoogleTest 需要符合 C++11 标准或者更新标准的代码库和编译器
GoogleTest 代码在以下平台上获得了正式支持。下面未列出的操作系统或工具是社区支持的。对于社区支持的平台，可以考虑使用不使代码复杂化的补丁。
如果在你的平台上发现任何问题，请将问题提交到 [GoogleTest GitHub Issue Tracker](https://github.com/google/googletest/issues). 欢迎提交 Pull requests 进行修复！
### 操作系统
* Linux
* macOS
* Windows
### 编译器
* gcc 5.0+
* clang 5.0+
* MSVC 2015+
**macOS 用户:** Xcode 9.3+ 提供了 clang 5.0+.
### 构建系统
* [Bazel](https://bazel.build/)
* [CMake](https://cmake.org/)
Bazel 是 google 团队内部和测试中使用的构建系统。CMake 是由开源社区支持的构建系统。

113
docs/quickstart-bazel-zh.md Normal file
View File

@ -0,0 +1,113 @@
# 快速入门：使用 Bazel 构建
这个教程旨在让你使用 Bazel 构建和运行 GoogleTest。如果你是第一次使用 GoogleTest，或者需要复习一下，我们建议将本教程作为起点。
## 前提条件
为了完成这个教程，你需要的工具有：
+ 一个兼容的操作系统（例如 Linux，macOS，Windows）。
+ 一个兼容的 C++ 编译器，至少支持 C++11。
+ [Bazel](https://bazel.build/)，GoogleTest 团队使用的首选构建系统。
更多关于 GoogleTest 兼容平台的信息，请参见 [支持的平台](platforms-zh.md)。
如果你没有安装 Bazel，参考 [Bazel installation guide](https://docs.bazel.build/versions/master/install.html)。
{: .callout .note}
注意: 本教程中的终端命令显示的是 Unix shell，但这些命令在 Windows 命令行是哪个也可以使用。
## 建立一个 Bazel 工作区
[Bazel 工作区](https://docs.bazel.build/versions/master/build-ref.html#workspace) 是你文件系统上的一个目录，用于管理你想要构建的系统的源文件。每个工作区有个文本文件叫做 `WORKSPACE`，它可能是空的，也可能包含构建需要的外部依赖的引用。
首先，为你的工作区创建一个目录：
```
$ mkdir my_workspace && cd my_workspace
```
接着，创建 `WORKSPACE` 文件来指定依赖关系。为了依赖 GoogleTest，一种常见且推荐方式是通过 [`http_archive` 规则](https://docs.bazel.build/versions/master/repo/http.html#http_archive) 使用 [Bazel 外部依赖](https://docs.bazel.build/versions/master/external.html)。为此，在你的工作空间根目录下（`my_workspace/`）创建一个名为`WORKSPACE`的文件，内容为：
```
load("@bazel_tools//tools/build_defs/repo:http.bzl", "http_archive")
http_archive(
name = "com_google_googletest",
urls = ["https://github.com/google/googletest/archive/609281088cfefc76f9d0ce82e1ff6c30cc3591e5.zip"],
strip_prefix = "googletest-609281088cfefc76f9d0ce82e1ff6c30cc3591e5",
)
```
上述配置声明了对 GoogleTest 的依赖，GoogleTest 将以 ZIP 文件的形式从 Gihub 中下载。上述例子中，`609281088cfefc76f9d0ce82e1ff6c30cc3591e5`即 GoogleTest 版本的 Git commit ID。建议经常更新该值，以指向最新的版本。
现在你已经准备好构建使用 GoogleTest 的 C++ 代码了。
## 创建并运行
随着 Bazel 工作区的建立，现在可以在你的项目中使用 GoogleTest 代码了。
举个例子，在 `my_workspace` 目录下创建 `hello_test.cc` 文件，内容为：
```cpp
#include <gtest/gtest.h>
// Demonstrate some basic assertions.
TEST(HelloTest, BasicAssertions) {
// Expect two strings not to be equal.
EXPECT_STRNE("hello", "world");
// Expect equality.
EXPECT_EQ(7 * 6, 42);
}
```
GoogleTest 提供了许多 [断言](primer.md#assertions)，可以用它们来测试代码的行为。上述示例中引入了 GoogleTest 的头文件并演示了一些基本的断言。
为了编译代码，请在相同目录下创建一个叫 `BUILD` 的文件，内容为：
```
cc_test(
name = "hello_test",
size = "small",
srcs = ["hello_test.cc"],
deps = ["@com_google_googletest//:gtest_main"],
)
```
`cc_test` 规则声明了你要建立的测试可执行文件，并通过在 `WORKSPACE` 文件中指定的前缀（`@com_google_googletest`）去链接 GoogleTest。更多关于 Bazel `BUILD`文件的内容，请参考 [Bazel C++ Tutorial](https://docs.bazel.build/versions/master/tutorial/cpp.html)。
现在你可以投建并运行你的测试了：
<pre>
<strong>my_workspace$ bazel test --test_output=all //:hello_test</strong>
INFO: Analyzed target //:hello_test (26 packages loaded, 362 targets configured).
INFO: Found 1 test target...
INFO: From Testing //:hello_test:
==================== Test output for //:hello_test:
Running main() from gmock_main.cc
[==========] Running 1 test from 1 test suite.
[----------] Global test environment set-up.
[----------] 1 test from HelloTest
[ RUN ] HelloTest.BasicAssertions
[ OK ] HelloTest.BasicAssertions (0 ms)
[----------] 1 test from HelloTest (0 ms total)
[----------] Global test environment tear-down
[==========] 1 test from 1 test suite ran. (0 ms total)
[ PASSED ] 1 test.
================================================================================
Target //:hello_test up-to-date:
bazel-bin/hello_test
INFO: Elapsed time: 4.190s, Critical Path: 3.05s
INFO: 27 processes: 8 internal, 19 linux-sandbox.
INFO: Build completed successfully, 27 total actions
//:hello_test PASSED in 0.1s
INFO: Build completed successfully, 27 total actions
</pre>
恭喜！你已经成功地使用 GoogleTest 构建并运行了一个测试。
## 下一步行动
* [查看 Primer](primer.md) 开始学习如何编写简单的测试。
* [看看更多例子](samples.md)学习如何使用 GoogleTest 的各种功能。

123
docs/quickstart-cmake-zh.md Normal file
View File

@ -0,0 +1,123 @@
# 快速入门：使用 CMake 构建
这个教程旨在让你使用 CMake 构建和运行 GoogleTest。如果你是第一次使用 GoogleTest，或者需要复习一下，我们建议将本教程作为起点。如果你的项目使用 Bazel，请参阅 [快速入门：使用 Bazel 构建](quickstart-bazel-zh.md)
## 前提条件
为了完成这个教程，你需要的工具有：
+ 一个兼容的操作系统（例如 Linux，macOS，Windows）。
+ 一个兼容的 C++ 编译器，至少支持 C++11。
+ [CMake](https://cmake.org/) 以及一系列用于构建的工具。
+ 构建工具包括 [Make](https://www.gnu.org/software/make/)，[Ninja](https://ninja-build.org/)，和其他，更多信息请参考[CMake Generators](https://cmake.org/cmake/help/latest/manual/cmake-generators.7.html。
更多关于 GoogleTest 兼容平台的信息，请参见 [支持的平台](platforms-zh.md) 。
如果你没有安装 CMake，参考 [CMake installation guide。](https://cmake.org/install)
{: .callout .note}
注意: 本教程中的终端命令显示的是 Unix shell，但这些命令在 Windows 命令行是哪个也可以使用。
## 建立一个项目
CMake 使用一个叫 `CMakeLists.txt` 的文件来配置项目的构建系统。使用此文件来设置项目并声明对 GoogleTest 的依赖。
首先，为你的项目创建一个目录：
```
$ mkdir my_project && cd my_project
```
接着，创建 `CMakeLists.txt` 文件并声明对 GoogleTest 的依赖。在 CMake 系统中，有很多方法来表达依赖关系；在本教程中，你将使用 [`FetchContent` CMake 模块](https://cmake.org/cmake/help/latest/module/FetchContent.html)。为此，在工程目录下（`my_project`）创建一个名为 `CMakeLists.txt` 的文件，其内容为：
```cmake
cmake_minimum_required(VERSION 3.14)
project(my_project)
# GoogleTest requires at least C++11
set(CMAKE_CXX_STANDARD 11)
include(FetchContent)
FetchContent_Declare(
googletest
URL https://github.com/google/googletest/archive/609281088cfefc76f9d0ce82e1ff6c30cc3591e5.zip
)
# For Windows: Prevent overriding the parent project's compiler/linker settings
set(gtest_force_shared_crt ON CACHE BOOL "" FORCE)
FetchContent_MakeAvailable(googletest)
```
上述配置声明了对 GoogleTest 的依赖，其中 GoogleTest 将从 Github 上下载。上述例子中，`609281088cfefc76f9d0ce82e1ff6c30cc3591e5` 即 GoogleTest 版本的 Git commit ID。建议经常更新该值，以指向最新的版本。
关于如何创建 `CMakeLists.txt` 文件的更多信息，请参与 [CMake Tutorial](https://cmake.org/cmake/help/latest/guide/tutorial/index.html)。
## 创建并运行
有了 GoogleTest 的依赖后，你就可以在项目中使用 GoogleTest 了。
举个例子，在 `my_project` 目录下创建 `hello_test.cc` 文件，内容为：
```cpp
#include <gtest/gtest.h>
// Demonstrate some basic assertions.
TEST(HelloTest, BasicAssertions) {
// Expect two strings not to be equal.
EXPECT_STRNE("hello", "world");
// Expect equality.
EXPECT_EQ(7 * 6, 42);
}
```
GoogleTest 提供了许多 [断言](primer.md#assertions)，可以用它们来测试代码的行为。上述示例中引入了 GoogleTest 的头文件并演示了一些基本的断言。
为了编译代码，在 `CMakeLists.txt` 末尾添加以下内容：
```cmake
enable_testing()
add_executable(
hello_test
hello_test.cc
)
target_link_libraries(
hello_test
gtest_main
)
include(GoogleTest)
gtest_discover_tests(hello_test)
```
上述配置在 CMake 中启动了测试，声明了你想要建立的测试可执行文件（`hello_test`）并链接了 GoogleTest（`gtest_main`）。最后两行使用 [`GoogleTest` CMake 模块](https://cmake.org/cmake/help/git-stage/module/GoogleTest.html) 让 CMake 的测试运行器能找到并执行测试。
现在你可以投建并运行你的测试了：
<pre>
<strong>my_project$ cmake -S . -B build</strong>
-- The C compiler identification is GNU 10.2.1
-- The CXX compiler identification is GNU 10.2.1
...
-- Build files have been written to: .../my_project/build
<strong>my_project$ cmake --build build</strong>
Scanning dependencies of target gtest
...
[100%] Built target gmock_main
<strong>my_project$ cd build && ctest</strong>
Test project .../my_project/build
Start 1: HelloTest.BasicAssertions
1/1 Test #1: HelloTest.BasicAssertions ........ Passed 0.00 sec
100% tests passed, 0 tests failed out of 1
Total Test time (real) = 0.01 sec
</pre>
恭喜！你已经成功地使用 GoogleTest 构建并运行了一个测试。
## 下一步行动
* [查看 Primer](primer.md) 开始学习如何编写简单的测试。
* [看看更多例子](samples.md)学习如何使用 GoogleTest 的各种功能。