用途:生成 prepare_environment_<lang> 脚本,在一致性测试脚本 run_conformance_tests_<lang> 之前运行一次,把构建产物复制进 .tmp/<lang>_<arg> 工作目录,并在其中安装依赖、预热缓存或预构建产物,使后续 N 次一致性测试调用只需“激活”而无需重复安装。参考实现为 assets/prepare_environment_java.sh 与 assets/prepare_environment_python.sh。
主要能力:按固定顺序执行工具链检查、参数校验、创建工作目录并清空重建、递归复制构建目录、进入工作目录、在隔离环境内安装依赖并预构建产物。退出码 69 表示不可恢复错误(缺参、缺工具链、无法进入工作目录、安装或构建失败),0 表示成功。
必要用法:先根据宿主系统选择 shell——macOS/Linux 生成 .sh,原生 Windows 生成 .ps1(可用 uname -s 或 $OS 检测);若跨平台使用则同时生成两版。脚本只接受一个位置参数 <build_folder>。
适用场景:项目中功能性规格(functional spec)较多,或依赖安装昂贵(GPU 构建、浏览器二进制等)时,用一次安装摊销多次渲染中的一致性测试开销。
限制:本技能仅用于一致性测试,不适用于单元测试;单元测试脚本自包含、不走激活模式。构建目录为只读,禁止在其中安装依赖、写缓存或产物。prepare 与 conformance 必须在工作目录名、依赖隔离路径、构建产物位置和工具链版本上严格一致。日志需详尽(逐步横幅、打印绝对路径与命令、透出安装输出、记录耗时与最终摘要)。语言专属隔离机制资料未完整提供。