본문으로 건너뛰기

웹 인스펙터 설정하기

Thumbnail Image

🔔 최신화 일자: 2025-11-04

웹 인스펙터 이해하기​

웹뷰(WebView) 앱을 개발하다 보면 실제 모바일 디바이스에서의 동작을 확인하고 디버깅해야 할 때가 많습니다. 웹 인스펙터는 Android/iOS 디바이스와의 연결을 통해 이러한 작업을 가능하게 합니다.

웹 인스펙터란?

웹 인스펙터(Web Inspector)는 웹 개발자 도구로, HTML/CSS/JavaScript 코드를 실시간으로 검사하고 수정할 수 있는 디버깅 도구입니다. Chrome DevTools(Android)와 Safari Web Inspector(iOS)를 통해 앱 내 웹뷰에서 발생하는 문제를 브라우저에서와 동일하게 디버깅할 수 있습니다.

Android, iOS 웹 인스펙터를 활용해 실기기에서 웹뷰(WebView)의 웹 클라이언트를 디버깅하여 브라우저에서는 정상 동작하지만 앱에서만 발생하는 문제들을 실시간으로 추적하고 해결할 수 있습니다.

  1. Android에서 웹 인스펙터 사용하기
  2. iOS에서 웹 인스펙터 사용하기

Android에서 웹 인스펙터 사용하기​

1단계: Android 디바이스 설정​

개발자 옵션 활성화​

  1. 설정 > 휴대전화 정보 이동

    android_inspect_1

  2. 소프트웨어 정보로 이동

    android_inspect_2

  3. 빌드번호를 7번 연속 탭

    android_inspect_3

  4. "개발자 모드를 켰습니다." 메시지 확인

    android_inspect_4


USB 디버깅 활성화​

  1. 설정 > 개발자 옵션 이동

    android_inspect_5

  2. USB 디버깅 토글을 ON으로 설정 후 권한 허용 팝업에서 확인 선택

    android_inspect_6


2단계: PC 설정 및 연결​

준비 사항​

  • Windows/Mac/Linux PC
  • USB 케이블 (디바이스와 PC 연결용)
  • Chrome 브라우저 (최신 버전 권장)

연결 과정​

  1. USB 케이블로 Android 디바이스와 PC를 연결

  2. 디바이스에서 "USB 디버깅 허용" 팝업이 나타나면 확인 선택

  3. PC에서 Chrome 브라우저를 실행

  4. 주소창에 chrome://inspect 입력하여 접속

    chrome_inspect_1


3단계: 웹 클라이언트 디버깅​

디버깅 시작​

  1. Android 디바이스에서 샌드박스 앱을 실행

  2. Chrome의 chrome://inspect 페이지에서 디바이스 목록을 확인

  3. 앱 이름 옆의 "inspect" 버튼을 클릭

    chrome_inspect_1-1

  4. Chrome DevTools 창이 열리면 디버깅 준비 완료

    chrome_inspect_2


디버깅 기능 활용​

  • Console: JavaScript 오류, 로그 메시지 실시간 확인
  • Elements: HTML/CSS 실시간 수정 및 테스트
  • Network: API 요청/응답, 로딩 시간 모니터링
  • Sources: JavaScript 코드 디버깅, 브레이크포인트 설정

iOS에서 웹 인스펙터 사용하기​

1단계: iOS 디바이스 설정​

웹 인스펙터 활성화​

  1. iOS 디바이스에서 설정 앱을 실행

    ios_inspect_1

  2. 검색창에 Safari 입력 후 앱 선택

    ios_inspect_2

  3. 고급을 선택

    ios_inspect_3

  4. 웹 인스펙터 토글을 ON으로 설정

    ios_inspect_4


2단계: Mac 설정 및 연결​

준비 사항​

  • Mac 컴퓨터 (Windows/Linux는 지원하지 않음)
  • Lightning 또는 USB-C 케이블
  • Safari 브라우저

설정 과정​

  1. Mac에서 Safari를 실행

  2. Safari > 설정 선택 (또는 Cmd + ,)

    safari_configuration_1

  3. 고급 탭 선택

    safari_configuration_2

  4. 웹 개발자를 위한 기능 보기 체크

    safari_configuration_2-1


3단계: 웹 클라이언트 디버깅​

  1. iOS 디바이스와 Mac을 케이블로 연결

  2. 디바이스에서 신뢰 요청 팝업이 나타나면 신뢰 선택

    ios_inspect_5

  3. 맥북에서 액세서리 허용 요청 팝업이 나타나면 허용 선택

    safari_inspect_1

  4. iOS 디바이스에서 샌드박스 앱을 실행

  5. Mac Safari 실행 후 상단 탭에서 개발자용 메뉴 클릭

    safari_inspect_2

  6. 디바이스명 하위에 표시되는 앱명을 선택

    safari_inspect_4

  7. Safari 인스펙터 창이 열리면 디버깅 준비 완료

    safari_inspect_5ios_inspect_6

디버깅 기능 활용​

Safari Web Inspector에서 다음 기능들을 사용할 수 있습니다.

  • Console: JavaScript 실행, 로그 확인
  • Elements: DOM 구조 확인 및 CSS 수정
  • Network: 네트워크 요청 모니터링
  • Debugger: JavaScript 디버깅
  • Storage: 로컬 스토리지, 세션 스토리지 확인