이 페이지는 Cloud Translation API를 통해 번역되었습니다.

지원 라이브러리 설정

참고: Android 9.0(API 수준 28)의 출시와 함께 Jetpack의 일부인 새로운 버전의 지원 라이브러리 AndroidX가 출시됩니다. AndroidX 라이브러리는 기존 지원 라이브러리를 포함하며 최신 Jetpack 구성요소 또한 포함합니다.

지원 라이브러리를 계속 사용할 수 있습니다. 이전 아티팩트(버전 27 이상이며 android.support.*로 패키징됨)는 Google Maven에서 계속 사용할 수 있습니다. 그러나 모든 새 라이브러리 개발은 AndroidX 라이브러리에서 진행됩니다.

모든 신규 프로젝트에서 AndroidX 라이브러리를 사용하는 것이 좋습니다. 기존 프로젝트를 AndroidX로 이전하는 것 또한 고려해보세요.

개발 프로젝트에서 Android 지원 라이브러리를 설정하는 방법은 어떤 기능에 따름 지원하고자 하는 Android 플랫폼 버전의 범위를 애플리케이션입니다.

이 문서에서는 지원 라이브러리 패키지를 다운로드하고 라이브러리를 추가하는 과정을 안내합니다. 설계할 수 있습니다

지원 라이브러리는 이제 Google Maven을 통해 사용할 수 있습니다. 저장소 SDK를 통한 라이브러리 다운로드는 더 이상 지원되지 않습니다. 관리자 지원을 요청했으며 해당 기능은 곧 삭제됩니다.

지원 라이브러리 선택

지원 라이브러리를 애플리케이션에 추가하기 전에 포함할 기능을 결정하세요. 지원하려는 가장 낮은 Android 버전을 선택해야 합니다 이러한 기능에 대한 자세한 내용은 자세히 알아보려면 지원 라이브러리 기능.

지원 라이브러리 추가

지원 라이브러리를 사용하려면 애플리케이션 프로젝트의 클래스 경로 종속 항목을 사용할 수 있습니다. 이 절차를 수행해야 하는 경우 지원 라이브러리를 모두 제공해야 합니다

지원 라이브러리를 애플리케이션 프로젝트에 추가하려면 다음 단계를 따르세요.

프로젝트의 settings.gradle 파일.

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()

        // If you're using a version of Gradle lower than 4.1, you must
        // instead use:
        //
        // maven {
        //     url 'https://maven.google.com'
        // }
    }
}

지원 라이브러리를 사용할 각 모듈에 대해 모듈 build.gradle 파일의 dependencies 블록. 대상 예를 들어 v4 core-utils 라이브러리를 추가하려면 다음을 추가합니다.
```
dependencies {
    ...
    implementation "com.android.support:support-core-utils:28.0.0"
}
```

주의: 동적 종속 항목 (예: palette-v7:23.0.+)로 인해 예기치 않은 버전 업데이트가 발생할 수 있으며 회귀 비호환성 문제를 살펴봤습니다 광고 단위를 명시적으로 지정하는 것이 좋습니다. 라이브러리 버전 (예: palette-v7:28.0.0)

지원 라이브러리 API 사용

기존 프레임워크 API를 지원하는 지원 라이브러리 클래스에는 일반적으로 프레임워크 클래스와 이름이 같지만 android.support 클래스 패키지에 있습니다. 또는 *Compat 서픽스가 있어야 합니다.

주의: 지원 라이브러리의 클래스를 사용할 때는 반드시 가져와야 합니다. 클래스를 삭제합니다. 예를 들어 ActionBar를 적용하는 경우 클래스:

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

참고: 애플리케이션 프로젝트에 지원 라이브러리를 포함하면 난독화, 난독화, 성능 최적화를 앱을 출시해야 합니다. 난독화, 축소, 축소를 통해 소스 코드를 보호하는 것 외에도 애플리케이션에 포함한 라이브러리에서 사용되지 않는 클래스를 제거하여 애플리케이션의 다운로드 크기를 가능한 한 작게 만드는 것이 좋습니다.

일부 지원 라이브러리 기능 사용에 관한 추가 안내는 Android 개발자에게 제공됩니다. 학습 클래스 가이드 샘플이 있습니다 개별 지원 라이브러리 클래스 및 메서드에 대한 자세한 내용은 API 참조의 android.support 패키지

매니페스트 선언 변경

기존 애플리케이션의 이전 버전과의 호환성을 이전 버전과의 호환성을 최신 버전의 Android API를 사용하려면 애플리케이션의 최신 버전을 합니다. 특히 android:minSdkVersion를 업데이트해야 합니다. 의 요소 매니페스트의 <uses-sdk> 태그를 새로운 하위 버전 번호로 교체합니다. 다음과 같습니다.

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

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

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

plugins {
  id 'com.android.application'
}

android {
    ...

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

이 경우 빌드 파일 설정은 기본 빌드 변형이 Android 4.1 (API 수준 16) 이상을 실행하는 기기에 설치할 수 있습니다. 자세한 내용은 빌드 변형에 대한 자세한 내용은 빌드 시스템 개요.

참고: 여러 지원 라이브러리를 포함하는 경우 최소 SDK 버전은 다음 중 하나라도 요구하는 최고 버전이어야 합니다. 할 수 있습니다 예를 들어 앱에 v14 환경설정 지원 라이브러리와 v17 Leanback 라이브러리는 SDK 버전이 17 이상이어야 합니다.