### P2-5c 圆角盒残余 seam 96→0
- 根因:平面单环耳切剔除共线中间点,与共享采样 3 段边界不一致;新增 restore_ring_boundary_points 把共享边界点逐点补回;
- 26 面圆角盒 open 96→0(Plane/Cylinder/Sphere 全 0),tris 6396,box 类保持 0;平面面与曲面相邻时 10 tris/面(纯平面 box 仍 2),
测试断言按新语义更新;
### P3-4 外部服务 OS 级沙箱
- vde-service.json limits(max_memory_mb/max_cpu_seconds/max_processes/kill_on_close);Windows Job Object(挂起创建→Assign→Resume、
KILL_ON_JOB_CLOSE、内存/CPU/进程数限制事件)+ POSIX setsid/rlimit;结果 limit_exceeded/limit_kind;
- test_plugin_external_service 18/18(内存/CPU/进程数超限、kill_on_close 回收、旧行为、非法清单);docs 更新;
### P3-5 插件 DLL 工件哈希 + 密钥轮换/吊销
- manifest artifacts[{path,sha256}]/key_id;SHA-256 自实现 + 路径白名单;Policy require_artifact_hashes/trusted_keys/revoked_key_ids;
新错误码;evaluate 扩展 + manager hook 已接线;tool verify --hash/--key-id;test_plugin_security 42/42;docs plugin-security §4.5/§4.6;
### P3-6 C++ 跨 DLL ABI 边界定稿(opt-in 实验)
- VDE_BUILD_CPP_SHARED(默认 OFF)12 内核模块 SHARED + consumer smoke(CPP_SHARED_CONSUMER_PASS faces=6 volume=6000);
- 决策:保持 C++ 静态 + 纯 C ABI + 插件默认;跨 DLL 单例/STL/RTTI/导出规模风险,实验仅 opt-in;architecture §7.8/design §13;
### P3-7 MSVC/Linux 跨平台验证收口
- .github/workflows/ci.yml 新增 windows-msvc job(YAML 校验通过);vde_platform UTF-8 宽 API/error/自守卫修复;
- 可移植性审计 12 类;docs/guides/cross-platform-validation.md;本机无 MSVC/WSL/docker,实机由 CI 反馈;
### VDE-1249 / 工程
- 反馈单更新:圆角盒 open 960→96→0,1.0.68 预算 Normal≈6396,宿主复测指引改 1.0.68;
- 版本 1.0.68;全量构建 0 error(340 targets);全量 ctest 7472 注册、7377/7377 PASS(0 failed,25 skipped,560.68s)。
98 lines
5.1 KiB
Markdown
98 lines
5.1 KiB
Markdown
# 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 与可执行统一输出 `<build>/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
|
||
```
|