Skip to content

Most visited

Recently visited

navigation

하드웨어 기기에서 앱 실행

Android 앱을 빌드할 때는 애플리케이션을 사용자에게 릴리스하기 전에 항상 실제 기기에서 테스트하는 것이 중요합니다. 이 페이지에서는 개발 환경을 설정하는 방법과 Android 구동 기기를 기기에서 테스트 및 디버깅용으로 사용하는 방법을 설명합니다.

모든 Android 구동 기기는 애플리케이션을 실행, 디버깅 및 테스트하기 위한 환경으로 사용할 수 있습니다. SDK에 포함된 각종 도구를 사용하면 컴파일링할 때마다 기기에서 애플리케이션을 설치하고 실행하기 쉽습니다. Android Studio에서 직접 설치하거나 ADB의 명령줄에서 설치하는 방식으로 애플리케이션을 기기에 설치할 수 있습니다. 아직 기기가 없는 경우, 인근 지역의 서비스 제공업체에 문의하여 어떤 Android 구동 기기를 이용할 수 있는지 알아보십시오.

SIM이 잠금 해제된 휴대폰을 원하는 경우, Nexus 휴대폰을 고려할 수 있습니다. Nexus 휴대폰을 구매하려면 Google Play 스토어를 방문하세요.

참고: 기기에서 앱을 개발할 때는 실제 기기와 동등하지 않은 구성에서 애플리케이션을 테스트하려면 여전히 Android Emulator를 사용해야 한다는 점을 잊지 마세요. 이 에뮬레이터로 모든 기기 기능(예 가속도계)을 테스트할 수 있는 것은 아니지만, 다양한 버전의 Android 플랫폼이나 화면 크기와 방향이 각기 다른 경우 등 여러 가지 조건에서 애플리케이션 기능이 적절히 작동하는지 확인할 수 있습니다.

온디바이스 개발자 옵션 활성화

Android 구동 기기에는 휴대폰에서 액세스할 수 있는 많은 개발자 옵션이 있으며, 다음과 같은 작업을 수행할 수 있습니다.

이러한 설정에 액세스하려면 시스템 설정에서 Developer options를 엽니다. Android 4.2 이상 버전에서는 Developer options 화면이 기본적으로 숨겨져 있습니다. 이 옵션을 표시하려면 Settings > About Phone으로 이동하여 Build number를 일곱 번 누릅니다. 이전 화면으로 돌아가서 하단에서 Developer options를 찾습니다.

기기를 개발용으로 설정

Android 구동 기기를 사용하면 에뮬레이터에서와 똑같은 방식으로 Android 애플리케이션을 개발하고 디버깅할 수 있습니다. 시작하기 전에 몇 가지 할 일이 있습니다.

  1. 매니페스트 또는 build.gradle 파일에서 애플리케이션이 "디버그 가능"한지 확인합니다.

    빌드 파일의 debug 빌드 유형에서 debuggable 속성이 'true'로 설정되어 있는지 확인합니다. 이 빌드 유형 속성은 매니페스트 설정을 재정의합니다.

    android {
        buildTypes {
            debug {
                debuggable true
            }
    

    AndroidManifest.xml 파일에서 <application> 요소에 android:debuggable="true"를 추가합니다.

    참고: 매니페스트 파일에서 수동으로 디버깅을 활성화한 경우, 릴리스 빌드에서 이를 비활성화해야 합니다. (게시된 애플리케이션은 대개 디버깅할 수 없습니다.)

  2. 기기에서 Settings > Developer options로 이동하여 USB debugging을 활성화합니다.

    참고: Android 4.2 이상의 버전에서는 Developer options가 기본적으로 숨겨져 있습니다. 이 옵션을 활성화하려면 Settings > About phone으로 이동하여 Build number를 일곱 번 누릅니다. 이전 화면으로 돌아가서 Developer options를 찾습니다.

  3. 기기를 인식하도록 시스템을 설정합니다.
    • Windows 환경에서 개발하는 경우, adb용 USB 드라이버를 설치해야 합니다. OEM 드라이버의 설치 지침과 링크는 OEM USB 드라이버 문서를 참조하세요.
    • Mac OS X 환경에서 개발하는 경우, 바로 작동합니다. 이 단계를 건너뜁니다.
    • Ubuntu Linux에서 개발하는 경우, 개발에 사용하고자 하는 각 기기 유형별로 USB 구성을 포함한 udev 규칙 파일을 추가해야 합니다. 규칙 파일에서 각 기기 제조업체는 고유한 공급업체 ID로 식별되고, ATTR{idVendor} 속성으로 지정됩니다. 공급업체 ID 목록은 아래의 USB 공급업체 ID를 참조하세요. Ubuntu Linux에서 기기 인식을 설정하려면:
      1. 루트로 로그인하여 다음 파일을 생성합니다. /etc/udev/rules.d/51-android.rules

        다음 양식을 사용하여 각 공급업체를 파일에 추가합니다.
        SUBSYSTEM=="usb", ATTR{idVendor}=="0bb4", MODE="0666", GROUP="plugdev"

        이 예시에서 공급업체 ID는 HTC를 가리킵니다. MODE 할당은 읽기/쓰기 권한을 지정하며, GROUP은 기기 노드를 소유한 Unix 그룹을 정의합니다.

        참고: 규칙 구문은 사용자의 환경에 따라 약간씩 다를 수 있습니다. 필요한 경우 사용하는 시스템의 udev 문서를 참조하세요. 규칙 구문의 개요를 보려면 이 가이드의 udev 규칙 작성을 참조하세요.

      2. 이제 다음을 실행합니다.
        /etc/udev/rules.d/51-android.rules

참고: Android 4.2.2 이상 버전에서 실행되는 기기를 컴퓨터에 연결하면, 시스템이 이 컴퓨터를 통해 디버깅을 허용하는 RSA 키를 승인할지 묻는 대화상자를 표시합니다. 이 보안 메커니즘은 사용자 기기를 보호하는 역할을 합니다. 사용자가 기기를 잠금 해제하고 대화상자를 승인하지 않으면 USB 디버깅 및 기타 adb 명령어를 실행할 수 없도록 보장하기 때문입니다. 이렇게 하려면 Android 4.2.2 이상 버전에서 실행되는 기기를 디버깅하기 위해 adb 버전 1.0.31(SDK Platform-tools r16.0.1 이상 버전에서 사용 가능)이 있어야 합니다.

USB를 통해 연결된 경우, SDK platform-tools/ 디렉터리에서 adb devices를 실행하여 기기가 연결되었는지 확인할 수 있습니다. 연결된 경우 "기기"로 표시된 기기 이름이 나타납니다.

Android Studio를 사용하는 경우, 평소처럼 애플리케이션을 실행하거나 디버깅합니다. 사용 가능한 에뮬레이터와 연결된 기기 목록이 나열된 Device Chooser 대화상자가 나타납니다. 애플리케이션을 설치하고 실행할 기기를 선택합니다.

Android Debug Bridge(adb)를 사용하는 경우, -d 플래그가 있는 명령을 실행하여 연결된 기기를 대상으로 지정할 수 있습니다.

USB 공급업체 ID

다음 표는 Linux에서 USB 기기 지원을 추가하기 위해 필요한 공급업체 ID의 참조를 제공합니다. 위에 설명된 것처럼 USB 공급업체 ID는 규칙 파일의 ATTR{idVendor} 속성에 지정된 값입니다.

회사USB 제공업체 ID
Acer 0502
ASUS 0b05
Dell 413c
Foxconn 0489
Fujitsu 04c5
FujitsuToshiba 04c5
Garmin-Asus 091e
Google 18d1
Haier 201E
Hisense 109b
HP 03f0
HTC 0bb4
Huawei 12d1
Intel 8087
K-Touch 24e3
KT Tech 2116
Kyocera 0482
Lenovo 17ef
LG 1004
Motorola 22b8
MTK 0e8d
NEC 0409
Nook 2080
Nvidia 0955
OTGV 2257
Pantech 10a9
Pegatron 1d4d
Philips 0471
PMC-Sierra 04da
Qualcomm 05c6
SK Telesys 1f53
Samsung 04e8
Sharp 04dd
Sony 054c
Sony Ericsson 0fce
Sony Mobile Communications 0fce
Teleepoch 2340
Toshiba 0930
ZTE 19d2
This site uses cookies to store your preferences for site-specific language and display options.

Hooray!

This class requires API level or higher

This doc is hidden because your selected API level for the documentation is . You can change the documentation API level with the selector above the left navigation.

For more information about specifying the API level your app requires, read Supporting Different Platform Versions.

Take a one-minute survey?
Help us improve Android tools and documentation.