VALIDATION.zh-CN.md 5.9 KB

原生后端增量测试与验证报告

2026-11-05 · v0.1.1 · 基线 cfbrowser-202611051438.zip。

本次实际结果

执行环境:Ubuntu 24.04 amd64,Go 1.25.0。应用与 worker 使用 CGO_ENABLED=0 构建;仅 race 测试运行时启用 cgo。vendored 依赖支持离线单元测试。

检查 实际结果
完整 Go 单元测试,CGO=0、GOPROXY=off/GOSUMDB=off 通过
完整 race 测试 通过
Linux go vet 通过
Windows amd64/macOS arm64 原生相关包 go vet 通过,仅静态检查
六目标应用/worker 构建 通过,仅编译
Nativehost、Native 客户端、integration 测试二进制 Windows amd64/arm64、macOS amd64/arm64 共 12 项编译通过;未运行
五组真实 CDP 集成流程 通过,包含新增隔离世界测试
已插桩 CDP demo、CLI 长度前缀管道 demo 通过
Python 覆盖率合并与 macOS bundle 元数据测试 两项均通过
Windows WebView2 实际运行 未执行,当前没有 Windows 宿主
macOS WKWebView / block ABI 实际运行 未执行,当前没有 macOS 宿主
本次 Linux GTK/WebKitGTK 实际运行 未重跑,当前环境缺少 WebKitGTK 运行库
ClusterFlow 签名安装包 / UI 生命周期 未执行,已更新宿主接入文档

六目标为 linux/amd64、linux/arm64、windows/amd64、windows/arm64、darwin/amd64、darwin/arm64。Windows/macOS worker 现已包含实际原生 API,而非 unsupported 入口;交叉编译不能证明原生 ABI 或 WebView runtime 能正常运行。

CDP 回归采用原型相同的 Chrome Headless Shell 131.0.6778.204 测试引擎,只访问确定性的本地 HTTP 测试站。隔离容器显式使用 NoSandbox;未验证生产环境沙箱开启的运行。工具链与浏览器二进制不作为交付物。

本次日志以 test-results/native-update- 开头;原有日志与 manifest 已原样移到 test-results/baseline-v0.1.0/,只代表历史版本证据。

覆盖率与适用范围

  • 公共 internal/nativehost dispatcher、运行循环、CDP 调用编排:Linux 单元测试 100.0% Go 语句覆盖率。
  • Native RPC 客户端:单元测试 84.1%。
  • 当前 Linux 构建选中的全模块代码:单元测试 68.3%;合并本次单元、CDP 集成与已插桩 CLI 后为 76.3%。
  • Windows/macOS 平台文件被 Linux build tag 排除,本次没有它们的运行覆盖率数据;公共层 100% 不包含两个平台适配器。
  • 排除 vendor;未执行的示例与 Linux worker 计入未覆盖语句。Go 包装层覆盖率不等于 JavaScript 分支覆盖率。

此前的 82.42% 包含 GTK worker 实际执行,且源码版本不同;只保留为历史结果,不能沿用为本次覆盖率。Windows/macOS 运行后才能生成对应平台数据。

native-update-coverage.txt 保存本次合并函数结果;原始 .cover 在本地生成并被 Git 忽略,需要时按命令重现,禁止跨源码布局合并 profile。

新增测试内容

公共层覆盖配置校验/失败重试/重复配置、未知方法、页面查找/配额、历史导航、NUL 拒绝、JSON/脚本限额、原生错误、重复完成回调保护、排队取消、取消创建后的页面清理、关闭页面/worker 时求值结束与迟到回调、RPC 取消后仍保留原生求值配额、长度前缀 RPC/EOF 和 pump 故障。

WebView2 求值编排测试检查主 frame、隔离世界参数、context ID、return-by-value、各阶段原生错误、无效 JSON、缺少结果与 JS 异常。Windows 专有测试实际调用 COM trampoline,检查 UTF-16、HRESULT 和 Win32 布局。macOS 专有测试实际 copy/invoke/release 原生 block,检查回调所有权与在途限额;本次只编译了这两组平台测试。

新增真实引擎测试检查网页全局不可见、隔离全局连续调用保留、DOM 对象身份、注入网页脚本无法读取隔离全局、JS 异常、导航后状态清空与 Native viewport。既有动态表单/表格、旧 ref/取消/Owner、cookie/历史/生命周期、认证/blob 下载继续保留。Native 下载按不支持跳过,不能视作下载测试通过。

复现与目标系统验收

CGO_ENABLED=0 go test -buildvcs=false -mod=vendor ./... -count=1 -coverprofile=test-results/unit.cover
go vet -mod=vendor ./...
CGO_ENABLED=1 go test -mod=vendor -race ./... -count=1
sh scripts/cross-build.sh
python3 -m unittest discover -s scripts -p 'test_*.py' -v

Windows 在 PowerShell 执行 ./scripts/test-native.ps1;macOS 在已登录图形会话执行 sh scripts/test-native.sh。构建、打包、诊断与期望结果详见 NATIVE.zh-CN.md。设置 CFBROWSER_TEST_ENGINE=native 可避免只运行 CDP 却误以为原生通过;cdp 表示仅 CDP,both 表示两者;为空保留原 CDP 加可选 CFBROWSER_NATIVE=1 行为。

macOS/Linux 可这样收集 worker 与 CLI 的原生运行覆盖率:

mkdir -p test-results/coverage-native
CGO_ENABLED=0 go build -cover -coverpkg=./... -o bin/cfbrowser ./cmd/cfbrowser
CGO_ENABLED=0 go build -cover -coverpkg=./internal/nativehost,./cmd/cfbrowser-worker,./protocol,./api -o bin/cfbrowser-worker ./cmd/cfbrowser-worker
GOCOVERDIR="$PWD/test-results/coverage-native" ./bin/cfbrowser --engine native --worker "$PWD/bin/cfbrowser-worker" demo
go tool covdata textfmt -i=test-results/coverage-native -o=test-results/native.cover

PowerShell 中用 $env:GOCOVERDIR 设置已存在的绝对目录,输出文件名使用 .exe。强杀 worker 可能来不及写覆盖率,需要正常关闭。保留各 OS 单独报告,不把不同平台 profile 混成一个容易误解的百分比;统一排除 vendor。

目标验收仍需 Windows/macOS 原生脚本、真实签名包、前后台行为与关闭清理检查。通用 popup/dialog、任意外站、Native 截图/下载/可信输入、严格网络隔离、持久 profile、Job Object/进程组、宿主被强杀后的进程树清理不属于当前原型承诺。