用途:为在 iOS 模拟器或 Android 模拟器上开发、调试 React Native 应用提供分步工作流,包括启动应用、排查 Metro、修复构建失败和处理运行时问题。
主要能力:启动前先读取项目配置,优先使用自定义脚本而非默认命令;检查 node_modules、Podfile,必要时执行 cd ios && pod install && cd ..;启动 Metro 前用 lsof -i :PORT 检查端口是否被占用;默认命令为 npx react-native start、npx react-native run-ios、npx react-native run-android,缓存问题时可用 npx react-native start --reset-cache。Android 安装后需执行 adb -s <serial> reverse tcp:8081 tcp:8081。
调试与排查:通过 debugger-status 判断 Metro 状态,用 stop-metro 结束 Metro;用 debugger-reload-metro 重载、debugger-component-tree 查看组件树、debugger-evaluate 执行 JS、debugger-log-registry 读取日志;原生崩溃可用 npx react-native log-ios 或 npx react-native log-android。构建失败时按从简到繁顺序清理重试,连续失败 2 至 3 次应询问用户。
适用场景:需要模拟器环境;物理 iPhone 不被 Metro 调试与性能分析工具支持。限制与缺失:测试命令需查看项目配置;Jest、Detox 的具体配置与运行方式以项目为准,资料未提供完整示例。