尧图网页设计 
e2e环境要求全解析Node 24.8、WSL、iOS模拟器与Android SDK清单【免费下载链接】e2eNext generation e2e testing framework for web and mobile apps.项目地址: https://gitcode.com/GitHub_Trending/e2e6/e2e在开始使用 e2e 端到端测试框架面向 Web 与移动端应用的下一代 AI 驱动 E2E 测试工具之前先搞清楚环境要求能帮你避开 90% 的踩坑Node.js 24.8 版本门槛、Windows 上必须使用 WSL、iOS 模拟器依赖 Xcode 运行时、Android SDK 与模拟器镜像缺一不可。本文带你用 5 分钟核对完整的环境清单 ✅Node.js 版本要求为什么卡在 24.8最低要求Node.js ≥ 24.8.0或 Node.js 22 线下的 ≥ 22.22.3。这不是随手定的数字而是由 e2e 的 TypeScript 加载机制决定的e2e 的 CLI 基于module.registerHooks直接加载 TypeScript 测试文件不经过额外编译步骤在 Node.js 22.22.3 和 24.8.0 之前的版本中CommonJS 文件无法require()被 hooks 加载的 ES Module会抛出与配置无关的深层 TypeError对应 nodejs/node#59679 修复因此版本下限精确锚定在这两个发布点上。你可以在源码中看到版本策略的定义packages/e2e/src/internal/node-version.ts以及 packages/e2e/package.json 中的engines.node字段。⚠️常见误区Bun 和 Deno 虽然可能上报受支持的 Node 版本号但没有完整的module.registerHooks实现e2e 只运行在 Node.js 上。版本不对时CLI 会给出明确的升级提示nvm install 24/fnm install 24/volta install node24。Windows 用户请在 WSL 内运行官方 Quickstart 明确建议在 Windows 上请在 WSLWindows Subsystem for Linux内部运行 e2e详见 docs/quickstart.mdx。原因简单直接移动端测试引擎e2e-dev/mobile依赖 agent-device 守护进程其设备桥接、模拟器驱动在类 Unix 环境中最稳定e2e 自身也会通过WSL_DISTRO_NAME环境变量识别 WSL 运行环境见 docs/reference/environment.mdx 的遥测一节说明 WSL 是一等公民。只需在 WSL 内完成 Node.js 安装和依赖安装即可获得与 macOS/Linux 一致的体验。iOS 模拟器环境Xcode 运行时清单在 macOS 上跑 iOS 测试e2e 需要的是Xcode 及其 iOS 模拟器运行时核心要点组件说明Xcode提供xcrun simctl等模拟器工具链iOS Simulator Runtime通过 Xcode Settings → Components 安装xcrun simctl list runtimes可查agent-device驱动模拟器的底层引擎随e2e-dev/mobile使用iOS runner 缓存首次使用时编译 XCUITest runner 到~/.agent-device建议纳入 CI 缓存一条命令自检你的环境是否就绪npx agent-device doctor完整的移动端配置说明在 docs/mobile.mdxe2e 引擎会在计时开始前自动启动设备冷启动时间不计入launchTimeout。Android SDK 与模拟器最快配置方法跑 Android 测试需要Android SDK 一个可用的模拟器安装 Android Studio或仅 SDK确保sdkmanager、adb在 PATH 中通过 SDK Manager 安装系统镜像system image并创建 AVD若走 CI 路线Android 作业应运行在带 KVM嵌套虚拟化的 Linux机器上——这是模拟器能否启动的关键而 Apple Silicon 托管 Mac 因无法嵌套虚拟化跑不了 Android 模拟器。CI 场景下的完整机器/构建/设备/Node 要求对照表直接看 docs/mobile-ci.mdxiOS 作业 macOS Xcode 模拟器运行时Android 作业 Linux KVM两者都需要 Node.js 24.8或 22 线下的 22.22.3。移动端引擎的完整实现位于 packages/mobile/还支持通过物理真机测试参考 docs/physical-devices.mdx。环境自检速查表检查项要求验证方式Node.js≥ 24.8.0 或 22.x ≥ 22.22.3node -v运行时必须是 Node.js非 Bun/Deno直接运行npx e2eWindowsWSL 内运行WSL 中e2e --versioniOSXcode 模拟器运行时npx agent-device doctorAndroidAndroid SDK 模拟器镜像adb devices、emulator -list-avds包管理器pnpm / npm / bun 均可pnpm -v等总结e2e 的环境要求可以浓缩为一句话Node.js 24.8 打地基Windows 走 WSLiOS 靠 Xcode 模拟器Android 靠 SDK KVM。按照 docs/quickstart.mdx 的向导流程npx e2e init逐项补齐再跑一次npx agent-device doctor确认你的 Web 移动端 E2E 测试环境就全部就位了 想快速验证环境可以克隆示例项目 examples/with-next/Web或 examples/with-swiftui/iOS跑一遍自带测试。【免费下载链接】e2eNext generation e2e testing framework for web and mobile apps.项目地址: https://gitcode.com/GitHub_Trending/e2e6/e2e创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 e2e环境要求全解析：Node 24.8、WSL、iOS模拟器与Android SDK清单
e2e环境要求全解析Node 24.8、WSL、iOS模拟器与Android SDK清单【免费下载链接】e2eNext generation e2e testing framework for web and mobile apps.项目地址: https://gitcode.com/GitHub_Trending/e2e6/e2e在开始使用 e2e 端到端测试框架面向 Web 与移动端应用的下一代 AI 驱动 E2E 测试工具之前先搞清楚环境要求能帮你避开 90% 的踩坑Node.js 24.8 版本门槛、Windows 上必须使用 WSL、iOS 模拟器依赖 Xcode 运行时、Android SDK 与模拟器镜像缺一不可。本文带你用 5 分钟核对完整的环境清单 ✅Node.js 版本要求为什么卡在 24.8最低要求Node.js ≥ 24.8.0或 Node.js 22 线下的 ≥ 22.22.3。这不是随手定的数字而是由 e2e 的 TypeScript 加载机制决定的e2e 的 CLI 基于module.registerHooks直接加载 TypeScript 测试文件不经过额外编译步骤在 Node.js 22.22.3 和 24.8.0 之前的版本中CommonJS 文件无法require()被 hooks 加载的 ES Module会抛出与配置无关的深层 TypeError对应 nodejs/node#59679 修复因此版本下限精确锚定在这两个发布点上。你可以在源码中看到版本策略的定义packages/e2e/src/internal/node-version.ts以及 packages/e2e/package.json 中的engines.node字段。⚠️常见误区Bun 和 Deno 虽然可能上报受支持的 Node 版本号但没有完整的module.registerHooks实现e2e 只运行在 Node.js 上。版本不对时CLI 会给出明确的升级提示nvm install 24/fnm install 24/volta install node24。Windows 用户请在 WSL 内运行官方 Quickstart 明确建议在 Windows 上请在 WSLWindows Subsystem for Linux内部运行 e2e详见 docs/quickstart.mdx。原因简单直接移动端测试引擎e2e-dev/mobile依赖 agent-device 守护进程其设备桥接、模拟器驱动在类 Unix 环境中最稳定e2e 自身也会通过WSL_DISTRO_NAME环境变量识别 WSL 运行环境见 docs/reference/environment.mdx 的遥测一节说明 WSL 是一等公民。只需在 WSL 内完成 Node.js 安装和依赖安装即可获得与 macOS/Linux 一致的体验。iOS 模拟器环境Xcode 运行时清单在 macOS 上跑 iOS 测试e2e 需要的是Xcode 及其 iOS 模拟器运行时核心要点组件说明Xcode提供xcrun simctl等模拟器工具链iOS Simulator Runtime通过 Xcode Settings → Components 安装xcrun simctl list runtimes可查agent-device驱动模拟器的底层引擎随e2e-dev/mobile使用iOS runner 缓存首次使用时编译 XCUITest runner 到~/.agent-device建议纳入 CI 缓存一条命令自检你的环境是否就绪npx agent-device doctor完整的移动端配置说明在 docs/mobile.mdxe2e 引擎会在计时开始前自动启动设备冷启动时间不计入launchTimeout。Android SDK 与模拟器最快配置方法跑 Android 测试需要Android SDK 一个可用的模拟器安装 Android Studio或仅 SDK确保sdkmanager、adb在 PATH 中通过 SDK Manager 安装系统镜像system image并创建 AVD若走 CI 路线Android 作业应运行在带 KVM嵌套虚拟化的 Linux机器上——这是模拟器能否启动的关键而 Apple Silicon 托管 Mac 因无法嵌套虚拟化跑不了 Android 模拟器。CI 场景下的完整机器/构建/设备/Node 要求对照表直接看 docs/mobile-ci.mdxiOS 作业 macOS Xcode 模拟器运行时Android 作业 Linux KVM两者都需要 Node.js 24.8或 22 线下的 22.22.3。移动端引擎的完整实现位于 packages/mobile/还支持通过物理真机测试参考 docs/physical-devices.mdx。环境自检速查表检查项要求验证方式Node.js≥ 24.8.0 或 22.x ≥ 22.22.3node -v运行时必须是 Node.js非 Bun/Deno直接运行npx e2eWindowsWSL 内运行WSL 中e2e --versioniOSXcode 模拟器运行时npx agent-device doctorAndroidAndroid SDK 模拟器镜像adb devices、emulator -list-avds包管理器pnpm / npm / bun 均可pnpm -v等总结e2e 的环境要求可以浓缩为一句话Node.js 24.8 打地基Windows 走 WSLiOS 靠 Xcode 模拟器Android 靠 SDK KVM。按照 docs/quickstart.mdx 的向导流程npx e2e init逐项补齐再跑一次npx agent-device doctor确认你的 Web 移动端 E2E 测试环境就全部就位了 想快速验证环境可以克隆示例项目 examples/with-next/Web或 examples/with-swiftui/iOS跑一遍自带测试。【免费下载链接】e2eNext generation e2e testing framework for web and mobile apps.项目地址: https://gitcode.com/GitHub_Trending/e2e6/e2e创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考