Files
dxdesigner-part-replacement/docs/testing/2026-10-30-environment-compatibility.md

6.3 KiB
Raw Permalink Blame History

2026-10-30 Windows 环境兼容性验收

目标和范围

按用户确认,以 Windows 10/11 x64、DxDesigner EE 7.9.5 为兼容目标。此次验证把源码测试、模拟异常、真实冻结 EXE 和真实 CAD 工程替换分别记录,不能互相替代。

本机是 Windows 11 Pro 10.0.26200 x64,当前会话不是管理员,并处于宿主已有的 Windows Job 中。源码解释器为 CPython 3.12.14,使用项目虚拟环境。没有可用的 Windows 10 实机证据,因此不能把本机测试解释为 Windows 10 已通过。

源码与启动边界

场景 验证方式 结果
普通 Python 虚拟环境 真实子进程 PID、虚拟环境前缀、win32api 依赖导入 通过
-E、-I 隔离启动参数 真实子进程,分别测试重定向和不重定向标准流 通过
中文、空格工作目录 真实子进程回报 CWD 与预期一致 通过
子进程环境隔离 验证传入环境字典不因虚拟环境适配而改变 通过
冻结/其他程序命令 在原生启动边界的受控测试中验证不替换为当前 Python 通过;此项不是冻结 EXE 实测
非管理员与嵌套 Job 本机实际会话及其子进程;Job 归属、后代退出和桌面释放 通过
Job 分配失败/归属未确认 故障注入,确认不恢复未受管控的子进程并收尾 通过;不等同于所有企业策略均可运行
中文、长路径及 MAX_PATH 受限路径访问 路径专项、工程索引/证据、深目录运行测试 通过;真实 CAD 路径限制仍需副本验证

命令:

..\..\.venv\Scripts\python.exe -m pytest -q tests/v1_1/test_isolated_desktop.py tests/v1_1/test_path_access.py tests/v1_1/test_project_long_paths.py tests/v1_1/test_deep_runtime_paths.py tests/v1_1/test_deep_scan_archive_paths.py tests/v1_1/test_com_project_path.py tests/packaging/test_dx_part_replace_build.py --tb=short --junitxml=build/compatibility-source-results.xml

结果:61 passed,34.12 秒。其中新增 8 项启动环境测试。它们验证现有修复的边界,此轮尚未因这些测试修改生产行为。

冻结包验收

使用 packaging/Build-DxPartReplace.ps1 从当前源码构建,不用旧 EXE 代替。脚本先运行当前 V1.1 与发布安全子集,再构建、检查 win32timezone、验证真实冻结监督器、比较打包 VBS 与源码的哈希并执行应用启动/关闭检查。

构建前置回归:957 passed,1 个已有 pywinauto STA 提示,426.70 秒。

标准构建脚本成功结束。实际冻结监督器、win32timezone 归档、进程创建时间读取、桌面释放和 VBS 源码/包内哈希检查全部通过。

实际 EXE 环境矩阵 7/7 通过:

场景 实测结果
清理 Python 环境、从不同工作目录启动 通过
PATH 仅保留 System32,不包含 Python 通过
设置其他/无效 PYTHONHOME、PYTHONPATH、Qt 插件路径及数据目录环境变量 通过;显式数据目录生效,错误目录未创建
中文、空格数据目录 通过
原生 Windows Qt 平台插件 通过;不是 offscreen 替代
339 字符的数据目录 通过;仅证明应用数据/证据路径,不表示 CAD 工程路径上限相同
把完整 EXE 与 _internal 搬到中文/空格便携目录 通过

每次均检查真实冻结监督器退出码为 0、Job 归属验证成功、Job 活跃进程数为 0、桌面句柄关闭且确认桌面消失,以及应用干净退出日志。测试数据均在新建目录,--smoke-test 只运行后台进程/桌面检查,不打开或替换 CAD 工程。

便携测试包附带 Run-CompatibilityCheck.ps1。它不需要目标机安装 Python,已在本机 Windows PowerShell 5.1.26100.9711 实际运行通过;输出 JSON 记录退出、日志和资源检查结果。脚本作为本次测试包附件,不会被错误地计为已完成 Windows 10 实机验证。

原始矩阵和源码/EXE SHA256 见 JSON 证据。本次生产代码没有因兼容专项再修改;增加了启动环境回归,并构建当前修复的独立测试包。

测试包:dist/DxPartReplace-compatibility-20261030.zip,包含完整便携目录与自检脚本,是本地兼容性测试候选,未发布到远程。

Windows 10/其他机器的复测方法

复制或解压完整 DxPartReplace 目录,包括 EXE 与 _internal,不要只复制 EXE。可先运行包内 Run-CompatibilityCheck.ps1 自动检查并生成报告;也可在可写目录运行以下命令,每次使用新的数据目录:

$compatDataRoot = Join-Path $env:LOCALAPPDATA ('DxPartReplace-compat-' + [Guid]::NewGuid().ToString('N'))
$compatExe = (Resolve-Path -LiteralPath '.\DxPartReplace.exe').Path
$compatProcess = Start-Process -FilePath $compatExe -ArgumentList @('--smoke-test', '--data-root', ('"' + $compatDataRoot + '"')) -WindowStyle Hidden -Wait -PassThru
$compatProcess.ExitCode
Get-Content -LiteralPath (Join-Path $compatDataRoot 'logs\application.log') -Tail 30
Get-ChildItem -LiteralPath (Join-Path $compatDataRoot 'batch-resources') -Filter 'session.json' -Recurse | ForEach-Object { Get-Content -LiteralPath $_.FullName -Raw | ConvertFrom-Json } | Select-Object state,cleanup

通过条件包括退出码 0、日志同时包含 packaged_runtime_smoke_passed 和 application_clean_shutdown exit_code=0,以及资源记录 state=released、桌面句柄关闭并确认桌面消失。仅看到窗口出现或退出码为 0 不足以证明后台收尾成功。

随后需在工程副本上单独验证:工程采集、BOM 导入、替换保存重开回读、暂停/恢复和资源清理。此步骤才覆盖本机中央库、许可证、CAD COM 注册、工程和文件服务器条件。

尚未证明的环境

  • Windows 10 实机、其他 Windows 11 构建及不同补丁状态。
  • 其他电脑的 DxDesigner 7.9.5 安装、中心库、许可证与 COM 注册。
  • 网络共享工程/数据目录、多用户并发访问 SQLite、只读安装目录和企业杀毒/应用控制策略。
  • 其他 CAD 版本和 32 位 Windows;本次目标为 Windows x64、DxDesigner 7.9.5。

不以放宽身份校验、忽略 Job 分配失败或自动重放替换来换取表面兼容。环境不允许安全执行时,必须停止并保留明确诊断。