3 분 소요

Android USB Debugging 활성화

안드로이드 기기를 PC에 연결했는데 adb devices에 아무것도 안 뜨거나, Android Studio가 기기를 인식하지 못하면 대부분 첫 번째 원인은 USB 디버깅 설정이다. 그런데 막상 익숙하지 않은 기기에서는 메뉴가 제조사별로 조금씩 다르고, 케이블 문제나 USB 모드 문제까지 섞여 있어서 생각보다 시간을 잡아먹는다.

이 글은 단순히 “빌드 번호 7번 누르세요”에서 끝내지 않고, 왜 USB 디버깅이 필요한지, 활성화 후에도 기기가 안 잡힐 때 무엇을 의심해야 하는지, 무선 디버깅은 언제 유용한지까지 한 번에 정리한다.

USB 디버깅이 필요한 상황

USB 디버깅은 개발자가 PC와 안드로이드 기기를 ADB(Android Debug Bridge) 로 연결하기 위한 전제 조건이다. 이 설정이 꺼져 있으면 아래 작업이 제대로 되지 않는다.

  • Android Studio에서 앱 설치 및 디버깅
  • adb logcat으로 로그 확인
  • adb install, adb shell 같은 명령 실행
  • 모바일 웹 디버깅용 Chrome Inspector 연결
  • 일부 자동화 테스트 도구 사용

즉, 앱을 실제 기기에서 테스트하는 개발자라면 거의 필수라고 봐도 된다.

개발자 옵션부터 활성화하기

먼저 개발자 옵션 메뉴를 열어야 USB 디버깅 스위치가 보인다. 대부분 다음 흐름이다.

  1. 설정 > 휴대전화 정보(또는 디바이스 정보) 로 이동
  2. 빌드 번호 항목을 찾는다
  3. 빌드 번호를 연속으로 7번 터치한다
  4. 잠금 해제 PIN이나 패턴을 요구하면 입력한다
  5. “이제 개발자가 되셨습니다” 같은 안내가 뜬다

제조사 UI에 따라 경로가 조금 다르다. 삼성은 소프트웨어 정보 > 빌드번호처럼 한 단계 더 들어가는 경우가 많다. 그래서 설정 검색에서 “빌드 번호” 또는 “개발자 옵션”을 직접 찾는 편이 빠를 때도 있다.

USB 디버깅 활성화 순서

개발자 옵션이 열리면 그 다음은 쉽다.

  1. 설정 > 개발자 옵션 이동
  2. USB 디버깅 스위치를 켠다
  3. 경고 팝업이 나오면 내용을 확인 후 허용한다
  4. 기기를 USB로 PC에 연결한다
  5. 기기 화면에서 이 컴퓨터의 RSA 키를 허용할지 묻는 팝업이 뜨면 허용한다

여기서 중요한 건 스위치만 켜는 것으로 끝나지 않는다는 점이다. 실제로 ADB 연결이 성립하려면 PC의 디버깅 키를 기기에서 신뢰해야 한다. 이 승인을 놓치면 unauthorized 상태가 뜬다.

연결 확인 명령

터미널에서 아래 명령으로 상태를 바로 확인할 수 있다.

adb devices

정상이라면 이런 식으로 보인다.

List of devices attached
R3CN30XXXX    device

문제가 있으면 아래처럼 나온다.

  • unauthorized : 기기에서 RSA 승인 안 함
  • 빈 목록 : 케이블, 드라이버, USB 모드, adb 자체 문제
  • offline : 연결은 있었지만 세션이 꼬였음

무선 디버깅은 언제 쓰면 좋은가

최근 안드로이드에서는 무선 디버깅도 꽤 쓸 만하다. 케이블 없이 같은 네트워크에서 연결할 수 있어서 테스트 테이블이 지저분하지 않고, 물리적으로 PC와 떨어진 기기를 다룰 때도 편하다.

다만 개인적으로는 처음 세팅이나 불안정한 QA 환경에서는 여전히 USB가 낫다고 본다. 이유는 단순하다.

  • 무선 디버깅은 네트워크 상태 영향을 받음
  • 같은 Wi‑Fi가 아니면 연결이 번거로움
  • 방화벽/사내망 정책 때문에 막힐 수 있음

그래서 추천 흐름은 기본은 USB, 반복 테스트나 데모 환경에서는 무선 디버깅 보조 사용이다.

자주 막히는 문제와 해결

1) 충전은 되는데 adb에 안 뜬다

가장 흔하다. 저가형 또는 번들 케이블 중에는 충전 전용 케이블이 섞여 있다. 데이터 전송이 가능한 케이블로 바꿔 보는 것이 가장 빠르다. 그리고 USB 연결 모드가 “충전만”으로 고정된 경우도 있어서 파일 전송/PTP 모드로 한 번 바꿔 보는 것도 도움된다.

2) unauthorized 상태가 계속된다

기기 화면 잠금을 해제한 상태에서 RSA 승인 팝업을 봐야 한다. 안 보이면 아래 순서로 다시 시도한다.

adb kill-server
adb start-server
adb devices

그래도 안 되면 개발자 옵션에서 USB 디버깅 권한 취소를 한 뒤 다시 연결하는 편이 낫다.

3) Windows에서 드라이버 문제

특히 제조사별 USB 드라이버가 필요한 모델에서는 드라이버가 없거나 잘못 잡혀서 연결이 안 될 수 있다. 이때는 Android Studio나 플랫폼 도구 문제가 아니라 장치 관리자 수준에서 드라이버를 봐야 한다.

실무에서 같이 묶어두면 좋은 것

USB 디버깅은 혼자 쓰이는 설정이 아니다. 팀 문서에는 아래 항목과 묶어 두면 좋다.

  • Chrome Inspector 사용법 : 모바일 웹/웹뷰 디버깅
  • Charles Web Proxy 사용법 : 네트워크 요청 확인
  • QA용 테스트 기기 초기 세팅 체크리스트

이 세 가지가 같이 있어야 실제 앱 디버깅 루프가 매끄럽다.

빠른 체크리스트

  • 개발자 옵션을 활성화했다
  • USB 디버깅을 켰다
  • 기기에서 RSA 디버깅 허용 팝업을 승인했다
  • adb devices에서 device 상태를 확인했다
  • 데이터 전송 가능한 케이블을 사용했다
  • 필요하면 무선 디버깅도 별도로 켰다

마무리

안드로이드 USB 디버깅은 메뉴 자체는 단순하지만, 실제로는 개발자 옵션, 케이블, USB 모드, RSA 승인, ADB 상태가 한 세트로 움직인다. 그래서 초보자에게는 설정 하나처럼 보여도 실전에서는 체크 포인트가 여러 개다. 팀 내 온보딩 문서나 개인 메모에도 “USB 디버깅 ON” 한 줄보다 연결 확인 명령과 실패 대응까지 적어두는 편이 훨씬 덜 고생한다.

댓글남기기