← ClaudeAtlas

metro-devtools-attachlisted

React Native 앱 디버깅 — 에뮬레이터/시뮬레이터 스크린샷 자동 캡처, Metro CDP로 JS 콘솔 확인, Zustand·TanStack Query 상태 조회, 네트워크 API 모니터링. RN 디버깅, 화면 확인, 스크린샷, console.log 확인, 에뮬레이터, 시뮬레이터, Metro, Hermes, 앱 상태 조회 키워드에 반드시 사용한다.
ridsync/devoks-team-harness · ★ 1 · AI & Automation · score 58
Install: claude install-skill ridsync/devoks-team-harness
## 전제 조건 ### 플러그인 설치 ```sh /plugin install devoks-rn@devoks-plugins /reload-plugins ``` ### 런타임 전제 | 항목 | 조건 | |------|------| | Metro 실행 | `curl -s http://localhost:8081/status` → `packager-status:running` | | 에뮬레이터 | Android: `adb devices` / iOS: `xcrun simctl list devices booted` | ### MCP 도구 Prefix `/devoks-setup-mcp` Step 5로 설치하면 user scope에 등록된다: ``` mcp__metro-devtools__<tool> ``` 미설치 시 `/devoks-setup-mcp`를 실행한다. **`mcp__chrome-devtools-attach__`와 절대 혼용 금지.** --- ## Step 1: 스크린샷 캡처 (항상 사용 가능 — MCP 불필요) Metro 상태나 JS 디버거 활성화와 무관하게 즉시 사용할 수 있다. ### Android Emulator ```bash adb exec-out screencap -p > /tmp/rn_screen.png ``` ### iOS Simulator ```bash xcrun simctl io booted screenshot /tmp/rn_screen.png ``` 스크린샷 저장 후 Read tool로 이미지 파일을 읽으면 Claude가 UI를 시각적으로 확인할 수 있다. #### 트러블슈팅 | 증상 | 원인 | 조치 | |------|------|------| | `adb` 명령 없음 | PATH 미설정 | `export PATH=$PATH:~/Library/Android/sdk/platform-tools` | | Android 스크린샷 빈 파일 | 에뮬레이터 sleep 상태 | 에뮬레이터 화면 깨우기 | | `xcrun simctl` 실패 | Xcode CLI 미설치 또는 PATH | `xcode-select --install` | | iOS 물리 디바이스 | `xcrun simctl` 불가 | `idevicescreenshot`(libimobiledevice) 별도 설치 | --- ## Step 2: Metro CDP 연결 확인 (선택 — JS 상태 조회 필요 시) `/devoks-setup-mcp` Step 5로 설치된 `metro-mcp.js`는 Metro URL을 자동 조회하므로 수동 설정이 불필요하다. ### 2-1. Metro 상태 확인 ```bash # Metro 실행 확인 curl -s http://localhost:8081/status # → packager-status:running # MCP 연결 상태 확인 mcp__metro-devtools__get_metro_status ``` ### 2-2. 연결 테스트 ``` mcp__metro-devtools__evaluat