Skip to content

Most visited

Recently visited

navigation

64K 이상의 메서드로 앱 구성

Android 플랫폼이 계속 성장함에 따라 Android 앱의 크기도 따라서 증가합니다. 애플리케이션과 이 애플리케이션이 참조하는 라이브러리의 크기가 일정 크기에 도달하면, 앱이 Android 앱 빌드 아키텍처의 제한에 도달했음을 나타내는 빌드 오류가 발생합니다. 이전 버전의 빌드 시스템에서는 이 오류를 다음과 같이 보고합니다.

Conversion to Dalvik format failed:
Unable to execute dex: method ID not in [0, 0xffff]: 65536

그보다 최근의 Android 빌드 시스템 버전에서는 다른 오류를 표시하지만 이 오류는 동일한 문제를 나타내는 것입니다.

trouble writing output:
Too many field references: 131000; max is 65536.
You may try using --multi-dex option.

두 오류 모두는 공통 숫자인 65,536을 표시합니다. 이 숫자는 단일 DEX(Dalvik Executable) 바이트코드 파일 내에서 코드가 호출할 수 있는 참조의 총 개수를 나타냅니다. Android 앱을 빌드할 때 이 오류가 발생했다면 그것은 좋은 소식입니다. 여러분의 코드가 많다는 것입니다! 이 문서에서는 이 한도를 넘어서 앱 빌드를 계속할 수 있는 방법에 대해 설명합니다.

참고: 이 문서에서 제공되는 지침은 Android 개발자 블로그 게시물인 Dalvik에서 클래스 로드 사용자 지정에서 제공되는 지침을 대체합니다.

64K 참조 제한 정보

Android 애플리케이션(APK) 파일에는 DEX(Dalvik Executable) 파일 형식의 실행 가능 바이트코드 파일이 포함됩니다. Dalvik Executable 사양은 단일 DEX 파일 내에서 참조될 수 있는 메서드의 총 개수를 65,536으로 제한하며 여기에는 Android 프레임워크 메서드, 라이브러리 메서드, 여러분 코드에 있는 메서드가 포함됩니다. 컴퓨터 공학 측면에서 킬로, K는 1024(또는 2^10)를 나타냅니다. 65,536은 64 X 1024와 동일하며, 이 제한을 '64K 참조 제한'이라고 부릅니다.

이 제한을 넘기 위해서는 2개 이상의 DEX 파일을 생성하도록 앱 빌드 프로세스를 구성해야 하며, 이것을 multidex 구성이라고 합니다.

Android 5.0 미만에서 multidex 지원

Android 5.0(API 레벨 21) 미만의 플랫폼 버전에서는 앱 코드 실행을 위해 Dalvik 런타임을 사용합니다. 기본적으로, Dalvik에서는 APK당 하나의 classes.dex 바이트코드 파일로 앱을 제한합니다. 이러한 제한을 해결하기 위해 multidex 지원 라이브러리를 사용할 수 있습니다. 앱의 기본 DEX 파일에 속하는 이 라이브러리는 추가적인 DEX 파일과 이 파일 내의 코드에 대한 액세스를 관리합니다.

참고: minSdkVersion 20 이하의 multidex용으로 프로젝트가 구성된 경우, Android 4.4(API 레벨 20) 이하가 실행 중인 대상 기기에 배포하면 Android Studio가 Instant Run을 비활성화합니다.

Android 5.0 이상에서 multidex 지원

Android 5.0(API 레벨 21) 이상에서는 ART라는 런타임을 사용합니다. 기본적으로 이 런타임은 애플리케이션 APK 파일로부터 여러 개의 DEX 파일을 로드하는 것을 지원합니다. ART는 애플리케이션 설치 시에 사전 컴파일을 수행합니다. 이 때 classes(..N).dex 파일을 스캔하고, Android 기기가 실행할 수 있도록 이 파일을 단일 .oat 파일로 컴파일합니다. Android 5.0 런타임에 대한 자세한 내용은 ART 소개를 참조하세요.

참고: Instant Run이 사용되는 중에 앱의 minSdkVersion이 21 이상으로 설정된 경우, Android Studio는 자동으로 앱을 multidex용으로 구성합니다. Instant Run은 디버그 버전의 앱에서만 작동하므로, 64K 제한을 피하기 위해서는 릴리스 빌드를 multidex용으로 구성해야 합니다.

64K 제한 피하기

64K개 이상의 메서드 참조를 사용하도록 앱을 구성하기 전에, 앱 코드가 호출하는 참조의 총 개수를 줄이는 단계를 먼저 수행해야 합니다. 이 개수에는 앱 코드나 포함된 라이브러리에 의해 정의된 메서드가 포함됩니다. 다음 전략은 DEX 참조 제한을 넘지 않도록 도와줍니다.

이러한 방법을 사용하면 빌드 구성 변경을 피하면서도 앱에서 더 많은 메서드 참조를 활성화할 수 있습니다. 이들 단계는 또한 APK 크기를 줄여주며, 이것은 대역폭 비용이 비싼 시장에 특히 중요합니다.

Gradle로 multidex용 앱 구성

Android SDK 빌드 도구 21.1 이상에서 사용 가능한 Gradle용 Android 플러그인은 빌드 구성의 일부분으로 multidex를 지원합니다. 앱을 multidex용으로 구성하기 전에 먼저 SDK Manager를 사용하여 Android SDK 빌드 도구 및 Android Support Repository를 최신 버전으로 업데이트합니다.

multidex 구성을 사용하도록 앱 개발 프로젝트를 설정하려면, 앱 개발 프로젝트에 몇 가지 수정을 해야 합니다. 특히 다음 단계를 수행해야 합니다.

다음 코드 스니펫에 나오는 것처럼, 지원 라이브러리를 포함하고 multidex 출력을 활성화하도록 모듈 레벨 build.gradle 파일 구성을 수정합니다.

android {
    compileSdkVersion 21
    buildToolsVersion "21.1.0"

    defaultConfig {
        ...
        minSdkVersion 14
        targetSdkVersion 21
        ...

        // Enabling multidex support.
        multiDexEnabled true
    }
    ...
}

dependencies {
  compile 'com.android.support:multidex:1.0.0'
}

자신의 매니페스트에서 multidex 지원 라이브러리의 MultiDexApplication 클래스를 애플리케이션 요소에 추가합니다.

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.android.multidex.myapplication">
    <application
        ...
        android:name="android.support.multidex.MultiDexApplication">
        ...
    </application>
</manifest>

이들 구성 설정이 앱에 추가되면, Android 빌드 도구가 필요에 따라 기본 DEX(classes.dex)와 보조 DEX(classes2.dex, classes3.dex)를 구성합니다. 그런 다음, 빌드 시스템이 DEX를 배포용 APK 파일에 패키징합니다.

참고: 앱이 Application 클래스를 사용하는 경우, attachBaseContext() 메서드를 재정의하고 MultiDex.install(this)를 호출하여 multidex를 활성화할 수 있습니다. 자세한 내용은 MultiDexApplication 참조 문서를 참조하세요.

multidex 지원 라이브러리의 제한사항

multidex 지원 라이브러리에는 몇 가지 알려진 제한사항이 있으며, 이 라이브러리를 앱 빌드 구성에 통합할 때 이러한 제한사항을 파악하고 테스트해야 합니다.

multidex 개발 빌드 최적화

기본 DEX 파일에 어떤 클래스를 포함해야 하고 보조 DEX 파일에 어떤 클래스를 포함할 수 있는지에 관한 복잡한 결정을 빌드 시스템이 내려야 하기 때문에, multidex 구성에는 상당히 긴 빌드 처리 시간이 필요합니다. 즉, 개발 프로세스의 일환으로 multidex로 수행되는 루틴 빌드는 일반적으로 더 시간이 오래 걸리며 개발 프로세스가 느려질 가능성이 있습니다.

multidex 출력 시에 긴 빌드 시간을 줄이려면, Gradle용 Android 플러그인인 productFlavors를 사용하여 빌드 출력에서 2개의 변형을 생성해야 합니다(개발 버전 및 프로덕션 버전).

개발 버전의 경우, 21의 최소 SDK 버전을 설정합니다. 이 설정은 ART 지원 형식을 사용하여 훨씬 더 빠르게 multidex 출력을 생성합니다. 릴리스 버전의 경우, 실제 최소 지원 수준과 일치하는 최소 SDK 버전을 설정합니다. 이 설정은 더 많은 기기와 호환되는 multidex APK를 생성하지만, 빌드 시간이 더 오래 걸립니다.

다음 빌드 구성 샘플에서는 이러한 버전을 Gradle 빌드 파일에서 설정하는 방법을 보여줍니다.

android {
    productFlavors {
        // Define separate dev and prod product flavors.
        dev {
            // dev utilizes minSDKVersion = 21 to allow the Android gradle plugin
            // to pre-dex each module and produce an APK that can be tested on
            // Android Lollipop without time consuming dex merging processes.
            minSdkVersion 21
        }
        prod {
            // The actual minSdkVersion for the application.
            minSdkVersion 14
        }
    }
          ...
    buildTypes {
        release {
            runProguard true
            proguardFiles getDefaultProguardFile('proguard-android.txt'),
                                                 'proguard-rules.pro'
        }
    }
}
dependencies {
  compile 'com.android.support:multidex:1.0.0'
}

이 구성을 변경한 후에는 앱의 devDebug 변형을 사용할 수 있습니다. 이 변형은 dev productFlavor 특성과 debug buildType 특성을 결합합니다. 이 대상을 사용하면 ProGuard는 비활성화되고, multidex는 활성화되고, minSdkVersion은 Android API 레벨 21로 설정되어 디버그 앱이 생성됩니다. 이들 설정에 따라 Gradle용 Android 플러그인이 다음 작업을 수행합니다.

  1. 애플리케이션(종속성 포함)의 각 모듈을 별도의 DEX 파일로서 빌드합니다. 이것을 흔히 프리덱싱(pre-dexing)이라고 부릅니다.
  2. 각 DEX 파일은 수정 없이 APK에 포함됩니다.
  3. 무엇보다도 중요한 점은, 모듈 DEX 파일이 결합되지 않으므로 기본 DEX 파일의 내용을 결정하는 데 긴 시간이 걸리는 계산을 피할 수 있습니다.

이 설정에서는 수정된 모듈의 DEX 파일만이 다시 계산되어 APK 파일에 다시 패키징되기 때문에 신속한 증분 빌드가 가능합니다. 이 빌드에서 생성된 APK는 Android 5.0 기기에서 테스트를 수행할 때만 사용될 수 있습니다. 그러나, 이 구성을 버전으로 구현하게 되면, 릴리스에 적합한 최소 SDK 수준과 proguard 설정을 통해 정상적인 빌드를 수행할 수 있습니다.

또한 prodDebug 변형 빌드를 비롯한 다른 변형을 빌드할 수도 있습니다. 이 변형 빌드는 빌드 시간이 더 오래 걸리지만 개발 이외의 테스트에 사용될 수가 있습니다. 표시된 구성 내에서 prodRelease 변형이 최종 테스트 및 릴리스 버전이 됩니다. 명령줄에서 Gradle 작업을 수행 중인 경우에는, DevDebug가 끝에 추가된 표준 명령을 사용할 수 있습니다(예: ./gradlew installDevDebug). Gradle 작업에서 버전을 사용하는 방법에 자세한 내용은, Gradle 플러그인 사용자 가이드를 참조하세요.

팁: 또한 각 버전에 대해 사용자 지정 매니페스트나 사용자 지정 애플리케이션 클래스를 제공할 수도 있으므로, 지원 라이브러리 MultiDexApplication 클래스를 사용하도록 허용하거나 필요로 하는 변형에 대해서만 MultiDex.install()을 호출 수 있습니다.

Android Studio에서 빌드 변형 사용

빌드 변형은 multidex 사용 시 빌드 프로세스를 관리할 때 매우 유용할 수 있습니다. Android Studio를 사용하면 이러한 빌드 변형을 사용자 인터페이스에서 선택할 수 있습니다.

Android Studio가 앱의 "devDebug" 변형을 빌드하도록 하려면:

  1. 왼쪽 사이드바에서 빌드 변형 창을 엽니다. 옵션은 즐겨찾기 옆에 있습니다.
  2. 다른 변형을 선택하려면 빌드 변형의 이름을 클릭합니다(그림 1 참조).

그림 1. 빌드 변형을 보여주는 Android Studio 왼쪽 패널의 스크린샷.

참고: 이 창을 여는 옵션은 Tools > Android > Sync Project with Gradle Files 명령을 사용하여 Android Studio와 Gradle 빌드 파일을 성공적으로 동기화한 후에만 사용이 가능합니다.

multidex 앱 테스트

multidex 앱용 계측 테스트를 작성할 때는 추가적인 구성이 필요 없습니다. MultiDexApplication을 사용하거나 사용자 지정 Application 객체에서 attachBaseContext() 메서드를 재정의하고 MultiDex.install(this)를 호출하여 multidex를 활성화하는 한, AndroidJUnitRunner는 multidex를 바로 지원합니다.

또는 AndroidJUnitRunner에서 onCreate() 메서드를 재정의할 수 있습니다.

public void onCreate(Bundle arguments) {
    MultiDex.install(getTargetContext());
    super.onCreate(arguments);
    ...
}

참고: multidex를 사용하여 테스트 APK를 생성하는 것은 현재 지원되지 않습니다.

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.