# P3-6 C++ 跨 DLL ABI 实验记录(VDE_BUILD_CPP_SHARED) > 状态:**实验(opt-in,默认 OFF)**;不属于默认发布/CI 门禁。 > 分支 main,HEAD `ee13a3ed`(1.0.67);构建目录 `build-fb-cppshared` / `build-fb-cppshared-off`。 > 文档结论:`docs/guides/architecture.md` §7.8、`docs/design/microkernel-plugin-architecture.md` §13。 ## 1. 目的与开关 验证“内核 C++ 模块构建为 SHARED、消费者只链接 DLL 导入库”的可行性与边界: ```powershell cmake -S . -B build-fb-cppshared -G Ninja -DCMAKE_BUILD_TYPE=Release ^ -DVDE_BUILD_CPP_SHARED=ON -DFETCHCONTENT_FULLY_DISCONNECTED=ON ... cmake --build build-fb-cppshared --target vde_cpp_shared_consumer -j 12 ``` - ON 时内核模块(foundation/plugin/core/compute/curves/mesh/spatial/boolean/ collision/sdf/brep + platform)以 SHARED 构建;Windows 由 CMake `WINDOWS_EXPORT_ALL_SYMBOLS` 自动生成 .def 全导出;DLL 与可执行统一输出 `/bin`。 - 非内核/官方模块(io/cae/render/drafting/pdm/mechanism/ui/cam 等)仍 STATIC,链接共享内核。 ## 2. 实测结果(Windows 11 / MinGW GCC 16.1 UCRT / Release / 本机) **构建**:configure + kernel SHARED 构建 **0 error**;生成 12 个内核 DLL,合计 15,828,919 B: | DLL | 大小 (B) | 导出 defined symbols | |---|---:|---:| | libvde_platform.dll | 111,987 | — | | libvde_foundation.dll | 168,171 | 464 | | libvde_core.dll | 542,524 | 946 | | libvde_compute.dll | 120,642 | — | | libvde_curves.dll | 2,612,282 | 1,004 | | libvde_spatial.dll | 246,620 | — | | libvde_collision.dll | 117,447 | — | | libvde_mesh.dll | 1,235,369 | 863 | | libvde_boolean.dll | 156,488 | — | | libvde_sdf.dll | 253,421 | — | | libvde_brep.dll | 9,501,727 | 3,121 | | libvde_plugin.dll | 762,241 | 971 | | **合计** | **15,828,919** | — | **最小消费者** `experiments/cpp_shared_consumer`(只链接内核 DLL 导入库): ``` CPP_SHARED_CONSUMER_PASS faces=6 volume=6000.000000 triangles=12 ``` CTest `VDE_CppSharedConsumerSmoke` **1/1 PASS**。 **共享内核下既有测试抽查**(混合“共享内核 + 静态官方模块”,DLL 在 exe 同目录): - test_display_mesh **13/13 PASS**、test_vde1239_display_quality **13/13 PASS**、 test_capi_split **10/10 PASS**; - test_plugin_manager 23/24:唯一失败为 `sample_plugin_available()`(实验构建目录未构建 sample_vbox 插件产物,环境缺失,非跨 DLL ABI 失败); - `ctest -R 'VDE_CppSharedConsumerSmoke|Display'` **15/15 PASS**。 **默认 OFF 回归**(`build-fb-cppshared-off`):configure/build exit 0; 内核仍为 27 个静态库(`libvde_brep.a` 13,837,174 B),bin 下 **0** 个内核 DLL; test_display_mesh **13/13 PASS**。默认 static/hybrid 构建行为不变。 ## 3. 跨 DLL 边界约束(实验结论,必须遵守) 1. **单例/静态注册表**:每个 DLL 各有一份静态数据;日志 sink、缓存、注册表、tolerance、 thread-local 等必须收敛到同一组 DLL。消费者不得再静态链入内核,否则出现双实例 (句柄/缓存不一致)。本实验用“同一内核闭包全部 SHARED”避免该问题。 2. **STL/分配器跨边界**:禁止在一个 DLL 分配 STL 容器/对象而在另一个 DLL 释放 (CRT 不同 → 堆损坏)。当前头文件 API 大量按值/STL 传递,跨 DLL 使用必须 **同编译器 + 同 CRT + 同标志**(MinGW UCRT 与 MSVC 不互通)。生产级需 pimpl/纯 C 包装/显式 allocator+free 接口。 3. **RTTI/异常**:type_info 去重与异常跨 DLL 传播依赖同 ABI/CRT;跨编译器(MinGW↔MSVC) 禁止。 4. **导出规模/链接成本**:全导出使 DLL 体积与符号表显著增大(brep ~9.5MB / 3,121 符号), 且泄漏全部内部 C++ 符号(实验可接受,发布不可接受)。 5. **部署/加载顺序**:所有内核 DLL 必须与可执行同目录(或 PATH);版本需成套 (1.0.x DLL 混 1.0.y 导入库有 ABI 风险)。 6. **插件 ABI 独立**:官方/第三方插件仍走纯 C ABI(不链接这些 C++ DLL);C++ DLL 实验与插件 ABI 互不影响。 ## 4. 决策(P3-6 定稿) - 机制**可行**(配置/构建/最小 smoke/部分既有测试通过),但导出体系、STL/分配器/ 异常边界、单例治理与跨编译器矩阵的成本/风险远超收益; - **保持默认决策**:C++ 消费者静态链接内核;动态边界只提供纯 C ABI(`libvde_capi`) 与插件; - `VDE_BUILD_CPP_SHARED` 仅保留为 **experimental opt-in**(默认 OFF,不进发布/CI 门禁); - 未来若需跨 DLL C++,优先 pimpl/纯 C 包装或进程外服务,而非全导出符号。 ## 5. 复现 ```powershell # 实验 cmake -S . -B build-fb-cppshared -G Ninja -DCMAKE_BUILD_TYPE=Release -DVDE_BUILD_CPP_SHARED=ON ... cmake --build build-fb-cppshared --target vde_cpp_shared_consumer -j 12 build-fb-cppshared/bin/vde_cpp_shared_consumer.exe # CPP_SHARED_CONSUMER_PASS ... # 默认 OFF 回归 cmake -S . -B build-fb-cppshared-off -G Ninja -DCMAKE_BUILD_TYPE=Release ... cmake --build build-fb-cppshared-off --target test_display_mesh -j 12 ```