跳到主要内容

开发教程

概述​

本教程介绍如何基于 Open3DGMBE 框架进行模块开发与测试。

1. 项目结构​

open-tsinghua/
├── CMakeLists.txt              # 根目录 CMake 配置
├── src/                        # 源代码目录
│   ├── CMakeLists.txt          # 源码构建配置
│   ├── base/                   # 基础模块
│   ├── kernel/                 # 内核模块
│   ├── laws/                   # 法则模块
│   ├── intersectors/           # 相交模块
│   ├── constructors/           # 构造模块
│   ├── booleans/               # 布尔模块
│   └── _deps/                  # 第三方依赖
├── tests/                      # 测试目录
│   ├── CMakeLists.txt          # 测试构建配置
│   ├── boundary/               # 边界测试
│   ├── functional/             # 功能测试
│   ├── performance/            # 性能测试
│   ├── regression/             # 回归测试
│   ├── security/               # 安全测试
├── docs/       # 文档

2. 模块体系​

核心模块包括：

  • base（基础模块）
  • kernel（几何内核）
  • laws（数学表达）
  • intersectors（求交）
  • constructors（构造器）
  • booleans（布尔运算）

3. 新增模块流程​

步骤1：创建模块目录​

src/new_module/

步骤2：添加源码​

// new_module.cpp

步骤3：修改 CMakeLists​

if(GLOBAL_BUILD_NEW_MODULE)
    add_subdirectory(new_module)
endif()

4. 添加测试​

tests/functional/new_module/

示例：

TEST(NewModuleTest, Basic)
{
    EXPECT_EQ(1, 1);
}

5. 编译与运行​

cmake --build build
ctest
开发教程