图形学3D渲染桌面应用音视频【免费下载链接】blenderOfficial mirror of Blender项目地址https://gitcode.com/gh_mirrors/bl/blender点击查看免费下载导读本文围绕 Blender 仓库中随附的 Google Mock 测试框架所暴露的**自定义注入机制Customization Points**展开聚焦 extern/gmock/include/gmock/internal/custom/README.md 所描述的custom目录及其核心头文件gmock-port.h。读者将理解custom目录在 Google Mock 中扮演什么角色、GMOCK_DECLARE_*/GMOCK_DEFINE_*/GMOCK_FLAG_GET/GMOCK_FLAG_SET这套 Flag 宏如何定义、声明、读写测试运行时参数以及它们在实际源码含 Blender Cycles 测试中的调用链路。读完本文你将具备在依赖 Google Mock 的项目中自定义框架级 Flag 与扩展 Matcher/Action 的完整实操能力。一、custom目录Google Mock 的用户注入点在 Blender 仓库中Google Mock 以第三方库的形式随源码分发其目录结构如下extern/gmock/ ├── include/gmock/ │ ├── internal/ │ │ ├── custom/ ← 用户自定义注入点 │ │ │ ├── README.md │ │ │ ├── gmock-generated-actions.h │ │ │ ├── gmock-matchers.h │ │ │ └── gmock-port.h │ │ ├── gmock-internal-utils.h │ │ ├── gmock-port.h │ │ └── gmock-pp.h │ ├── gmock-actions.h │ ├── gmock-cardinalities.h │ ├── gmock-function-mocker.h │ ├── gmock-matchers.h │ ├── gmock-more-actions.h │ ├── gmock-nice-strict.h │ ├── gmock-spec-builders.h │ └── gmock.h └── src/ ← gmock-all.cc 等实现文件根据 README.md 的说明custom目录是面向自定义用户配置的注入点injection point for custom user configurations。其设计意图是在不改动 Google Mock 主干头文件的前提下为使用方如 Blender 自身留出一组可替换的钩子头文件用于注入平台相关的移植代码、自定义 Matcher 或自定义 Action。这一设计的关键在于包含顺序这些钩子头文件会从 Google Mock 的公开头文件内部被#include因此使用方只需就地编辑或替换custom目录下的文件即可影响整个框架的编译行为。仓库中对应的真实包含点包括extern/gmock/include/gmock/internal/gmock-port.h 第 56 行#include gmock/internal/custom/gmock-port.hextern/gmock/include/gmock/gmock-more-actions.h 第 47 行#include gmock/internal/custom/gmock-generated-actions.hextern/gmock/include/gmock/gmock-matchers.h 第 5622 行#include gmock/internal/custom/gmock-matchers.h同时这三个钩子文件都被列入 extern/gmock/CMakeLists.txt 的头文件清单第 35~37 行确保它们随库一起参与构建与分发。三个注入头文件的分工钩子头文件注入点被谁包含作用custom/gmock-port.hinternal/gmock-port.h移植层与 Flag 宏的用户扩展custom/gmock-generated-actions.hgmock-more-actions.h用户自定义 Action 的扩展位custom/gmock-matchers.hgmock-matchers.h用户自定义 Matcher 的扩展位每个文件都带有IWYU pragma: private, include gmock/gmock.h标记意味着它们属于内部私有头用户代码应统一通过#include gmock/gmock.h间接引入而不是直接包含这些文件。二、gmock-port.hFlag 相关宏体系README 明确说明在gmock-port.h中可以定义以下与命令行 Flag 相关的宏这也是原文档列举的全部核心内容声明宏GMOCK_DECLARE_bool_(name)、GMOCK_DECLARE_int32_(name)、GMOCK_DECLARE_string_(name)定义宏GMOCK_DEFINE_bool_(name, default_val, doc)、GMOCK_DEFINE_int32_(name, default_val, doc)、GMOCK_DEFINE_string_(name, default_val, doc)读写宏GMOCK_FLAG_GET(flag_name)、GMOCK_FLAG_SET(flag_name, value)其中带尾下划线_的宏属于 Google Mock 内部 API。在 extern/gmock/include/gmock/internal/gmock-port.h 的文件头注释中对此有明确约束所有以_结尾的宏以及内部命名空间中定义的符号都可能在没有通知的情况下变更Google Mock 之外的代码不得直接使用它们只有不带_结尾的宏才属于公开 API。这意味着上述 Flag 宏主要用于 Google Mock 自身及极少数深度集成的场景。2.1 名字拼接机制在深入两套实现之前先看基础的名字拼接宏gmock-port.h#define GMOCK_FLAG_NAME_(name) gmock_##name #define GMOCK_FLAG(name) FLAGS_gmock_##nameGMOCK_FLAG_NAME_(name)把verbose变成gmock_verbose用作 Flag 的实际变量名Abseil 风格下GMOCK_FLAG(name)把verbose变成FLAGS_gmock_verbose是访问 Flag 的通用符号。这一层间接命名保证所有 Google Mock 的 Flag 统一以gmock_前缀出现避免与测试程序中的其他 Flag例如 Google Test 的FLAGS_gtest_*命名冲突。2.2 实现分支一基于 Abseil Flags当定义了GTEST_HAS_ABSL且未定义GTEST_NO_ABSL_FLAGS时gmock-port.hGoogle Mock 直接委托给 Abseil 的 Flags 库#define GMOCK_DEFINE_bool_(name, default_val, doc) \ ABSL_FLAG(bool, GMOCK_FLAG_NAME_(name), default_val, doc) #define GMOCK_DEFINE_int32_(name, default_val, doc) \ ABSL_FLAG(int32_t, GMOCK_FLAG_NAME_(name), default_val, doc) #define GMOCK_DEFINE_string_(name, default_val, doc) \ ABSL_FLAG(std::string, GMOCK_FLAG_NAME_(name), default_val, doc) #define GMOCK_DECLARE_bool_(name) \ ABSL_DECLARE_FLAG(bool, GMOCK_FLAG_NAME_(name)) #define GMOCK_DECLARE_int32_(name) \ ABSL_DECLARE_FLAG(int32_t, GMOCK_FLAG_NAME_(name)) #define GMOCK_DECLARE_string_(name) \ ABSL_DECLARE_FLAG(std::string, GMOCK_FLAG_NAME_(name)) #define GMOCK_FLAG_GET(name) ::absl::GetFlag(GMOCK_FLAG(name)) #define GMOCK_FLAG_SET(name, value) \ (void)(::absl::SetFlag(GMOCK_FLAG(name), value))对应的头文件依赖在 gmock-port.h 中通过条件编译引入#if defined(GTEST_HAS_ABSL) !defined(GTEST_NO_ABSL_FLAGS) #include absl/flags/declare.h #include absl/flags/flag.h #endif此路径下bool/int32_t/std::string三种类型分别映射为 Abseil 的ABSL_FLAG定义与ABSL_DECLARE_FLAG声明读写则通过absl::GetFlag/absl::SetFlag完成。2.3 实现分支二无 Abseil 的内建回退实现当 Abseil 不可用时#else分支gmock-port.hGoogle Mock 提供一套基于namespace testing的轻量回退实现。例如 bool 型 Flag#define GMOCK_DEFINE_bool_(name, default_val, doc) \ namespace testing { \ GTEST_API_ bool GMOCK_FLAG(name) (default_val); \ } \ static_assert(true, no-op to require trailing semicolon) #define GMOCK_DECLARE_bool_(name) \ namespace testing { \ GTEST_API_ extern bool GMOCK_FLAG(name); \ } \ static_assert(true, no-op to require trailing semicolon) #define GMOCK_FLAG_GET(name) ::testing::GMOCK_FLAG(name) #define GMOCK_FLAG_SET(name, value) (void)(::testing::GMOCK_FLAG(name) value)几个值得注意的细节定义宏会在testing命名空间内生成一个带GTEST_API_导出属性的全局变量bool、int32_t、::std::string三种类型分别对应不同宏宏体末尾的static_assert(true, ...)是一个巧妙的技巧它强制要求调用处补上分号避免宏展开后因缺少分号导致的语法错误GMOCK_FLAG_GET/GMOCK_FLAG_SET直接读写该全局变量(void)强转用于抑制表达式结果未使用的编译告警该回退路径同样遵循声明与定义分离GMOCK_DECLARE_*只生成extern声明GMOCK_DEFINE_*才真正分配存储二者需成对使用声明放头文件、定义放实现文件。2.4 编译器版本约束无论走哪条分支gmock-port.h 都包含一条 MSVC 版本硬性校验#if defined(_MSC_VER) _MSC_VER 1900 #error At least Visual C 2015 (14.0) is required to compile Google Mock. #endif即在 Windows 平台使用 MSVC 编译时至少需要 Visual C 201514.0否则编译直接报错。三、仓库中的真实 Flag 实例与调用链理解宏定义之后再看 Google Mock 自身如何使用这套体系是最直观的验证。3.1 三个内建 Flag 的声明在公开入口 extern/gmock/include/gmock/gmock.h 中声明了三个内建 FlagGMOCK_DECLARE_bool_(catch_leaked_mocks); GMOCK_DECLARE_string_(verbose); GMOCK_DECLARE_int32_(default_mock_behavior);catch_leaked_mocksbool是否在测试结束时检测泄漏的 Mock 对象verbosestring控制日志详细程度default_mock_behaviorint32控制未设置期望时 Mock 方法的默认行为。它们的实际定义位于实现文件 extern/gmock/src/gmock.cc通过GMOCK_DEFINE_*展开为带默认值的全局变量。3.2 Flag 的读取调用链以verbose为例源码中的读取点可以清晰地看到GMOCK_FLAG_GET的实际用法extern/gmock/src/gmock-internal-utils.cc 中根据GMOCK_FLAG_GET(verbose)与kInfoVerbosity/kErrorVerbosity的比较结果决定日志输出级别extern/gmock/src/gmock-spec-builders.cc 中同样读取GMOCK_FLAG_GET(verbose)来决定期望调用次数信息的详细程度kInfoVerbosity时打印 3 层上下文否则 1 层。这条链路完整展示了宏声明 → 宏定义 → 宏读取的设计闭环GMOCK_DECLARE_*提供跨编译单元的类型安全声明GMOCK_DEFINE_*提供带默认值的存储与文档字符串GMOCK_FLAG_GET/GMOCK_FLAG_SET提供统一读写接口而框架内部逻辑只依赖GMOCK_FLAG_GET从而与底层是 Abseil 还是回退实现完全解耦。四、自定义扩展实操指南虽然custom目录在 Blender 仓库中保持默认状态各头文件仅有 include guard 与版权头见 custom/gmock-port.h、custom/gmock-generated-actions.h、custom/gmock-matchers.h但其设计意图是明确的。若使用方需要自定义扩展可遵循以下步骤4.1 自定义 Flag在custom/gmock-port.h的 include guard 之间插入自定义 Flag 的声明与定义例如// 声明放头文件 GMOCK_DECLARE_bool_(enable_extended_logging); // 定义放某个实现文件 GMOCK_DEFINE_bool_(enable_extended_logging, false, Enable extended logging in test fixtures.);随后在测试代码中通过GMOCK_FLAG_GET(enable_extended_logging)读取、通过GMOCK_FLAG_SET(enable_extended_logging, true)写入。需要提醒的是这些宏属于 Google Mock 内部 API带尾下划线跨版本稳定性不受保证使用前应充分评估升级风险。4.2 扩展 Matcher 与 Action自定义 Matcher将实现写入custom/gmock-matchers.h它会被 gmock-matchers.h 末尾包含从而在gmock.h体系中可见自定义 Action将实现写入custom/gmock-generated-actions.h它会被 gmock-more-actions.h 包含。两个文件都通过IWYU pragma: friend gmock/.*声明与 Google Mock 头文件的友元关系表明它们被设计为只被 Google Mock 自身包含的扩展点。4.3 构建集成由于 extern/gmock/CMakeLists.txt 已将这组 custom 头文件纳入库的头文件清单改动custom目录下的文件后重新构建 Google Mock 目标即可生效无需修改任何公开头文件。五、Blender 中 Google Mock 的实际使用场景作为证据Blender 自身的 C 单元测试确实依赖这套框架。在 Cycles 渲染器的测试中多个测试文件同时引入 Google Test 与 Google Mockintern/cycles/test/util_math_float3x3_test.cpp#include gmock/gmock.h与#include gtest/gtest.h成对出现intern/cycles/test/util_math_quaternion_test.cpp同样同时包含两者。这类测试利用 Google Mock 的 Matcher / Action 能力例如浮点矩阵与四元数的近似比较匹配器来编写高可读性的断言。这意味着custom目录虽然当前保持默认但它所服务的 Google Mock 框架以及同目录下的 Google Test见 extern/gtest是 Blender Cycles 数学与渲染内核测试基础设施的重要组成部分。六、小结以 Blender 仓库中的 custom/README.md 为线索本文还原了 Google Mock 自定义注入机制的完整图景custom目录是框架为用户预留的三个注入点分别对应移植层gmock-port.h、Matcher 扩展gmock-matchers.h与 Action 扩展gmock-generated-actions.hgmock-port.h中可定义三组 Flag 宏声明宏GMOCK_DECLARE_*、定义宏GMOCK_DEFINE_*与读写宏GMOCK_FLAG_GET/GMOCK_FLAG_SET底层实现有两条路径有 Abseil 时委托ABSL_FLAG/absl::GetFlag无 Abseil 时退化为namespace testing内的GTEST_API_全局变量gmock-port.h 提供了完整对照实现Google Mock 自身的三个内建 Flagcatch_leaked_mocks、verbose、default_mock_behavior正是通过这套宏声明并在gmock-internal-utils.cc、gmock-spec-builders.cc中读取构成可验证的调用链Blender 的 Cycles 测试如 util_math_float3x3_test.cpp实际消费了这套框架。对于希望深度定制 Google Mock 行为的项目而言custom目录就是官方预留的后门——理解其宏体系与包含顺序即可在不触碰框架主干的前提下安全扩展。赞分享图形学3D渲染桌面应用音视频【免费下载链接】blenderOfficial mirror of Blender项目地址https://gitcode.com/gh_mirrors/bl/blender点击查看免费下载相关推荐Google Mock 自定义注入点Customization Points完全指南gmock-port.h 与 Flag 宏体系深度解析Google Mock 自定义注入点Customization Points完全指南gmock port.h 与 Flag 宏体系深度解析 本文基于仓库中序列化后端GoogleMock 自定义注入点指南通过 gmock/internal/custom/ 定制命令行 Flag 宏体系GoogleMock 自定义注入点指南通过 gmock/internal/custom/ 定制命令行 Flag 宏体系 导读 本文围绕 GoogleMock测试质量保障开发工具GoogleTest 定制注入点Customization Points完全指南深入 custom 目录的扩展机制GoogleTest 定制注入点Customization Points完全指南深入 custom 目录的扩展机制 本指南聚焦 GoogleTest 框架测试上一篇终极指南如何快速掌握stb单文件库的21个核心模块下一篇如何将微信对话转化为数字记忆WeChatMsg为您守护每一段珍贵交流创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考