[Deepin Integration]~[v25-Release] feat: update googletest to 1.17.0-1 by deepin-community-bot[bot]@deepin-community/googletest by deepin-community-ci-bot[bot]

[deepin-bot]

Package information | 软件包信息

包名	版本
googletest	1.17.0-1

Package repository address | 软件包仓库地址

deb [trusted=yes] https://ci.deepin.com/repo/obs/deepin:/CI:/TestingIntegration:/test-integration-pr-3205/testing/ ./

Changelog | 更新信息

googletest (1.17.0-1) unstable; urgency=medium

• New upstream version
• Standards-Version: 4.7.2 (routine-update)

[deepin-bot]

Integration Test Info

Test suggestion | 测试建议

Influence | 影响范围

ADDITIONAL INFORMATION | 额外补充

[deepin-bot]

IntegrationProjector Notify the author
@deepin: Integrated issue updated

[deepin-bot]

IntegrationProjector Bot
Deepin Testing Integration Project Manager Info
Link to deepin-community/Repository-Integration#3205

[Zeno-sole]

"googletest 1.17.0-1" 指的是 GoogleTest（gtest）这一广泛使用的 C++ 测试框架的一个特定版本。让我为你介绍这个版本的相关信息、安装和使用方法。

GoogleTest 是 Google 开发的一个用于 C++ 的单元测试框架〔1〕。它支持自动测试发现、丰富的断言集、用户定义的断言、死亡测试（death tests）、致命与非致命失败处理、参数化测试和类型化测试等多种特性〔1〕。版本号 "1.17.0-1" 中的 "1.17.0" 是主版本号，后面的 "-1" 可能代表该软件包的打包版本号（常见于 Debian/Ubuntu 等 Linux 发行版的软件包管理系统中）。

下面是 GoogleTest 一些核心特性的快速概览：

特性类别	主要功能/宏	说明
基本断言	ASSERTTRUE(condition), EXPECTTRUE(condition)	检查条件是否为真〔7〕
	ASSERTFALSE(condition), EXPECTFALSE(condition)	检查条件是否为假〔7〕
数值比较	ASSERTEQ(val1, val2), EXPECTEQ(val1, val2)	检查两个值是否相等〔7〕
	ASSERTNE(val1, val2), EXPECTNE(val1, val2)	检查两个值是否不相等〔7〕
	ASSERTLT(val1, val2), EXPECTLT(val1, val2)	检查 val1 是否小于 val2〔7〕
	ASSERTLE(val1, val2), EXPECTLE(val1, val2)	检查 val1 是否小于或等于 val2〔7〕
	ASSERTGT(val1, val2), EXPECTGT(val1, val2)	检查 val1 是否大于 val2〔7〕
	ASSERTGE(val1, val2), EXPECTGE(val1, val2)	检查 val1 是否大于或等于 val2〔7〕
字符串比较	ASSERTSTREQ(str1, str2), EXPECTSTREQ(str1, str2)	检查两个 C 风格字符串内容是否相同〔7〕
	ASSERTSTRNE(str1, str2), EXPECTSTRNE(str1, str2)	检查两个 C 风格字符串内容是否不同〔7〕
	ASSERTSTRCASEEQ(str1, str2), EXPECTSTRCASEEQ(str1, str2)	不区分大小写检查两个 C 风格字符串内容是否相同〔7〕
	ASSERTSTRCASENE(str1, str2), EXPECTSTRCASENE(str1, str2)	不区分大小写检查两个 C 风格字符串内容是否不同〔7〕
测试组织	TEST(TestCaseName, TestName)	定义一个独立测试〔9〕
	TEST_F(TestFixtureClassName, TestName)	基于 Fixture 定义测试，可复用设置和清理代码〔8〕
事件机制	SetUp()	在每个测试开始前执行（Fixture 中）〔8〕
	TearDown()	在每个测试结束后执行（Fixture 中）〔8〕

📥 安装 GoogleTest 1.17.0

你可以通过系统包管理器安装预编译的版本，或者从源代码编译安装。

1. 通过系统包管理器安装（如果发行版仓库中有该版本）：
   在基于 Debian 或 Ubuntu 的系统上，你可以使用 apt 包管理器。但请注意，软件仓库中的版本可能不是特定的 1.17.0-1。
   bash
   sudo apt update
   sudo apt install libgtest-dev # 安装开发包，版本可能不同

安装后，头文件通常位于 /usr/include/，库文件位于 /usr/lib/。

2. 从源代码编译安装：
   如果软件源中没有预编译的 1.17.0-1 包，或者你需要特定配置，可以从源码编译。
   · 下载源码：访问 GoogleTest 的 GitHub 仓库 〔1〕 下载所需版本的源码包（如 googletest-1.17.0.zip 或通过 git 克隆并切换标签）。
   · 编译和安装：
   bash
   解压下载的源码包（如果从压缩包下载）
   unzip googletest-1.17.0.zip -d /your/installation/path
   cd /your/installation/path/googletest-1.17.0

创建并进入构建目录
mkdir build && cd build

使用 CMake 配置编译选项。-DCMAKEINSTALLPREFIX 指定安装目录（默认为 /usr/local）
cmake .. -DCMAKEINSTALLPREFIX=/your/installation/path

编译
make

安装（可能需要 sudo 权限如果安装到系统目录）
sudo make install

安装后，头文件会在 /your/installation/path/include/（例如包含 gtest/gtest.h），库文件在 /your/installation/path/lib/（例如 libgtest.a, libgtest_main.a 等）。

🛠 使用 GoogleTest

1. 编写测试代码：
   创建一个测试文件，例如 test_example.cpp〔5〕：
   cpp
   include <gtest/gtest.h>

// 一个简单的函数示例
int Add(int a, int b) { return a + b; }

// 定义一个测试用例
TEST(ExampleTest, Addition) {
EXPECT_EQ(Add(1, 2), 3); // 断言 1+2 等于 3
EXPECT_EQ(Add(-1, 1), 0);
}

// 主函数（如果链接了 gtest_main 库，通常可以省略）
int main(int argc, char argv) {
::testing::InitGoogleTest(&argc, argv);
return RUNALLTESTS();
}

2. 编译测试程序：
   你需要将你的测试代码与 GoogleTest 库链接。假设 GoogleTest 安装在 /usr/local，使用 g++ 编译：
   bash
   g++ -std=c++11 testexample.cpp -o testexample
   -lgtest -lgtest_main -lpthread
   -I/usr/local/include -L/usr/local/lib

· -lgtest -lgtestmain: 链接 GoogleTest 库。gtestmain 提供了一个默认的 main 函数，所以你自己的代码中可以省略 main 函数〔6〕。
· -lpthread: GoogleTest 可能需要 pthread 库。
· -I 和 -L: 指定头文件和库文件的路径（如果 GoogleTest 没有安装在系统默认路径）。

3. 运行测试：
   运行生成的可执行文件：
   bash
   ./test_example

输出会显示测试结果，包括通过了哪些测试，哪些失败了，以及详细的失败信息。

🔧 集成到构建系统（CMake）

在现代 C++ 项目中，通常使用 CMake 来管理构建过程。以下是一个简单的 CMakeLists.txt 示例，用于集成 GoogleTest〔5〕：

cmakeminimumrequired(VERSION 3.10)
project(MyTests)

设置 C++ 标准
set(CMAKECXXSTANDARD 11)

查找 GoogleTest 包
find_package(GTest REQUIRED)
includedirectories(${GTESTINCLUDE_DIRS})

添加你的测试可执行文件
addexecutable(runtests test_example.cpp)
链接 GoogleTest 库和 pthread
targetlinklibraries(runtests ${GTESTLIBRARIES} pthread)

添加一个测试
addtest(NAME MyExampleTest COMMAND runtests)
enable_testing()

然后使用以下命令构建和运行：
mkdir build && cd build
cmake ..
make
./run_tests

💡 提示与注意事项

· 版本差异：不同版本的 GoogleTest 在特性和 API 上可能略有差异。1.17.0 是一个相对较旧的版本，建议关注是否有更新的版本可用，以获取错误修复和新功能。GoogleTest 项目推荐“Live at Head”理念，即尽可能使用最新的提交〔1〕。
· 错误排查：
· 如果编译时找不到头文件或库，请确认 -I 和 -L 参数指定的路径正确。
· 确保链接了所有必要的库（gtest, gtest_main, pthread）。
· 深入学习：GoogleTest 提供了许多高级功能，如测试夹具（Test Fixtures）（TESTF）〔8〕、参数化测试（TESTP）〔4〕、值参数化测试、类型参数化测试〔3〕、模拟（Mocking）（通过 GoogleMock）〔2〕等。查阅官方文档或相关教程可以更好地利用这些功能。

希望这些信息能帮助你开始使用 GoogleTest 1.17.0-1 进行 C++ 单元测试！如果你在特定环境或使用中遇到问题，我可以提供更多细节。