Skip to content

Most visited

Recently visited

navigation

실행/디버그 구성 생성 및 편집

코드를 실행, 디버그, 테스트할 때 Android Studio는 실행/디버그 구성을 사용하여 작업을 수행할 방법을 결정합니다. 일반적으로 기본 구성으로 충분하고 앱을 간단히 실행/디버그할 수 있습니다. 그러나 개발 과정에 맞게 새로운 구성을 수정/생성하고 기본 템플릿을 수정할 수 있습니다.

실행/디버그 구성 정보

실행/디버그 구성은 앱 설치, 시작, 테스트 옵션 등의 세부 사항을 지정합니다. 일회용으로 구성을 정의하거나 나중에 사용하기 위해 저장할 수 있습니다. 저장한 뒤에는 툴바Select Run/Debug Configuration 드롭다운 목록에서 구성을 선택할 수 있습니다. Android Studio는 프로젝트의 일부로 구성을 저장합니다.

기본 실행/디버그 구성

처음 프로젝트를 생성하면 Android Studio는 Android App 템플릿을 기반으로 메인 액티비티의 기본 실행/디버그 구성을 생성합니다. 프로젝트를 실행/디버그하려면 항상 하나 이상의 실행/디버그 구성을 정의해야 합니다. 그러므로 이 구성은 삭제하지 않는 것이 좋습니다.

프로젝트 범위 및 버전 관리

실행/디버그 구성과 템플릿 변경 사항은 현재 프로젝트에만 적용됩니다. 실행/디버그 구성을 공유하기로 선택하고 프로젝트를 버전 관리 시스템에 체크인하면 프로젝트를 체크아웃하는 사람에게 구성이 공유됩니다. 템플릿은 공유할 수 없습니다.

실행/디버그 구성 대화상자 열기

실행/디버그 구성 대화상자는 실행/디버그 구성과 이용 가능한 기본 템플릿을 표시합니다. 이 대화상자에서는 다음 작업을 수행할 수 있습니다.

이 대화상자를 열려면 다음 단계를 수행하세요.

그림 1과 같이 Run/Debug Configurations 대화상자가 나타납니다.

그림 1. Run/Debug Configurations 대화상자.

왼쪽 창에 대화상자가 Defaults 폴더의 기본 템플릿을 표시합니다. 정의된 구성을 템플릿 유형으로 그룹화합니다. 대화상자 크기를 조정하여 숨겨진 항목을 확인할 수 있습니다.

새로운 실행/디버그 구성 생성

Run/Debug Configurations 대화상자, Project 창 또는 코드 에디터에서 새로운 실행/디버그 구성을 정의할 수 있습니다. 새로운 구성은 기본 템플릿을 기반으로 해야 합니다.

Run/Debug Configurations 대화상자의 템플릿 또는 다른 구성의 사본에서 바로 새로운 구성을 시작할 수 있습니다. 그런 다음 필요에 따라 필드 값을 변경할 수 있습니다.

또는 Project 창의 항목을 마우스 오른쪽 버튼으로 클릭하여 해당 항목에 맞는 구성을 자동으로 생성할 수도 있습니다. 예를 들어 특정 액티비티를 실행하고자 한다면 액티비티 자바 파일을 마우스 오른쪽 버튼으로 클릭하고 Run을 선택합니다. 항목에 따라 Android Studio는 Android App, Android Tests 또는 JUnit 기본 템플릿을 사용하여 구성을 생성합니다.

코드 에디터에서 클래스 또는 메서드에 대한 테스트와 실행/디버그 구성을 쉽게 생성하고, 실행할 수 있습니다.

Run/Debug Configurations 대화상자 밖에서 구성을 생성할 경우 저장하지 않으면 임시 구성이 생성됩니다. 기본적으로 프로젝트에서 5개의 임시 구성을 생성하면 Android Studio가 구성을 제거하기 시작합니다. 이 기본값을 변경하려면 Run/Debug Configurations 대화상자에서 Defaults 폴더를 클릭하고 Temporary Configurations Limit 필드에 값을 입력합니다. 임시 구성에 대한 자세한 내용은 Creating and Saving Temporary Run/Debug Configurations를 참조하세요.

버전 관리 시스템에서 실행/디버그 구성을 공유할 수 있습니다(템플릿은 불가). 실행/디버그 구성에서 Shared를 선택하고 프로젝트를 버전 관리 시스템에 체크인했다면 프로젝트를 체크아웃하는 사람은 누구나 구성을 받을 수 있습니다.

템플릿을 기반으로 구성 시작

템플릿을 기반으로 실행/디버그 구성을 정의하려면 다음 단계를 수행하세요.

  1. Run/Debug Configurations 대화상자를 엽니다.
  2. Add New Configuration을 클릭합니다 .
  3. default template을 선택합니다.
  4. Name 필드에 이름을 입력합니다.
  5. 필요에 따라 구성을 수정합니다.
  6. 대화상자 아래에 표시된 오류가 있으면 수정합니다.

  7. Apply 또는 OK를 클릭합니다.

사본에서 구성 시작

다른 구성의 사본에서 실행/디버그 구성을 정의하려면 다음 단계를 수행하세요.

  1. Run/Debug Configurations 대화상자를 엽니다.
  2. 왼쪽 창에서 기존 실행/디버그 구성을 선택합니다.
  3. Copy Configuration을 클릭합니다 .
  4. Name 필드에 이름을 입력합니다.
  5. 필요에 따라 구성을 수정합니다.
  6. 대화상자 아래에 표시된 오류가 있으면 수정합니다.

  7. Apply 또는 OK를 클릭합니다.

프로젝트 항목의 구성 정의

Android Studio는 Project 창에 표시된 일부 항목의 실행/디버그 구성을 자동으로 생성할 수 있습니다. 구성은 기본 템플릿을 기반으로 합니다.

참고: build.gradle 또는 settings.gradle 파일에서 Android Studio는 Groovy 템플릿을 사용합니다. 대신 Gradle 콘솔을 사용하여 build.gradle 파일을 실행하거나 디버그해야 합니다.

프로젝트 항목의 실행/디버그 구성을 생성하려면 다음 단계를 수행하세요.

  1. Android or Project 뷰에서 프로젝트를 엽니다.
  2. Project 창에서 항목을 마우스 오른쪽 버튼으로 클릭하고 Run 또는 Debug를 선택합니다.
  3. Android Studio가 임시 실행/디버그 구성을 생성하고 앱을 시작합니다.

  4. 구성을 저장하려면 툴바의 Select Run/Debug Configuration 드롭다운 목록에서 Save를 선택합니다.
  5. 예를 들어 드롭다운 목록은 Run Debug 왼쪽에 있습니다 .

    또는 항목을 다시 마우스 오른쪽 버튼으로 클릭하고 Save를 선택합니다.

    Run/Debug Configurations 대화상자에서 구성을 선택하고 왼쪽 위에 있는 Save Configuration 클릭해도 됩니다.

    액티비티를 제외하고 같은 항목을 마우스 오른쪽 버튼으로 클릭하여 실행/디버그할 경우 Android Studio가 새로운 구성을 생성합니다.

클래스 또는 메서드의 테스트 구성 정의

Android Studio에서는 클래스 또는 메서드의 테스트 실행 구성을 정의하고 이를 실행할 수 있습니다. 예를 들어 새로운 클래스를 생성하면 해당 클래스에 대해 테스트를 생성하고 실행할 수 있습니다. 테스트가 통과되면 나머지 프로젝트에도 테스트를 실행하여 새로운 코드의 다른 곳에 이상이 없는지 확인합니다.

Android Studio는 소스 세트에 따라 Android Tests 또는 JUnit 템플릿을 사용합니다. 로컬 유닛 테스트의 경우 코드 범위로 선택적으로 실행할 수 있습니다.

자바 코드에서 클래스 또는 메서드의 실행/디버그 구성을 생성하려면 다음 단계를 수행하세요.

  1. Android or Project 뷰에서 프로젝트를 엽니다.
  2. 코드 에디터에서 자바 파일을 엽니다.
  3. 코드에서 클래스 또는 메서드를 선택하고 Ctrl+Shift+T(⌘⇧T)를 누릅니다.
  4. 여기서 나타나는 메뉴에서 Create New Test를 선택합니다.
  5. Create Test 대화상자에서 선택적으로 필드 값을 변경하고 OK를 클릭합니다.
  6. Choose Destination Directory 대화상자에서 androidTest를 선택하고 계측 테스트를 생성하거나 test를 선택하고 로컬 유닛 테스트를 생성합니다. OK를 클릭합니다.
  7. 새로운 테스트가 해당 테스트 소스 세트의 Project 창에 나타납니다.

  8. 테스트를 실행하려면 다음 단계를 수행하세요.
    • Project 창에서 테스트를 마우스 오른쪽 버튼으로 클릭하고 Run 또는 Debug를 선택합니다.
    • 코드 에디터에서 테스트 파일의 클래스 정의를 마우스 오른쪽 버튼으로 클릭하고 Run 또는 Debug를 선택하여 클래스의 모든 메서드를 테스트합니다.
    • 코드 에디터에서 테스트 파일의 메서드 이름을 마우스 오른쪽 버튼으로 클릭하고 Run 또는 Debug를 선택하여 해당 메서드만 테스트합니다.
    • 코드 에디터에서 클래스 또는 메서드 옆에 있는 왼쪽 여백에서 Play를 클릭하고 Run 또는 Debug를 선택합니다.
  9. 구성을 저장하려면 툴바의 Select Run/Debug Configuration 드롭다운 목록에서 Save를 선택합니다.
  10. 예를 들어 드롭다운 목록은 Run Debug 왼쪽에 있습니다 .

    또는 항목을 다시 마우스 오른쪽 버튼으로 클릭하고 Save를 선택합니다.

    Run/Debug Configurations 대화상자에서 구성을 선택하고 왼쪽 위에 있는 Save Configuration 클릭해도 됩니다.

저장된 구성을 사용하여 앱 실행/디버그

실행/디버그 구성을 저장했다면 앱을 실행/디버그하기 전에 이를 선택할 수 있습니다.

저장된 실행/디버그 구성을 사용하려면 다음 단계를 실행하세요.

  1. 툴바Select Run/Debug Configuration 드롭다운 목록에서 실행/디버그 구성을 선택합니다.
  2. 예를 들어 드롭다운 목록은 Run Debug 왼쪽에 있습니다 .

  3. Run > Run or Run > Debug를 선택합니다.
  4. 아니면 Run 또는 Debug를 클릭합니다 .

참고: Instant Run 세션에서 다른 실행/디버그 구성을 선택하고 Run 또는 Debug 다시 클릭하면 현재 세션이 종료됩니다.

실행/디버그 구성 편집

실행/디버그 구성을 편집하려면 다음 단계를 수행하세요.

  1. Run/Debug Configurations 대화상자를 엽니다.
  2. 왼쪽 창에서 구성을 선택합니다.
  3. 필요에 따라 구성을 수정합니다.
  4. 대화상자 아래에 표시된 오류가 있으면 수정합니다.

  5. Apply 또는 OK를 클릭합니다.

기본 실행/디버그 구성 템플릿 편집

Android Studio가 제공하는 기본 템플릿을 개발 프로세스에 맞게 편집할 수 있습니다. 템플릿을 편집할 때는 템플릿을 사용하는 기존 구성에 영향을 미치지 않습니다. 예를 들어 특정 유형의 구성을 여러 개 생성해야 한다면, 템플릿을 편집하고 작업이 완료되었을 때 다시 변경하면 됩니다.

새로운 템플릿을 생성할 수는 없지만 구성을 생성하여 템플릿과 유사하게 사용할 수는 있습니다. 구성을 복사하고 사본을 편집하여 새로운 구성을 생성할 수도 있습니다.

템플릿을 편집하려면 다음 단계를 수행하세요.

  1. Run/Debug Configurations 대화상자를 엽니다.
  2. Defaults 폴더를 펼치고 default template을 선택합니다.
  3. 필요에 따라 구성을 수정합니다.
  4. 대화상자 아래에 표시된 오류가 있으면 수정합니다.

  5. Apply 또는 OK를 클릭합니다.

구성 정렬 및 그룹화

Run/Debug Configurations 대화상자에서 구성을 쉽게 찾을 수 있도록 정렬할 수 있습니다. 폴더 항목을 알파벳순으로 정렬하고 새 폴더를 생성하여 구성을 그룹화할 수도 있습니다.

구성을 알파벳순으로 정렬하려면 다음 단계를 수행하세요.

  1. Run/Debug Configurations 대화상자를 엽니다.
  2. 구성이 포함된 폴더를 선택합니다.
  3. Sort Configurations를 클릭합니다 .
  4. Apply 또는 OK를 클릭합니다.

폴더에서 구성을 그룹화하려면 다음 단계를 수행하세요.

  1. Run/Debug Configurations 대화상자를 엽니다.
  2. 구성이 포함된 폴더를 선택합니다.
  3. Create New Folder를 클릭합니다 .
  4. Name 필드에 이름을 입력합니다.
  5. 같은 템플릿 카테고리의 항목을 폴더에 끌어놓습니다.
  6. 같은 템플릿 카테고리의 폴더와 구성을 위치로 끌어놓거나 Move Up Move Down을 사용하여 정렬합니다 .
  7. Apply 또는 OK를 클릭합니다.

출시 전 작업 정의

실행/디버그 구성을 적용하기 전에 실행할 작업을 지정할 수 있습니다. 작업은 목록에 나타난 순서대로 실행됩니다. 출시 전 작업 정의는 고급 기능입니다.

이 기능을 사용하는 대신 build.gradle 파일에 준비 로직을 작업으로 넣어서 명령줄에서 빌드 시 실행되도록 하는 것이 좋습니다.

작업 목록을 생성하려면 다음 단계를 실행합니다.

  1. 목록에 작업을 추가하려면 Add를 클릭하고 작업 유형을 선택합니다. 대화상자가 열리면 필드를 작성하고 OK를 클릭합니다.
  2. 필요에 따라 더 많은 작업을 추가합니다.
  3. 작업을 정렬하려면 작업을 선택하고 Up Down을 클릭하여 목록에서 위/아래로 이동시킵니다.
  4. 실행/디버그 구성 설정을 적용 전에 표시하려면 Show this page를 선택합니다.

    이 옵션은 기본적으로 선택이 해제되어 있습니다.

  5. 앱을 실행/디버그할 때 Run 또는 Debug 도구 창이 자동으로 활성화되도록 하려면 Active tool window를 선택합니다.
  6. 이 옵션은 기본적으로 선택되어 있습니다.

목록에서 작업을 제거하려면 다음 단계를 수행하세요.

  1. 작업을 선택합니다.
  2. Remove를 클릭합니다 .

작업을 편집하려면 다음 단계를 수행하세요.

  1. 작업을 선택합니다.
  2. Edit를 클릭합니다 .
  3. 열리는 대화상자에서 작업 설정을 편집하고 OK를 클릭합니다.

다음 표는 추가할 수 있는 작업 목록입니다.

작업 설명
Run External tool Android Studio 외부에 있는 애플리케이션을 실행합니다. External Tools 대화상자에서 실행하려는 애플리케이션을 하나 이상 선택하고 OK를 클릭합니다. 애플리케이션이 아직 Android Studio에 정의되어 있지 않다면 Create Tools 대화상자에 정의를 추가합니다. 자세한 내용은 타사 도구 구성외부 도구를 참조하세요.
Run Another Configuration 기존 실행/디버그 구성 중 하나를 실행합니다. Choose Configuration to Execute 대화상자에서 실행할 구성을 선택하고 OK를 클릭합니다.
Make 프로젝트 또는 모듈을 컴파일합니다. Android Studio는 실행/디버그 구성이 특정 모듈을 지정하면 Make Module 명령을 실행합니다. 지정된 모듈이 없다면 Make Project 명령을 실행합니다.
Make Project 프로젝트를 컴파일합니다. Android Studio가 Make Project 명령을 실행합니다.
Make, no error check 이 옵션은 Make와 동일하지만 Android Studio가 컴파일 결과와 관계없이 실행/디버그 구성을 실행한다는 것에 차이가 있습니다.
Build Artifacts Android Studio에서는 지원되지 않습니다.
Run Gradle task Gradle 작업을 실행합니다. 열리는 대화상자에서 세부 사항을 지정하고 OK를 실행합니다. 자세한 내용은 Gradle을 참조하세요.
Gradle-aware Make 프로젝트를 컴파일하고 Gradle을 실행합니다.
App Engine Gradle builder App Engine Gradle 빌더 작업은 프로젝트를 동기화한 다음 모듈을 빌드합니다.

기본 실행/디버그 구성 템플릿

Android Studio는 빠르게 시작할 수 있는 기본 구성 템플릿을 제공합니다. 다음 템플릿은 Android Studio를 사용한 Android 개발에 적용됩니다.

참고: Android Studio 2.1.x 이하는 네이티브 애플리케이션 템플릿이 있는데 최신 버전에는 이 템플릿이 없습니다. 프로젝트에 네이티브 애플리케이션 템플릿이 있는 경우, 프로젝트를 로드할 때 Android Studio가 이 프로젝트를 자동으로 Android 앱으로 변환합니다. Convert Project 대화상자가 이 과정을 안내합니다.

다음의 지원되지 않는 템플릿은 IntelliJ IDEA에서 온 것으로, Android Studio를 사용한 Android 개발에만 사용되는 것은 아닙니다.

이 템플릿 사용에 대한 자세한 내용은 IntelliJ IDEA 문서 링크를 참조하세요.

Android 앱

이 템플릿에 기초한 구성을 사용하여 가상 기기 또는 하드웨어 기기에서 Android 앱과 액티비티를 실행/디버그할 수 있습니다.

이름 및 공유

실행/디버그 구성에는 NameShare 옵션이 있지만 템플릿에는 없습니다.

필드 설명
Name 실행/디버그 구성의 이름.
Share

이 옵션을 선택하면 버전 관리를 통해 다른 팀원에게 실행/디버그 구성을 제공할 수 있습니다. 실행/디버그 구성은 공유할 수 있지만 템플릿은 불가능합니다. 이 옵션을 선택하면 프로젝트가 Git(또는 다른 버전 관리 시스템)에 체크인되었을 때 누군가 이 프로젝트를 체크아웃하면 실행/디버그 구성이 포함됩니다.

Android Studio는 .idea/runConfigurations 폴더의 개별 XML 파일에 공유된 실행/디버그 구성을 저장합니다. 그렇지 않을 경우 .idea/workspace.xml 파일에 구성을 저장합니다. 자세한 내용은 디렉토리 기반 프로젝트 형식을 참조하세요.

기본값: 선택 취소됨

General 탭

General 탭에서 설치, 시작, 개발 옵션을 지정할 수 있습니다. Miscellaneous 탭에도 설치 옵션이 있습니다.

필드 설명
Module 이 구성을 적용할 모듈을 선택합니다.
설치 옵션: Deploy

옵션 선택:

  • Default APK(기본값) - 빌드 구성에서 지정된 대로 APK를 생성합니다.
  • Custom Artifact - Android Studio에서는 지원되지 않습니다.
  • Nothing - 기기에 APK를 설치하지 않습니다. 예를 들면 APK를 수동으로 설치할 때는 Android Studio를 설치할 필요가 없습니다.
설치 옵션: Install Flags 사용하고자 하는 adb pm install 옵션을 입력합니다. 경로를 제외하고 명령줄에 사용하는 것처럼 옵션 서식을 지정합니다. 예시:

-i foo.bar.baz -r /path/to/apk

-d -r

기본값: 옵션 없음

시작 옵션: Launch

옵션 선택:

  • Nothing - 아무것도 시작하지 않습니다. Deploy 필드에 Nothing 옵션을 지정한 뒤에 앱이 이미 실행되는 상태에서 Debug를 선택할 경우, 이 옵션은 Attach debugger to Android process를 사용하는 것과 유사합니다. Run을 선택하더라도 아무 작업도 실행되지 않습니다.
  • Default Activity(기본값) - 매니페스트에서 시작으로 표시한 액티비티를 시작합니다. 예:
  • <intent-filter>
      <action android:name="android.intent.action.MAIN" />
      <category android:name="android.intent.category.LAUNCHER" />
    </intent-filter>
    
  • Specified Activity - 모듈에서 특정 앱 액티비티를 시작합니다. 이름을 입력하거나 를 클릭하여 목록에서 액티비티를 선택합니다.
  • URL - 시작할 URL을 지정합니다. URL 테스트를 참조하세요.
시작 옵션: Launch Flags 사용하고자 하는 adb am start 옵션을 입력합니다. 인텐트를 제외하고 명령줄에 사용하는 것처럼 옵션 서식을 지정합니다. 예:

-W

이 옵션은 NothingLaunch 값을 선택하면 나타나지 않습니다.

기본값: 옵션 없음

배포 대상 옵션: Target

옵션 선택:

  • Open Select Deployment Target Dialog(기본값) - Select Deployment Target 대화상자를 열어서 가상 또는 하드웨어 기기를 선택합니다.
  • USB Device - USB 포트를 통해 개발 컴퓨터에 연결된 하드웨어 기기를 사용합니다. 기기가 2개 이상이면 선택할 수 있는 대화상자가 나타납니다.
  • Emulator - 가상 기기를 사용합니다. 구성에서 AVD를 선택할 수 있습니다. 그렇지 않으면 목록에 있는 첫 번째 AVD를 사용합니다.

배포 대상 옵션: Use same device for future launches

앞으로 Select Deployment Target 대화상자에서 선택한 기기를 자동으로 사용하려면 이 옵션을 선택합니다. 이 기기를 사용할 수 없을 경우 대화상자가 나타납니다. 기본값: 선택 취소됨
Before Launch 출시 전 작업 정의를 참조하세요.

Miscellaneous 탭

Miscellaneous 탭에서 logcat, 설치, 시작 및 배포 옵션을 선택할 수 있습니다. General 탭에도 설치 옵션이 있습니다.

필드 설명
Logcat: Show logcat automatically 이 옵션을 선택하면 이 구성을 사용해서 앱을 배포 및 시작할 때마다 Android Monitorlogcat 탭이 자동 활성화됩니다. 그렇지 않을 경우, 앱 시작 시 포커스가 logcat 탭으로 자동 이동하지 않습니다. 기본값: 선택됨
Logcat: Clear log before launch 앱을 시작하기 전에 Android Studio가 로그 파일에서 이전 세션 데이터를 삭제하도록 하려면 이 옵션을 선택합니다. 기본값: 선택 취소됨
설치 옵션: Skip installation if APK has not changed 이 옵션을 선택하면 Android Studio가 변경 사항이 없는 것을 확인할 경우 APK를 재배포하지 않습니다. 변경 사항이 없어도 Android Studio가 강제로 APK를 설치하게 하려면 이 옵션의 선택을 취소하세요. 기본값: 선택됨
설치 옵션: Force stop running application before launching activity

이 옵션을 선택하면 Android Studio가 변경 사항이 없어서 APK를 다시 설치할 필요가 없다는 것을 확인할 경우, 앱이 기본 런처 액티비티에서 시작되도록 앱을 강제 중단합니다. 이 옵션의 선택을 취소하면 Android Studio가 앱을 강제 중단하지 않습니다.

이 옵션은 APK 설치를 제어하는 이전의 옵션과 함께 작동합니다. 매번 강제 설치를 원하는 것이 아니라면 Installation Options 필드 두 개는 기본값으로 남겨둡니다.

경우에 따라 이 옵션의 선택을 취소해야 할 경우도 있습니다. 예를 들어 IME(Input Method Engine)를 작성 중인 경우, 앱을 강제로 중단하면 현재 키보드로 이 옵션을 선택 취소하는데 이러한 상황을 원치 않을 수도 있습니다.

기본값: 선택됨

Before Launch 출시 전 작업 정의를 참조하세요.

Debugger 탭

Debugger 탭에서 디버그 옵션을 지정합니다.

C 및 C++ 코드의 경우 Android Studio는 LLDB 디버거를 사용합니다. 일반적인 Android Studio UI 외에, 디버거 창에는 디버깅 중에 LLDB 명령을 입력할 수 있는 LLDB 탭이 있습니다. Android Studio가 디버거 UI에 정보를 표시하기 위해 사용하는 동일한 명령을 입력하고 추가 작업을 수행할 수 있습니다.

C 및 C++ 프로젝트의 경우 Debugger 탭에서 기호 디렉토리는 물론이고 LLDB 시작 및 게시/첨부 명령을 추가할 수 있습니다. 이 작업을 수행하려면 다음과 유사한 버튼을 사용합니다.

Android Studio에서 디버깅에 대한 자세한 정보는 앱 디버그를 참조하세요.

필드 설명
Debug type

다음 옵션 중 하나를 선택합니다.

  • Auto(기본값) - Android Studio가 개발자의 프로젝트에 가장 적합한 디버그 유형을 자동으로 선택해 줍니다.
  • Java - 자바 코드만 디버그합니다.
  • Native - 네이티브 C 또는 C++ 코드를 디버그합니다.
  • Hybrid - 두 개의 별개 디버그 세션에서 자바 및 네이티브 코드를 디버그합니다.

Auto 옵션을 선택하면 프로젝트에 적합한 디버그 유형을 자동으로 선택해 주므로 이 옵션을 선택하는 것이 좋습니다.

Experimental: Use Java aware C++ debugger - Android N+ only

동일한 LLDB 디버그 세션 내에서 C++ 및 자바 Android 코드를 디버그하려면 이 옵션을 선택합니다. 자바 인식 C++ 디버거는 Native 디버거 모드의 확장으로, C++ 디버깅과 함께 자바도 지원합니다.

이 기능을 사용하려면 프로젝트가

  • Android 7.0(API 레벨 24) 이상만 사용해야 합니다.
  • Debug typeNative 또는 Auto여야 합니다.

Debug type으로 Auto를 선택한 경우 Android Studio는 프로젝트가 요구사항을 충족하는 경우 자동으로 이 옵션을 선택합니다. 참고로, 자바 전용 프로젝트가 있고 LLDB를 사용하여 이 프로젝트를 디버그하려는 경우 이 옵션과 Native를 선택할 수 있습니다.

Android Studio 2.2 기준으로 현재 이 기능은 시험용입니다. 자세한 정보는 시험용 자바 인식 C++ 디버거 사용을 참조하세요.

기본값: 선택 취소됨

Symbol Directories

Android Studio 외부에서 생성된 C 또는 C++ 정보를 디버거에 제공하기 위한 기호 파일을 추가하려는 경우 여기서 하나 이상의 디렉토리를 추가할 수 있습니다. Android Studio는 Gradle용 Android 플러그인에서 생성되는 파일보다 이러한 디렉토리에 있는 파일을 우선적으로 사용합니다. 디버거는 필요한 것을 찾을 때까지 디렉토리를 위에서 아래로 순서대로 검색합니다. 디렉토리에 있는 파일을 재귀적으로 검색합니다. 목록을 최적화하고 시간을 절약하려면 가장 자주 사용하는 디렉토리를 목록 맨 위에 두세요.

트리에서 상위 수준에 있는 디렉토리를 지정하면 그에 속한 모든 하위 디렉토리를 검색하느라 더 오래 걸릴 수 있습니다. 매우 구체적으로 특정된 디렉토리를 추가하면 검색 시간이 덜 걸립니다. 속도와 디버깅에 필요한 파일을 찾아내는 것 사이에서 적절한 균형점을 찾을 필요가 있습니다. 예를 들어, 다양한 ABI(Android Binary Interface)에 대한 하위 디렉토리를 포함하는 디렉토리가 있는 경우, 특정 ABI 또는 모든 ABI에 대한 디렉토리를 추가하도록 선택할 수 있습니다. 상위 수준 디렉토리를 검색하는 데 더 오래 걸릴 수 있지만, 다른 기기에서 디버그하기로 결정하는 경우에는 그것이 더 확실하고 간단한 방법이기도 합니다.

디버거가 Gradle 기호 파일을 포함한 디렉토리를 자동으로 사용하므로 이러한 디렉토리를 추가할 필요는 없습니다.

LLDB Startup Commands

디버거가 프로세스에 연결하기 전에 실행하고 싶은 LLDB 명령을 추가합니다. 예를 들어, 다음 명령에 나오는 것처럼 환경에 적합한 설정을 정의할 수 있습니다.

settings set target.max-memory-read-size 2048

LLDB는 위에서 아래로 순서대로 명령을 실행합니다.

LLDB Post Attach Commands

디버거가 프로세스에 연결한 직후에 실행하고 싶은 LLDB 명령을 추가합니다. 예:

process handle SIGPIPE -n true -p true -s false

LLDB는 위에서 아래로 순서대로 명령을 실행합니다.

Host working directory LLDB 작업 디렉토리를 지정합니다.
Logging: Target channels

LLDB 로그 옵션을 지정합니다. Android Studio는 개발팀의 경험을 바탕으로 기본 옵션을 설정하므로 그다지 느리지 않지만 문제해결에 필요한 정보가 있습니다. Android Studio 버그 보고서를 위해 종종 로그가 요청됩니다. 기본값은 다음과 같습니다.

lldb process:gdb-remote packets

기본값을 변경하여 더 많은 정보를 수집할 수 있습니다. 예를 들어, 다음 로그 옵션으로 특정 platform에 대한 정보를 수집할 수 있습니다.

lldb process platform:gdb-remote packets

로그 명령의 전체 목록을 보려면 Android Studio의 LLDB 셸 창에서 log list 명령을 입력하세요.

Android Studio에서는 다음 위치에 기기 로그가 저장되는데, 여기서 ApplicationId는 빌드된 APK 매니페스트에 사용되는 고유한 애플리케이션 ID로, 이 ID를 사용해 기기와 Google Play Store에서 앱을 식별합니다.

/data/data/ApplicationId/lldb/log

또는 여러 사용자가 한 기기에 액세스하는 경우에는 로그가 다음 위치에 저장됩니다. 여기서 AndroidUserId는 기기에서 각 사용자의 고유 식별자입니다.

/data/user/AndroidUserId/ApplicationId/lldb/log

원격 디버깅을 위해 LLDB를 사용하는 자세한 방법은 원격 디버깅을 참조하세요.

Before Launch 출시 전 작업 정의를 참조하세요.

Profiling 탭

Profiling 탭에서 Android Monitor에 대한 GPU Debugger 프로파일링 옵션을 지정합니다.

필드 설명
Graphics Trace Options: Capture GPU Commands

활성화된 경우 이 실행/디버그 구성을 실행하면 GPU 추적으로 앱이 빌드, 설치 및 실행됩니다. 앱을 디버그할 때는 추적 기능이 지원되지 않습니다. GPU 추적 기능으로 앱을 디버그하면 메시지가 나타나고 디버거가 추적 없이 실행됩니다. 이 옵션은 GPU Debugger 도구에 적합합니다.

이 확인란을 선택한 후에는 앱을 실행할 때마다 앱 실행이 차단되고 디버거나 GPU Debugger를 연결할 때까지 대기 상태로 남습니다.

Graphics Trace Options: Disable precompiled shaders and programs

추적 중에 사전 컴파일된 셰이더 및 프로그램 바이너리에 대한 OpenGL ES 그래픽 드라이버 지원을 비활성화하려면 이 옵션을 선택합니다. 이 옵션은 GPU Debugger 도구에 적합합니다.

사전 컴파일된 셰이더는 추적 재생용으로 지원되지 않으므로 glShaderSource 함수를 사용하여 런타임에 컴파일된 셰이더만 프레임버퍼 검사에 사용할 수 있습니다.

앱은 항상 사전 컴파일된 셰이더 지원 여부를 쿼리한 후 glShaderBinary 또는 glProgramBinary 함수를 사용해야 하고, 사전 컴파일된 셰이더 또는 프로그램이 지원되지 않는 경우 런타임 컴파일로 대체해야 합니다.

기본값: 선택 취소됨

Before Launch 출시 전 작업 정의를 참조하세요.

Android Tests

사용해야 하는 테스트 템플릿은 소스 세트에 따라 달라집니다. Android Tests 템플릿은 계측 테스트에 사용됩니다. JUnit 템플릿은 로컬 유닛 테스트에 사용됩니다.

Firebase Test Lab으로 다양한 기기를 테스트 중이라면 이 템플릿을 사용하여 계측된 테스트를 정의할 수 있습니다. 자세한 내용은 Firebase Test Lab으로 테스트 실행을 참조하세요.

이름 및 공유

실행/디버그 구성에는 NameShare 옵션이 있지만 템플릿에는 없습니다.

필드 설명
Name 실행/디버그 구성의 이름.
Share

이 옵션을 선택하면 버전 관리를 통해 다른 팀원에게 실행/디버그 구성을 제공할 수 있습니다. 실행/디버그 구성은 공유할 수 있지만 템플릿은 불가능합니다. 이 옵션을 선택하면 프로젝트가 Git(또는 다른 버전 관리 시스템)에 체크인되었을 때 누군가 이 프로젝트를 체크아웃하면 실행/디버그 구성이 포함됩니다.

Android Studio는 .idea/runConfigurations 폴더의 개별 XML 파일에 공유된 실행/디버그 구성을 저장합니다. 그렇지 않을 경우 .idea/workspace.xml 파일에 구성을 저장합니다. 자세한 내용은 디렉토리 기반 프로젝트 형식을 참조하세요.

기본값: 선택 취소됨

General 탭

General 탭에서 테스트 위치, 계측 실행기, adb 셸, 배포 옵션을 지정할 수 있습니다.

필드 설명
Module 이 구성을 적용할 모듈을 선택합니다.
테스트

이 영역에서는 실행할 테스트의 위치를 지정합니다.

  • All in module(기본값) - 선택된 모듈에서 모든 테스트를 실행합니다.
  • All in package - Package 필드에서 지정한 패키지에서 모든 테스트를 실행합니다. 이름을 입력하거나 를 클릭하여 대화상자에서 패키지를 선택합니다.
  • Class - Class 필드에서 지정한 클래스의 테스트를 실행합니다. 이름을 입력하거나 를 클릭하여 대화상자에서 클래스를 선택합니다.
  • Method - 테스트 메서드를 실행합니다. Class 필드에서 메서드가 포함된 클래스를 지정합니다. Method 필드에서 메서드를 지정합니다. 이름을 입력하거나 를 클릭하여 대화상자에서 클래스 또는 메서드를 선택합니다.
Specific instrumentation runner(선택 항목) 계측 실행기 위치를 입력하고 를 클릭하여 대화상자를 사용합니다. build.gradle 파일이 계측 실행기 위치를 지정하는데, 이 값이 해당 위치를 재정의합니다. 일반적으로 기본값은 Android Testing 지원 라이브러리AndroidJUnitRunner 클래스입니다.
추가 옵션 사용하고자 하는 adb am instrument 옵션을 입력합니다. 구성 요소는 입력하지 않습니다. 예를 들어 Android Testing 지원 라이브러리AndroidJUnitRunner를 사용하고 있다면 이 필드로 실행기에 추가 옵션(예: -e size small)을 전달할 수 있습니다. 기본값: 옵션 없음
배포 대상 옵션: Target

옵션 선택:

  • Open Select Deployment Target Dialog(기본값) - Select Deployment Target 대화상자를 열어서 가상 또는 하드웨어 기기를 선택합니다.
  • USB Device - USB 포트를 통해 개발 컴퓨터에 연결된 하드웨어 기기를 사용합니다. 기기가 2개 이상이면 선택할 수 있는 대화상자가 나타납니다.
  • Emulator - 가상 기기를 사용합니다. 구성에서 AVD를 선택할 수 있습니다. 그렇지 않으면 목록에 있는 첫 번째 AVD를 사용합니다.
  • Firebase Test Lab Device Matrix - Firebase Test Lab으로 테스트 실행을 참조하세요.
배포 대상 옵션: Use same device for future launches 앞으로 Select Deployment Target 대화상자에서 선택한 기기를 자동으로 사용하려면 이 옵션을 선택합니다. 이 기기를 사용할 수 없을 경우 대화상자가 나타납니다. 기본값: 선택 취소됨
Before Launch 출시 전 작업 정의를 참조하세요.

Miscellaneous 탭

Miscellaneous 탭에는 logcat과 설치 옵션이 있습니다.

필드 설명
Logcat: Clear log before launch 앱을 시작하기 전에 로그 파일에서 이전 세션 데이터를 제거하려면 이 옵션을 선택합니다. 기본값: 선택 취소됨
설치 옵션: Skip installation if APK has not changed 이 옵션을 선택하면 Android Studio가 변경 사항이 없는 것을 확인할 경우 APK를 재배포하지 않습니다. 변경 사항이 없어도 Android Studio가 강제로 APK를 설치하게 하려면 이 옵션의 선택을 취소하세요. 기본값: 선택됨
설치 옵션: Force stop running application before launching activity

이 옵션을 선택하면 Android Studio가 변경 사항이 없어서 APK를 다시 설치할 필요가 없다는 것을 확인할 경우, 앱이 기본 런처 액티비티에서 시작되도록 앱을 강제 중단합니다. 이 옵션의 선택을 취소하면 Android Studio가 앱을 강제 중단하지 않습니다.

이 옵션은 APK 설치를 제어하는 이전의 옵션과 함께 작동합니다. 매번 강제 설치를 원하는 것이 아니라면 Installation Options 필드 두 개는 기본값으로 남겨둡니다.

경우에 따라 이 옵션의 선택을 취소해야 할 경우도 있습니다. 예를 들어 IME(Input Method Engine)를 작성 중인 경우, 앱을 강제로 중단하면 현재 키보드로 이 옵션을 선택 취소하는데 이러한 상황을 원치 않을 수도 있습니다.

기본값: 선택됨

Before Launch 출시 전 작업 정의를 참조하세요.

Debugger 탭

Debugger 탭에서 디버그 옵션을 지정합니다.

C 및 C++ 코드의 경우 Android Studio는 LLDB 디버거를 사용합니다. 일반적인 Android Studio UI 외에, 디버거 창에는 디버깅 중에 LLDB 명령을 입력할 수 있는 LLDB 탭이 있습니다. Android Studio가 디버거 UI에 정보를 표시하기 위해 사용하는 동일한 명령을 입력하고 추가 작업을 수행할 수 있습니다.

C 및 C++ 프로젝트의 경우 Debugger 탭에서 기호 디렉토리는 물론이고 LLDB 시작 및 게시/첨부 명령을 추가할 수 있습니다. 이 작업을 수행하려면 다음과 유사한 버튼을 사용합니다.

Android Studio에서 디버깅에 대한 자세한 정보는 앱 디버그를 참조하세요.

필드 설명
Debug type

다음 옵션 중 하나를 선택합니다.

  • Auto(기본값) - Android Studio가 개발자의 프로젝트에 가장 적합한 디버그 유형을 자동으로 선택해 줍니다.
  • Java - 자바 코드만 디버그합니다.
  • Native - 네이티브 C 또는 C++ 코드를 디버그합니다.
  • Hybrid - 두 개의 별개 디버그 세션에서 자바 및 네이티브 코드를 디버그합니다.

Auto 옵션을 선택하면 프로젝트에 적합한 디버그 유형을 자동으로 선택해 주므로 이 옵션을 선택하는 것이 좋습니다.

Experimental: Use Java aware C++ debugger - Android N+ only

동일한 LLDB 디버그 세션 내에서 C++ 및 자바 Android 코드를 디버그하려면 이 옵션을 선택합니다. 자바 인식 C++ 디버거는 Native 디버거 모드의 확장으로, C++ 디버깅과 함께 자바도 지원합니다.

이 기능을 사용하려면 프로젝트가

  • Android 7.0(API 레벨 24) 이상만 사용해야 합니다.
  • Debug typeNative 또는 Auto여야 합니다.

Debug type으로 Auto를 선택한 경우 Android Studio는 프로젝트가 요구사항을 충족하는 경우 자동으로 이 옵션을 선택합니다. 참고로, 자바 전용 프로젝트가 있고 LLDB를 사용하여 이 프로젝트를 디버그하려는 경우 이 옵션과 Native를 선택할 수 있습니다.

Android Studio 2.2 기준으로 현재 이 기능은 시험용입니다. 자세한 정보는 시험용 자바 인식 C++ 디버거 사용을 참조하세요.

기본값: 선택 취소됨

Symbol Directories

Android Studio 외부에서 생성된 C 또는 C++ 정보를 디버거에 제공하기 위한 기호 파일을 추가하려는 경우 여기서 하나 이상의 디렉토리를 추가할 수 있습니다. Android Studio는 Gradle용 Android 플러그인에서 생성되는 파일보다 이러한 디렉토리에 있는 파일을 우선적으로 사용합니다. 디버거는 필요한 것을 찾을 때까지 디렉토리를 위에서 아래로 순서대로 검색합니다. 디렉토리에 있는 파일을 재귀적으로 검색합니다. 목록을 최적화하고 시간을 절약하려면 가장 자주 사용하는 디렉토리를 목록 맨 위에 두세요.

트리에서 상위 수준에 있는 디렉토리를 지정하면 그에 속한 모든 하위 디렉토리를 검색하느라 더 오래 걸릴 수 있습니다. 매우 구체적으로 특정된 디렉토리를 추가하면 검색 시간이 덜 걸립니다. 속도와 디버깅에 필요한 파일을 찾아내는 것 사이에서 적절한 균형점을 찾을 필요가 있습니다. 예를 들어, 다양한 ABI(Android Binary Interface)에 대한 하위 디렉토리를 포함하는 디렉토리가 있는 경우, 특정 ABI 또는 모든 ABI에 대한 디렉토리를 추가하도록 선택할 수 있습니다. 상위 수준 디렉토리를 검색하는 데 더 오래 걸릴 수 있지만, 다른 기기에서 디버그하기로 결정하는 경우에는 그것이 더 확실하고 간단한 방법이기도 합니다.

디버거가 Gradle 기호 파일을 포함한 디렉토리를 자동으로 사용하므로 이러한 디렉토리를 추가할 필요는 없습니다.

LLDB Startup Commands

디버거가 프로세스에 연결하기 전에 실행하고 싶은 LLDB 명령을 추가합니다. 예를 들어, 다음 명령에 나오는 것처럼 환경에 적합한 설정을 정의할 수 있습니다.

settings set target.max-memory-read-size 2048

LLDB는 위에서 아래로 순서대로 명령을 실행합니다.

LLDB Post Attach Commands

디버거가 프로세스에 연결한 직후에 실행하고 싶은 LLDB 명령을 추가합니다. 예:

process handle SIGPIPE -n true -p true -s false

LLDB는 위에서 아래로 순서대로 명령을 실행합니다.

Host working directory LLDB 작업 디렉토리를 지정합니다.
Logging: Target channels

LLDB 로그 옵션을 지정합니다. Android Studio는 개발팀의 경험을 바탕으로 기본 옵션을 설정하므로 그다지 느리지 않지만 문제해결에 필요한 정보가 있습니다. Android Studio 버그 보고서를 위해 종종 로그가 요청됩니다. 기본값은 다음과 같습니다.

lldb process:gdb-remote packets

기본값을 변경하여 더 많은 정보를 수집할 수 있습니다. 예를 들어, 다음 로그 옵션으로 특정 platform에 대한 정보를 수집할 수 있습니다.

lldb process platform:gdb-remote packets

로그 명령의 전체 목록을 보려면 Android Studio의 LLDB 셸 창에서 log list 명령을 입력하세요.

Android Studio에서는 다음 위치에 기기 로그가 저장되는데, 여기서 ApplicationId는 빌드된 APK 매니페스트에 사용되는 고유한 애플리케이션 ID로, 이 ID를 사용해 기기와 Google Play Store에서 앱을 식별합니다.

/data/data/ApplicationId/lldb/log

또는 여러 사용자가 한 기기에 액세스하는 경우에는 로그가 다음 위치에 저장됩니다. 여기서 AndroidUserId는 기기에서 각 사용자의 고유 식별자입니다.

/data/user/AndroidUserId/ApplicationId/lldb/log

원격 디버깅을 위해 LLDB를 사용하는 자세한 방법은 원격 디버깅을 참조하세요.

Before Launch 출시 전 작업 정의를 참조하세요.

Profiling 탭

Profiling 탭에서 Android Monitor에 대한 GPU Debugger 프로파일링 옵션을 지정합니다.

필드 설명
Graphics Trace Options: Capture GPU Commands

활성화된 경우 이 실행/디버그 구성을 실행하면 GPU 추적으로 앱이 빌드, 설치 및 실행됩니다. 앱을 디버그할 때는 추적 기능이 지원되지 않습니다. GPU 추적 기능으로 앱을 디버그하면 메시지가 나타나고 디버거가 추적 없이 실행됩니다. 이 옵션은 GPU Debugger 도구에 적합합니다.

이 확인란을 선택한 후에는 앱을 실행할 때마다 앱 실행이 차단되고 디버거나 GPU Debugger를 연결할 때까지 대기 상태로 남습니다.

Graphics Trace Options: Disable precompiled shaders and programs

추적 중에 사전 컴파일된 셰이더 및 프로그램 바이너리에 대한 OpenGL ES 그래픽 드라이버 지원을 비활성화하려면 이 옵션을 선택합니다. 이 옵션은 GPU Debugger 도구에 적합합니다.

사전 컴파일된 셰이더는 추적 재생용으로 지원되지 않으므로 glShaderSource 함수를 사용하여 런타임에 컴파일된 셰이더만 프레임버퍼 검사에 사용할 수 있습니다.

앱은 항상 사전 컴파일된 셰이더 지원 여부를 쿼리한 후 glShaderBinary 또는 glProgramBinary 함수를 사용해야 하고, 사전 컴파일된 셰이더 또는 프로그램이 지원되지 않는 경우 런타임 컴파일로 대체해야 합니다.

기본값: 선택 취소됨

Before Launch 출시 전 작업 정의를 참조하세요.

App Engine DevAppServer

이 실행/디버그 구성은 Google Cloud Platform에 적용됩니다. 자세한 내용은 App Engine 자바 서블릿 모듈 추가백엔드 실행, 테스트 및 배포를 참조하세요. 이 단계를 수행하고 프로젝트를 build.gradle 파일에 동기화하면 Android Studio가 App Engine DevAppServer 구성을 생성합니다.

IntellJ IDEA App Engine Server 템플릿은 Android Studio에서 사용할 수 없는 다른 템플릿입니다.

필드 설명
Name 실행/디버그 구성의 이름.
Share

이 옵션을 선택하면 버전 관리를 통해 다른 팀원에게 실행/디버그 구성을 제공할 수 있습니다. 실행/디버그 구성은 공유할 수 있지만 템플릿은 불가능합니다. 이 옵션을 선택하면 프로젝트가 Git(또는 다른 버전 관리 시스템)에 체크인되었을 때 누군가 이 프로젝트를 체크아웃하면 실행/디버그 구성이 포함됩니다.

Android Studio는 .idea/runConfigurations 폴더의 개별 XML 파일에 공유된 실행/디버그 구성을 저장합니다. 그렇지 않을 경우 .idea/workspace.xml 파일에 구성을 저장합니다. 자세한 내용은 디렉토리 기반 프로젝트 형식을 참조하세요.

기본값: 선택 취소됨

Single instance only 한 번에 실행/디버그 구성의 인스턴스 하나만 실행하려면 이 옵션을 선택합니다. 동시에 같은 구성을 여러 개 실행할 수 없습니다. 기본값: 선택됨
Module 이 구성을 적용할 모듈을 선택합니다.
Synchronize with build.gradle configuration App Engine 모듈을 추가하고 build.gradle 파일에 동기화하면 App Engine DevAppServer 구성 필드가 채워집니다(권장). Tools > Android > Sync Project with Gradle Files를 선택해도 프로젝트가 동기화됩니다. 기본값: 선택됨
App Engine SDK 로컬 컴퓨터에서 자바용 Google App Engine SDK 경로를 입력합니다. ...를 클릭하여 대화상자에서 선택합니다.
War Path 로컬 개발 서버에 배포한 앱의 WAR(Web Application Archive) 디렉토리 경로를 입력합니다. ...를 클릭하여 대화상자에서 선택합니다.
VM Args

DevAppServer를 시작하기 위해 VM에 전달할 명령줄 옵션을 지정합니다. 옵션 지정 시:

  • 공백을 사용하여 여러 옵션을 구분합니다.
  • 공백이 있는 옵션은 공백을 따옴표(" ")로 묶습니다.
  • 옵션에 따옴표가 있다면 따옴표 앞에 백슬래시(\")를 추가합니다.

VM 옵션에 대한 자세한 내용은 J2SE 버전 문서(예: java JDK 7java JDK 8)를 참조하세요.

기본값: 옵션 없음

Server Address 서버로 사용할 호스트 주소를 입력합니다. 네트워크상의 다른 컴퓨터에서 개발 서버에 액세스하려면 주소를 입력해야 할 수도 있습니다. 0.0.0.0 주소를 입력하면 로컬호스트 액세스와 호스트 이름 액세스가 모두 가능합니다. 기본값: localhost
Server Port 서버로 사용할 포트 번호를 입력합니다. 기본값: 8080
Disable Check for App Engine SDK Updates 이 옵션을 선택하면 개발 서버가 새로운 SDK 릴리스가 있는지 확인할 때 App Engine에 연결하지 않습니다. 기본적으로 서버는 시작 시 새 버전을 검사하고 새로운 버전이 있으면 메시지를 출력합니다.
Before Launch 출시 전 작업 정의를 참조하세요.
This site uses cookies to store your preferences for site-specific language and display options.

Get the latest Android developer news and tips that will help you find success on Google Play.

* Required Fields

Hooray!

Browse this site in ?

You requested a page in , but your language preference for this site is .

Would you like to change your language preference and browse this site in ? If you want to change your language preference later, use the language menu at the bottom of each page.

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 short survey?
Help us improve the Android developer experience.
(Sep 2017 survey)