[Android] 안드로이드 무선 디버깅 가이드

박정빈·2026년 4월 22일

React Native 사용기

목록 보기
40/41

준비사항

  1. 동일한 Wi-Fi 연결: PC와 안드로이드 기기가 반드시 같은 네트워크에 연결되어 있어야 합니다.
  2. 개발자 옵션 활성화: 설정 > 휴대전화 정보 > 소프트웨어 정보 > 빌드 번호를 7번 연속 클릭합니다.
  3. ADB 설치: PC에 Android SDK Platform-Tools가 설치되어 있고, 환경 변수 설정이 되어 있어야 합니다.

안드로이드 11 이상 (최신 방식: 페어링 코드)

기기 설정

  1. 기기의 설정 > 개발자 옵션으로 들어갑니다.
  2. 무선 디버깅(Wireless Debugging) 항목을 찾아 활성화합니다.
  3. 무선 디버깅 글자를 눌러 상세 메뉴로 진입한 뒤, '페어링 코드로 기기 페어링'을 선택합니다.
  4. 화면에 Wi-Fi 페어링 코드IP 주소 및 포트가 나타납니다.

PC에서 페어링 및 연결

터미널(CMD 또는 PowerShell)을 열고 다음 명령어를 입력합니다.

  • 기기 페어링: adb pair [IP_ADDRESS]:[PORT]
  • 페어링 예시: adb pair 192.168.0.5:37281 (이후 화면에 보이는 6자리 페어링 코드를 입력합니다.)

페어링에 성공했다면, 실제 연결을 수행합니다. (주의: 페어링용 포트와 연결용 포트는 다릅니다)

  • 기기 연결: adb connect [IP_ADDRESS]:[PORT]
  • 연결 예시: adb connect 192.168.0.5:42561

연결 확인 및 해제

  • 연결된 기기 목록 확인: adb devices
  • 특정 기기 해제: adb disconnect [IP_ADDRESS]:[PORT]
  • 모든 연결 해제: adb disconnect

꿀팁 및 문제 해결

  • 연결 실패 시: 기기의 Wi-Fi를 껐다 켜거나, 개발자 옵션에서 '무선 디버깅'을 껐다 켜보세요.
  • 고정 IP 사용: 공유기 설정에서 기기의 MAC 주소를 기반으로 고정 IP를 할당해두면, 매번 IP를 확인할 필요가 없어 편리합니다.
  • 복수 기기 사용: 여러 대를 연결할 경우 adb -s [IP:PORT] shell 처럼 -s 옵션으로 대상을 지정해야 합니다.

0개의 댓글