Life and Tech Talk

스마트폰 디버깅 모드 연결 방법 (갤럭시 s25 기준)

1) USB로 원격 디버깅 (가장 확실)

A. Galaxy S25 설정

  1. 설정 → 휴대전화 정보 → 소프트웨어 정보 → 빌드 번호 7번 탭 → 개발자 옵션 활성화
  2. 설정 → 개발자 옵션에서 USB 디버깅
  • (있다면) **USB 디버깅(보안 설정)**도 켜 주세요.

B. PC에서 Chrome DevTools 연결

  1. Galaxy S25를 USB-C 케이블로 PC에 연결 → 폰에 뜨는 “USB 디버깅 허용” 승인
  2. PC의 Chrome 주소창에 입력: chrome://inspect/#devices
  3. Remote Target에 “Galaxy S25”가 보이면, 휴대폰 Chrome으로 원하는 일반 웹사이트를 엽니다.
  4. PC 화면의 해당 항목에서 Inspect 클릭 → DevTools가 열리며 휴대폰 탭을 실시간 디버깅(Elements/Console/Network/Performance 등)할 수 있습니다.
팁: 휴대폰에서 다른 앱 내 웹뷰가 아니라 Chrome 앱으로 열어야 목록에 뜹니다. (공유 버튼 → “Chrome에서 열기”)

2) 케이블 없이 무선 디버깅 (ADB Wireless)

  1. 설정 → 개발자 옵션 → 무선 디버깅
  2. 무선 디버깅 → 코드로 기기 페어링에서 IP:포트페어링 코드 확인
  3. PC 터미널/명령프롬프트에서:
adb pair <PHONE_IP>:<PAIRING_PORT>   # 예: adb pair 192.168.0.51:37099
# 코드 입력
adb connect <PHONE_IP>:<ADB_PORT>    # 예: adb connect 192.168.0.51:5555
  1. PC에서 다시 chrome://inspect/#devices 열기 → Inspect로 디버깅
동일 Wi-Fi 네트워크여야 하며, 회사/공유기 방화벽이 ADB 포트를 막으면 연결이 안 될 수 있습니다.

3) PC 없이, 폰 화면에서 간이 콘솔 띄우기(임시)

Chrome은 폰 자체 DevTools UI가 없으므로, 한시적으로 페이지에 미니 콘솔을 삽입하는 방법입니다(운영 배포 금지).

<!-- 쿼리 파라미터 ?debug=1 때만 콘솔 로딩 -->
<script>
if (location.search.includes('debug=1')) {
  const s = document.createElement('script');
  s.src = 'https://cdn.jsdelivr.net/npm/eruda';
  s.onload = () => eruda.init();
  document.body.appendChild(s);
}
</script>
  • 일반 웹사이트의 테스트 페이지나 본인 소유 페이지에만 사용하세요.
  • 접속 시 https://example.com/?debug=1 처럼 열면 화면 하단에 미니 콘솔이 떠서
  • 로그/네트워크/스토리지 등을 폰에서 직접 확인할 수 있습니다.


4) 자주 막히는 포인트 체크리스트

  • 기기가 chrome://inspect에 안 보임:
  • USB 디버깅 허용 다시 확인 → 케이블 교체 → 폰/PC 재연결 → “이 컴퓨터 신뢰” 재승인
  • Inspect 버튼은 보이는데 빈 화면:
  • 휴대폰에서 페이지를 Chrome 앱으로 열었는지, 탭이 활성 상태인지 확인
  • 무선 디버깅 연결 실패:
  • 폰/PC 같은 Wi-Fi인지, 라우터 격리(AP 분리) 또는 회사 방화벽 정책 여부 확인
  • HTTPS/쿠키 문제:
  • 혼합 콘텐츠 차단으로 콘솔 오류가 뜰 수 있음 → 사이트 보안 설정/정책 확인
  • 웹뷰(인앱 브라우저):
  • 일부 앱 내 웹뷰는 원격 디버깅이 제한될 수 있음 → Chrome에서 열기로 전환


5) (선택) Samsung Internet도 디버깅 가능

Galaxy에 기본 탑재된 Samsung Internet을 쓰는 경우, PC Chrome DevTools에서 동일하게 chrome://inspectSamsung Internet 탭도 원격 검사할 수 있습니다. (개발자 옵션/USB 디버깅 절차 동일)

올린날: 2025년 10월 14일
주제: 기술문서 관련 포스팅 클릭!!

* 올린이: aiSVC

* VIEW: 165       0           위키홈     게시판     수정