안드로이드 무선 디버깅 설정: ADB로 케이블 없이 개발하기 [2024.12.05.목]

2024.12.05(목)

 

본 글은 KMP 프로젝트 개발을 인텔리제이로 하던 중, 인텔리제이에서 무선 디버깅 연결이 원활하지 않아, 그냥 계속 유선 연결로 개발하던 중, adb 명령을 통해 직접 무신 디버깅 연결을 하여 개발하게 되면서 간단히 정리하는 글 입니다. 

 

그럼 안드로이드 개발 시 유용한 무선 디버깅 설정 방법에 대해 상세히 알아보겠습니다.

1. ADB 환경 설정

우선 ADB(Android Debug Bridge)에 접근할 수 있어야 합니다. 두 가지 방법이 있습니다:

방법 1: ADB 경로 직접 접근

cd C:\Users\{사용자명}\AppData\Local\Android\Sdk\platform-tools

방법 2: 환경 변수 설정 (권장)

시스템 환경 변수에 ADB 경로를 추가하면 어느 위치에서든 ADB 명령어를 실행할 수 있습니다. 이는 한 번만 설정하면 영구적으로 사용 가능한 장점이 있습니다.

2. 디바이스 페어링

1. 안드로이드 기기에서:
   • 설정 → 개발자 옵션 → 무선 디버깅 활성화
   • '코드로 페어링' 옵션 선택
2. 개발 PC에서:
3. ./adb pair {페어링_IP:포트}
4. 안드로이드 기기에 표시된 페어링 코드를 PC에 입력

3. 디바이스 연결

페어링 완료 후, 실제 디버깅 연결을 설정합니다:

./adb connect {디바이스_IP:포트}

주요 주의사항: 연결 시 사용하는 포트는 페어링 시 사용한 포트와 다릅니다. 반드시 '무선 디버깅' 화면에 표시된 IP와 포트를 사용하세요.