하드웨어 기기에서 앱 실행

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 명령어를 실행할 수 없도록 보장하기 때문에 사용자 기기를 보호하는 역할을 합니다.