Android 앱을 빌드할 때는 항상 앱을 사용자에게 배포하기 전에 실제 기기에서 테스트하는 것이 중요합니다. 이 페이지에서는 Android 디버그 브리지(ADB) 연결을 통한 테스트 및 디버깅을 위해 개발 환경 및 Android 기기를 설정하는 방법을 설명합니다.
기기를 개발용으로 설정하기
기기에서 디버깅을 시작하려면 기기를 연결하는 데 USB 케이블을 사용할지 Wi-Fi를 사용할지 결정합니다. 결정한 후 다음 작업을 실행하세요.
기기에서 설정 앱을 열고 개발자 옵션을 선택한 다음 USB 디버깅(옵션이 표시되는 경우)을 사용 설정합니다.
기기를 감지하도록 시스템을 설정합니다.
- Chrome OS: 추가 구성이 필요하지 않습니다.
- macOS: 추가 구성이 필요하지 않습니다.
Ubuntu Linux: 두 가지를 올바르게 설정해야 합니다. adb를 사용하려는 각 사용자는 plugdev 그룹에 있어야 하고 시스템에는 기기에 적용되는 udev 규칙이 설치되어 있어야 합니다.
plugdev 그룹: plugdev 그룹에 있지 않다는 오류 메시지가 표시되면 plugdev 그룹에 직접 추가해야 합니다.
sudo usermod -aG plugdev $LOGNAME
그룹은 로그인 시에만 업데이트되므로 이러한 변경사항을 적용하려면 로그아웃해야 합니다. 다시 로그인하면
id
를 사용하여 현재 plugdev 그룹에 있는지 확인할 수 있습니다.udev 규칙:
android-sdk-platform-tools-common
패키지에는 커뮤니티에서 유지하는 Android 기기를 위한 기본 udev 규칙 세트가 포함되어 있습니다. 설치하려면 다음 방법을 따르세요.apt-get install android-sdk-platform-tools-common
Windows: ADB용 USB 드라이버를 설치합니다(필요한 경우). 설치 가이드와 OEM 드라이버의 링크는 OEM USB 드라이버 설치 문서를 참고하세요.
USB를 사용하여 기기에 연결하기
USB를 통해 설정되고 연결된 경우 Android 스튜디오에서 Run 을 클릭하여 기기에서 앱을 빌드하고 실행할 수 있습니다.
다음과 같이 adb를 사용하여 명령어를 실행할 수도 있습니다.
android_sdk/platform-tools/
디렉터리의adb devices
명령어를 실행하여 기기가 연결되어 있는지 확인합니다. 연결된 경우 기기가 나열됩니다.- adb 명령어를
-d
플래그와 함께 실행하여 기기를 타겟팅합니다.
Wi-Fi를 사용하여 기기에 연결하기
Android 11 이상에서는 Android 디버그 브리지(adb)를 통해 워크스테이션에서 무선으로 앱을 배포하고 디버깅할 수 있도록 지원합니다. 예를 들어 USB를 통해 기기를 물리적으로 연결하거나 드라이버 설치와 같은 일반적인 USB 연결 문제와 씨름하지 않고도 디버깅 가능한 앱을 여러 원격 기기에 배포할 수 있습니다.
무선 디버깅을 사용하려면 페어링 코드를 사용하여 기기와 워크스테이션을 페어링해야 합니다. 워크스테이션과 기기가 동일한 무선 네트워크에 연결되어 있어야 합니다. 기기에 연결하려면 다음 단계를 따르세요.

- 워크스테이션에서 최신 버전의 SDK 플랫폼 도구로 업데이트합니다.
- 개발자 옵션에서 무선 디버깅 옵션을 사용 설정합니다.
- 이 네트워크에서 무선 디버깅을 허용하시겠습니까? 라고 묻는 대화상자에서 허용을 클릭합니다.
- 기기와 페어링 코드 페어링을 선택합니다. 기기에 표시된 페어링 코드, IP 주소 및 포트 번호를 기록해 두세요(이미지 참조).
- 워크스테이션에서 터미널을 열고
android_sdk/platform-tools
로 이동합니다. adb pair ipaddr:port
를 실행합니다. 3단계의 IP 주소와 포트 번호를 사용합니다.메시지가 표시되면 4단계에서 받은 페어링 코드를 입력합니다. 기기의 페어링이 완료되었다는 메시지가 표시되어야 합니다.
Enter pairing code: 482924 Successfully paired to 192.168.1.130:37099 [guid=adb-235XY]
(Linux 또는 Microsoft Windows에만 적용)
adb connect ipaddr:port
를 실행합니다. 무선 디버깅에서 IP 주소와 포트를 사용합니다(아래 이미지 참조).
연결 도우미를 사용하여 기기 연결 문제 해결하기
연결 도우미에서는 ADB 연결을 통해 기기를 설정하고 사용할 수 있도록 단계별 안내를 제공합니다.
이 도우미를 사용하려면 Tools > Connection Assistant를 선택하세요.
연결 도우미는 Assistant 패널의 여러 페이지에 걸쳐 안내, 문맥에 맞는 컨트롤, 연결된 기기 목록을 제공합니다. Assistant 패널 하단의 Next 및 Previous 버튼을 사용하여 필요에 따라 페이지 간을 이동합니다.
- USB를 통해 기기 연결: 연결 도우미를 시작하면 USB를 통해 기기를 연결하라는 메시지가 표시되며 연결된 기기 검색을 새롭게 시작할 수 있는 Rescan USB devices 버튼이 표시됩니다.
- USB 디버깅 사용 설정: 그런 다음 연결 도우미가 온디바이스 개발자 옵션에서 USB 디버깅을 사용 설정하는 방법을 알려줍니다.
- ADB 서버 다시 시작: 마지막으로, 아직도 기기가 사용 가능한 기기 목록에 표시되지 않으면 연결 도우미의 마지막 페이지에 있는 Restart ADB server 버튼을 사용할 수 있습니다. ADB 서버를 다시 시작하면 ADB도 기기를 다시 검색합니다. 그래도 기기가 사용 가능한 기기 목록에 표시되지 않으면 이 페이지의 다음 섹션에 있는 문제 해결 단계를 실행해 보세요.
USB 연결 문제 해결
연결 도우미가 USB를 통해 기기를 감지하지 못하는 경우 다음 문제 해결 단계에 따라 문제를 해결할 수 있습니다.
Android 스튜디오에서 Android Emulator에 연결할 수 있는지 확인
Android 스튜디오와 Android Emulator 간의 연결 문제로 인해 문제가 발생하는지 확인하려면 다음 단계를 따르세요.
- AVD Manager를 엽니다.
- 새 AVD를 만듭니다(아직 없는 경우).
- AVD를 사용하여 에뮬레이터를 실행합니다.
- 다음 중 한 가지 방법을 사용합니다.
- Android 스튜디오에서 에뮬레이터에 연결할 수 없으면 최신 SDK 플랫폼 도구를 다운로드하고 다시 시도해보세요.
- 에뮬레이터가 시작되면 USB 케이블을 확인합니다.
USB 케이블 확인
USB 케이블의 결함으로 인해 문제가 발생하는지 확인하려면 이 섹션의 단계를 따르세요.
다른 USB 케이블이 있는 경우:
- 보조 케이블을 사용하여 기기를 연결합니다.
- 이제 연결 도우미가 기기를 감지할 수 있는지 확인합니다.
- 기기가 감지되지 않으면 기본 케이블을 사용하여 다시 시도합니다.
- 기기가 아직도 감지되지 않으면 기기에 문제가 있다고 가정하고 기기가 개발용으로 설정되어 있는지 확인합니다.
다른 USB 케이블은 없지만 다른 Android 기기가 있는 경우:
- 보조 기기를 컴퓨터에 연결합니다.
연결 도우미가 보조 기기를 감지할 수 있으면 기본 기기에 문제가 있다고 가정하고 기기가 개발용으로 설정되어 있는지 확인합니다.
보조 기기가 감지되지 않으면 USB 케이블에 문제가 있을 수 있습니다.
기기가 개발용으로 설정되어 있는지 확인
기기의 설정으로 인해 문제가 발생하는지 확인하려면 다음 단계를 따르세요.
- 기기를 개발용으로 설정하기 섹션의 단계를 따릅니다.
- 이렇게 해도 문제가 해결되지 않으면 기기 OEM의 고객지원팀에 도움을 요청하세요. 고객지원 담당자에게 기기가 ADB를 사용하여 Android 스튜디오에 연결되지 않는다고 이야기하세요.
RSA 보안 키
Android 4.2.2(API 수준 17) 이상을 실행하는 기기를 컴퓨터에 연결하면 시스템에서는 이 컴퓨터를 통한 디버깅을 허용하는 RSA 키를 수락할지 묻는 대화상자를 표시합니다. 이 보안 메커니즘은 개발자가 기기를 잠금 해제하고 대화상자를 확인하지 않으면 USB 디버깅 및 기타 adb 명령어를 실행할 수 없도록 보장하기 때문에 사용자 기기를 보호하는 역할을 합니다.