[Android] Android ABI 완벽 가이드 : 초보 개발자를 위한 적용 및 관리 방법

Android ABI 완벽 가이드: 초보 개발자를 위한 적용 및 관리 방법

안드로이드 앱을 개발하다 보면 다양한 기기와 프로세서 아키텍처를 지원해야 하는 상황에 마주하게 됩니다. 이때 ABI(Application Binary Interface)에 대한 이해가 필수적인데요, 많은 초보 개발자분들이 이 개념을 어려워하십니다. 오늘은 안드로이드 ABI가 무엇인지부터 실제 프로젝트에 어떻게 적용하고 관리하는지까지 쉽게 알아보겠습니다.

---

목차

1. ABI란 무엇인가?
2. 안드로이드에서 지원하는 ABI 종류
3. ABI 설정이 필요한 이유
4. Gradle에서 ABI 설정하는 방법
5. ABI 분할(Split) APK 만들기
6. AAB(Android App Bundle)와 ABI
7. NDK 개발에서 ABI 고려사항
8. ABI 호환성 문제 해결하기
9. 성능 최적화를 위한 ABI 전략
10. 자주 묻는 질문(FAQ)

 

#1. ABI란 무엇인가?

ABI(Application Binary Interface)는 애플리케이션의 바이너리 코드가 특정 시스템에서 어떻게 동작해야 하는지를 정의하는 인터페이스입니다. 쉽게 말해, 앱이 기기의 프로세서와 어떻게 소통하는지를 결정하는 규칙이라고 생각하면 됩니다.

예를 들어, 삼성 갤럭시 S21과 구글 픽셀 6는 서로 다른 프로세서를 사용할 수 있는데, 각 프로세서는 고유한 명령어 세트를 가지고 있습니다. ABI는 이러한 서로 다른 프로세서에서 앱이 올바르게 실행될 수 있도록 보장합니다.

 

#2. 안드로이드에서 지원하는 ABI 종류

안드로이드는 다양한 ABI를 지원합니다. 주요 ABI 유형은 다음과 같습니다:

1. armeabi-v7a: 32비트 ARM 프로세서용 (대부분의 구형 안드로이드 기기)
2. arm64-v8a: 64비트 ARM 프로세서용 (최신 안드로이드 기기)
3. x86: 32비트 인텔/AMD 프로세서용 (일부 태블릿, 에뮬레이터)
4. x86_64: 64비트 인텔/AMD 프로세서용 (일부 태블릿, 에뮬레이터)

💡 참고: armeabi ABI는 Android NDK r17부터 더 이상 지원되지 않습니다.

현재 대부분의 안드로이드 기기는 arm64-v8a와 armeabi-v7a를 주로 사용합니다. 최신 기기는 대부분 arm64-v8a를 사용하지만, 하위 호환성을 위해 armeabi-v7a도 지원합니다.

 

#3. ABI 설정이 필요한 이유

ABI 설정이 왜 중요한지 몇 가지 핵심 이유를 살펴보겠습니다:

앱 크기 최적화

모든 ABI를 지원하도록 앱을 빌드하면 앱 크기가 커집니다. 필요한 ABI만 포함시켜 앱 크기를 줄일 수 있습니다.

성능 향상

각 기기에 최적화된 바이너리 코드를 제공하면 앱의 성능이 향상됩니다. 예를 들어, arm64-v8a 기기에 arm64-v8a용으로 컴파일된 코드를 제공하면 armeabi-v7a 코드보다 더 빠르게 실행됩니다.

호환성 보장

일부 NDK 라이브러리나 SDK는 특정 ABI만 지원할 수 있습니다. 적절한 ABI 설정을 통해 앱의 호환성을 보장할 수 있습니다.

 

#4. Gradle에서 ABI 설정하는 방법

안드로이드 스튜디오에서 ABI를 설정하는 가장 일반적인 방법은 Gradle 빌드 스크립트를 사용하는 것입니다. 다음은 app/build.gradle 파일에서 ABI를 설정하는 예시입니다:

android {
    // 다른 설정들...

    defaultConfig {
        // 다른 설정들...

        ndk {
            // 지원할 ABI 목록
            abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
        }
    }

    // 빌드 타입별 설정
    buildTypes {
        release {
            // 릴리스 빌드에서는 주요 ABI만 지원
            ndk {
                abiFilters 'armeabi-v7a', 'arm64-v8a'
            }
        }

        debug {
            // 디버그 빌드에서는 에뮬레이터 지원을 위해 x86도 포함
            ndk {
                abiFilters 'x86', 'armeabi-v7a', 'arm64-v8a'
            }
        }
    }
}

이렇게 설정하면 릴리스 버전에서는 실제 기기에서 주로 사용되는 ABI만 포함하고, 디버그 버전에서는 에뮬레이터 지원을 위해 x86도 포함합니다.

 

#5. ABI 분할(Split) APK 만들기

안드로이드에서는 ABI별로 다른 APK를 생성하는 '분할 APK' 기능을 제공합니다. 이를 통해 각 기기에 필요한 ABI만 포함된 APK를 제공할 수 있어 앱 크기를 줄일 수 있습니다.

android {
    // 다른 설정들...

    splits {
        abi {
            enable true
            reset()
            include 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
            universalApk false // true로 설정하면 모든 ABI를 포함한 APK도 생성
        }
    }
}

이 설정을 추가하면 빌드 시 각 ABI별로 별도의 APK가 생성됩니다. Google Play는 이러한 분할 APK를 지원하여 사용자 기기에 적합한 APK만 제공합니다.

 

#6. AAB(Android App Bundle)와 ABI

구글 플레이 스토어는 이제 Android App Bundle(AAB) 형식을 권장합니다. AAB는 ABI, 화면 밀도, 언어 등에 따라 앱을 동적으로 분할하여 각 사용자에게 최적화된 APK를 제공합니다.

AAB에서 ABI 설정은 다음과 같이 합니다:

android {
    // 다른 설정들...

    bundle {
        language {
            enableSplit = true
        }
        density {
            enableSplit = true
        }
        abi {
            enableSplit = true // ABI 분할 활성화
        }
    }
}

AAB를 사용하면 별도로 ABI 분할 APK를 만들지 않아도 Google Play가 자동으로 최적화된 APK를 사용자에게 제공합니다.

 

#7. NDK 개발에서 ABI 고려사항

NDK(Native Development Kit)를 사용하여 C/C++ 코드를 작성하는 경우, ABI에 대한 추가적인 고려가 필요합니다.

CMakeLists.txt 설정

C/C++ 코드를 빌드할 때 사용하는 CMakeLists.txt 파일에서도 ABI 관련 설정을 할 수 있습니다:

# 특정 ABI에 대한 최적화 플래그 설정
if(${ANDROID_ABI} STREQUAL "arm64-v8a")
    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -march=armv8-a")
elseif(${ANDROID_ABI} STREQUAL "armeabi-v7a")
    set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -march=armv7-a -mfpu=neon")
endif()

소스 코드에서 ABI 확인

경우에 따라 런타임에 현재 실행 중인 ABI를 확인해야 할 수도 있습니다:

// Java 코드
String abi = Build.SUPPORTED_ABIS[0]; // 기기가 지원하는 주요 ABI
Log.d("ABI", "Primary ABI: " + abi);

// 특정 ABI에 따라 다른 기능 구현
if (abi.equals("arm64-v8a")) {
    // 64비트 ARM 기기에 특화된 코드
} else if (abi.equals("armeabi-v7a")) {
    // 32비트 ARM 기기에 특화된 코드
}

 

#8. ABI 호환성 문제 해결하기

ABI 관련 문제가 발생할 때 해결하는 방법을 알아봅시다.

UnsatisfiedLinkError 해결하기

가장 흔한 문제 중 하나는 UnsatisfiedLinkError입니다. 이는 주로 기기의 ABI와 앱의 네이티브 라이브러리 ABI가 일치하지 않을 때 발생합니다.

java.lang.UnsatisfiedLinkError: dalvik.system.PathClassLoader[...]
couldn't find "libmynative.so"

해결책:

1. 앱의 abiFilters에 해당 기기의 ABI가 포함되어 있는지 확인
2. 사용 중인 라이브러리가 해당 ABI를 지원하는지 확인
3. System.loadLibrary() 호출 전에 라이브러리 경로가 올바른지 확인

64비트 대응하기

Google Play는 모든 앱이 64비트 버전을 제공하도록 요구하고 있습니다. 앱이 아직 64비트를 지원하지 않는다면 다음과 같이 업데이트해야 합니다:

1. abiFilters에 arm64-v8a와 x86_64 추가
2. 사용 중인 모든 네이티브 라이브러리가 64비트 버전을 제공하는지 확인
3. 네이티브 코드에서 64비트 호환성 문제 수정 (예: 포인터 크기, 정수 타입 등)

 

#9. 성능 최적화를 위한 ABI 전략

ABI 선택은 앱의 성능과 설치 크기에 큰 영향을 미칩니다. 다음은 몇 가지 최적화 전략입니다:

시나리오 1: 네이티브 코드가 없는 일반 앱

대부분의 자바/코틀린 기반 앱은 네이티브 코드를 사용하지 않습니다. 이 경우:

android {
    defaultConfig {
        ndk {
            // ABI 필터를 설정하지 않음
        }
    }
}

네이티브 코드가 없다면 ABI 설정이 필요 없습니다. 안드로이드 런타임이 자동으로 처리합니다.

시나리오 2: 네이티브 코드를 사용하는 앱

네이티브 코드를 사용하는 경우, AAB 형식으로 출시하는 것이 가장 좋습니다:

android {
    defaultConfig {
        ndk {
            abiFilters 'armeabi-v7a', 'arm64-v8a', 'x86', 'x86_64'
        }
    }

    bundle {
        abi {
            enableSplit = true
        }
    }
}

이렇게 하면 Google Play에서 각 기기에 맞는 최적화된 APK를 제공합니다.

시나리오 3: 크기가 매우 중요한 앱

앱 크기를 최소화해야 하는 경우:

android {
    defaultConfig {
        ndk {
            // 가장 많이 사용되는 두 가지 ABI만 지원
            abiFilters 'armeabi-v7a', 'arm64-v8a'
        }
    }
}

이렇게 하면 에뮬레이터나 일부 인텔 기반 기기에서는 앱이 작동하지 않지만, 대부분의 실제 기기에서는 작동하면서 앱 크기를 줄일 수 있습니다.

 

#10. 자주 묻는 질문(FAQ)

Q: 모든 ABI를 지원하는 것이 좋을까요?

A: 네이티브 코드를 사용하는 경우 AAB를 사용하여 모든 주요 ABI(armeabi-v7a, arm64-v8a, x86, x86_64)를 지원하는 것이 좋습니다. 네이티브 코드가 없다면 ABI 설정이 필요하지 않습니다.

Q: 32비트와 64비트의 차이점은 무엇인가요?

A: 64비트(arm64-v8a, x86_64)는 32비트(armeabi-v7a, x86)에 비해 더 많은 메모리를 사용할 수 있고, 계산 성능이 더 좋습니다. 최신 안드로이드 기기는 대부분 64비트 프로세서를 사용합니다.

Q: 에뮬레이터에서 테스트할 때 ABI 설정은 어떻게 해야 하나요?

A: 안드로이드 에뮬레이터는 주로 x86 또는 x86_64 ABI를 사용합니다. 에뮬레이터에서 테스트하려면 이 ABI들을 포함해야 합니다.

Q: 특정 ABI만 사용해도 모든 기기에서 작동할까요?

A: 네이티브 코드가 없는 앱은 ABI와 상관없이 모든 기기에서 작동합니다. 네이티브 코드가 있는 경우, 해당 기기의 ABI를 지원해야 앱이 작동합니다.

Q: Google Play의 64비트 요구사항은 무엇인가요?

A: 2019년 8월부터 Google Play는 모든 네이티브 코드 앱이 64비트 버전(arm64-v8a)을 제공하도록 요구하고 있습니다. 즉, 32비트(armeabi-v7a)만 지원하는 앱은 더 이상 새로운 앱이나 업데이트를 제출할 수 없습니다.

---

결론

안드로이드 ABI는 처음에는 복잡해 보일 수 있지만, 기본 개념을 이해하고 나면 앱 개발 과정에서 중요한 부분임을 알 수 있습니다. ABI를 올바르게 설정하면 앱의 크기를 최적화하고, 성능을 향상시키며, 더 넓은 범위의 기기와 호환성을 보장할 수 있습니다.

초보 개발자라면 처음에는 AAB 형식을 사용하여 모든 주요 ABI를 지원하는 것으로 시작하고, 필요에 따라 점진적으로 ABI 설정을 최적화하는 것이 좋습니다. 이러한 접근 방식은 최소한의 노력으로 최대한의 호환성을 보장하며, 나중에 앱이 성장함에 따라 더 세밀한 조정을 할 수 있는 기반을 마련해 줍니다.

안드로이드 ABI 관리는 앱 개발 여정에서 중요한 스킬이며, 이 가이드가 여러분의 개발 작업에 도움이 되기를 바랍니다!

긴 글 읽어주셔서 감사합니다.

끝.