지원 라이브러리 설정

개발 프로젝트에서 Android 지원 라이브러리를 설정하는 방법은 사용할 기능과 애플리케이션을 사용하여 지원할 Android 플랫폼 버전 범위에 따라 다릅니다.

이 문서에서는 지원 라이브러리 패키지를 다운로드하고 개발 환경에 라이브러리를 추가하는 과정을 안내합니다.

지원 라이브러리 다운로드

Android Support Repository 패키지는 Android SDK의 추가 다운로드로 제공되며 Android SDK Manager를 통해 사용할 수 있습니다. 지원 라이브러리 파일을 가져오려면 아래 지침을 따르세요.

SDK Manager를 통해 지원 라이브러리를 다운로드하려면:

  1. Android SDK Manager를 시작합니다.
  2. SDK Manager 창에서 Packages 목록의 끝으로 스크롤하고 Extras 폴더를 찾고, 필요한 경우 확장하여 내용물을 봅니다.
  3. Android Support Repository 항목을 선택합니다.
  4. Install packages... 버튼을 클릭합니다.

그림 1. Android SDK Manager에서 Android Support Repository를 선택한 경우

다운로드한 후에 해당 도구가 지원 라이브러리 파일을 기존 Android SDK 디렉터리에 설치합니다. 라이브러리 파일은 SDK의 하위 디렉터리(<sdk>/extras/android/m2repository/com/android/support/ 디렉터리)에 있습니다.

지원 라이브러리 선택

지원 라이브러리를 애플리케이션에 추가하기 전에 포함할 기능과 지원할 최하 Android 버전을 결정하세요. 다른 라이브러리가 제공하는 기능에 대한 자세한 내용은 지원 라이브러리 기능을 참조하세요.

지원 라이브러리 추가

지원 라이브러리를 사용하려면 개발 환경 내에서 애플리케이션 프로젝트의 클래스 경로 종속성을 수정해야 합니다. 사용할 각 지원 라이브러리에 대해 이 절차를 수행해야 합니다.

지원 라이브러리를 애플리케이션 프로젝트에 추가하려면:

  1. SDK Manager를 사용하여 Android Support Repository를 다운로드했는지 확인합니다.
  2. 애플리케이션에 대한 build.gradle 파일을 엽니다.
  3. 지원 라이브러리를 dependencies 섹션에 추가합니다. 예를 들어, v4 core-utils 라이브러리를 추가하려면 다음 줄을 추가합니다.
    dependencies {
        ...
        compile "com.android.support:support-core-utils:24.2.0"
    }
    

주의: 동적 종속성을 사용하면(예: palette-v7:23.0.+) 예기치 않은 버전 업데이트와 이전 버전과의 비호환성이 발생할 수 있습니다. 라이브러리 버전(예: palette-v7:24.2.0)을 명시적으로 지정하는 것이 좋습니다.

지원 라이브러리 API 사용

기존 프레임워크 API를 지원하는 지원 라이브러리 클래스는 일반적으로 프레임워크 클래스와 이름이 같지만 android.support 클래스 패키지에 있거나 접미사가 *Compat입니다.

주의: 지원 라이브러리의 클래스를 사용하는 경우 적절한 패키지에서 클래스를 가져와야 합니다. 예를 들어, ActionBar 클래스를 적용하는 경우 다음을 사용합니다.

  • 지원 라이브러리를 사용하는 경우 android.support.v7.app.ActionBar
  • API 레벨 11 이상용으로만 개발 중인 경우 android.app.ActionBar

참고: 애플리케이션 프로젝트에 지원 라이브러리를 포함한 후에는 ProGuard 도구를 사용하여 애플리케이션 APK 릴리스를 준비하는 것이 좋습니다. ProGuard 도구는 소스 코드를 보호할 뿐만 아니라, 애플리케이션에 포함한 라이브러리에서 사용되지 않는 클래스를 제거하여 애플리케이션의 다운로드 크기를 가급적 작게 유지합니다. 자세한 내용은 ProGuard를 참조하세요.

몇몇 지원 라이브러리 기능 사용에 대한 추가 안내는 Android 개발자 교육 클래스, 가이드 및 샘플에서 제공합니다. 개별 지원 라이브러리 클래스 및 메서드에 대한 자세한 내용은 API 참조에서 android.support 패키지를 참조하세요.

매니페스트 선언 변경

지원 라이브러리를 사용하여 기존 애플리케이션과 Android API 이전 버전과의 호환성을 높이려면 애플리케이션 매니페스트를 업데이트해야 합니다. 특히, 아래와 같이 매니페스트에서 <uses-sdk> 태그의 android:minSdkVersion 요소를 새로운 하위 버전 번호로 업데이트해야 합니다.

  <uses-sdk
      android:minSdkVersion="14"
      android:targetSdkVersion="23" />

이 매니페스트 설정은 애플리케이션이 Android 4.0(API 레벨 14) 이상 기기에 설치될 수 있음을 Google Play에 알립니다.

Gradle 빌드 파일을 사용하는 경우 빌드 파일의 minSdkVersion 설정이 매니페스트 설정보다 우선합니다.

apply plugin: 'com.android.application'

android {
    ...

    defaultConfig {
        minSdkVersion 16
        ...
    }
    ...
}

이 경우 빌드 파일 설정은 애플리케이션의 기본 빌드 변형이 Android 4.1(API 레벨 16) 이상 기기에 설치될 수 있음을 Google Play에 알립니다. 빌드 변형에 대한 자세한 내용은 빌드 시스템 개요를 참조하세요.

참고: 여러 지원 라이브러리를 포함하는 경우 최소 SDK 버전은 지정된 라이브러리가 요구하는 최상위 버전이어야 합니다. 예를 들어, 앱이 v14 Preference 지원 라이브러리v17 Leanback 라이브러리를 모두 포함하는 경우 최소 SDK 버전은 17 이상이어야 합니다.