이제 Android 11 개발자 프리뷰를 사용할 수 있습니다. 테스트해 보고 의견을 공유하세요.

하드웨어 기기에서 앱 실행

Android 앱을 빌드할 때는 항상 앱을 사용자에게 배포하기 전에 실제 기기에서 테스트하는 것이 중요합니다. 이 페이지에서는 Android 디버그 브리지(ADB) 연결을 통한 테스트 및 디버깅을 위해 개발 환경 및 Android 기기를 설정하는 방법을 설명합니다.

기기를 개발용으로 설정하기

기기에서 디버깅을 시작하기 전에 다음 작업을 실행해야 합니다.

  1. 기기에서 설정 앱을 열고 개발자 옵션을 선택한 다음 USB 디버깅을 사용 설정합니다.

  2. 기기를 감지하도록 시스템을 설정합니다.

    • macOS: 추가 구성이 필요하지 않습니다.

    • Ubuntu Linux: apt-get install을 사용하여 adb 패키지를 설치합니다. 이렇게 하면 커뮤니티에서 유지하는 모든 Android 기기를 위한 기본 udev 규칙 세트를 이용할 수 있습니다.

      plugdev 그룹에 포함되어 있는지 확인하세요. 다음과 같은 오류 메시지가 표시되면 adb가 plugdev 그룹에서 개발자를 찾지 못한 것입니다.

      error: insufficient permissions for device: udev requires plugdev group membership

      id를 사용하여 현재 포함되어 있는 그룹을 확인합니다. sudo usermod -aG plugdev $LOGNAME을 사용하여 개발자 본인을 plugdev 그룹에 추가합니다.

      다음 예에서는 Android adb 도구 패키지를 설치하는 방법을 보여줍니다.

      apt-get install adb

    • Windows: ADB용 USB 드라이버를 설치합니다. 설치 가이드와 OEM 드라이버의 링크는 OEM USB 드라이버 설치 문서를 참조하세요.

    • Chrome OS: 추가 구성이 필요하지 않습니다.

기기에 연결하기

USB를 통해 설정되고 연결된 경우 Android 스튜디오에서 Run 을 클릭하여 기기에서 앱을 빌드하고 실행할 수 있습니다.

다음과 같이 adb를 사용하여 명령어를 실행할 수도 있습니다.

  • android_sdk/platform-tools/ 디렉터리의 adb devices 명령어를 실행하여 기기가 연결되어 있는지 확인합니다. 연결된 경우 기기가 나열됩니다.
  • adb 명령어를 -d 플래그와 함께 실행하여 기기를 타겟팅합니다.

연결 도우미를 사용하여 기기 연결 문제해결

연결 도우미에서는 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 에뮬레이터에 연결할 수 있는지 확인

Android 스튜디오와 Android Emulator 간의 연결 문제로 인해 문제가 발생하는지 확인하려면 다음 단계를 따르세요.

  1. AVD Manager를 엽니다.
  2. 새 AVD를 만듭니다(아직 없는 경우).
  3. AVD를 사용하여 에뮬레이터를 실행합니다.
  4. 다음 중 하나를 실행합니다.
    • Android 스튜디오에서 에뮬레이터에 연결할 수 없으면 최신 SDK 플랫폼 도구를 다운로드하고 다시 시도해보세요.
    • 에뮬레이터가 성공적으로 시작되면 USB 케이블을 확인합니다.

USB 케이블 확인

USB 케이블의 결함으로 인해 문제가 발생하는지 확인하려면 이 섹션의 단계를 따르세요.

다른 USB 케이블이 있는 경우:

  1. 보조 케이블을 사용하여 기기를 연결합니다.
  2. 이제 연결 도우미가 기기를 감지할 수 있는지 확인합니다.
  3. 기기가 감지되지 않으면 기본 케이블을 사용하여 다시 시도합니다.
  4. 기기가 아직도 감지되지 않으면 기기에 문제가 있다고 가정하고 기기가 개발용으로 설정되어 있는지 확인합니다.

다른 USB 케이블은 없지만 다른 Android 기기가 있는 경우:

  1. 보조 기기를 컴퓨터에 연결합니다.

  2. 연결 도우미가 보조 기기를 감지할 수 있으면 기본 기기에 문제가 있다고 가정하고 기기가 개발용으로 설정되어 있는지 확인합니다.

    보조 기기가 감지되지 않으면 USB 케이블에 문제가 있을 수 있습니다.

기기가 개발용으로 설정되어 있는지 확인

기기의 설정으로 인해 문제가 발생하는지 확인하려면 다음 단계를 따르세요.

  1. 기기를 개발용으로 설정하기 섹션의 단계를 따릅니다.
  2. 이렇게 해도 문제가 해결되지 않으면 기기 OEM의 고객지원팀에 도움을 요청하세요. 고객지원 담당자에게 기기가 ADB를 사용하여 Android 스튜디오에 연결되지 않는다고 이야기하세요.

RSA 보안 키

참고: Android 4.2.2(API 레벨 17) 이상을 실행하는 기기를 컴퓨터에 연결하면 이 컴퓨터를 통해 디버깅을 허용하는 RSA 키를 수락할지 묻는 대화상자가 표시됩니다. 이 보안 메커니즘은 개발자가 기기를 잠금 해제하고 대화상자를 확인할 수 없으면 USB 디버깅 및 기타 adb 명령어를 실행할 수 없도록 보장하므로 사용자 기기를 보호합니다.