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

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

개요

안드로이드 앱을 개발하다 보면 다양한 기기와 프로세서 아키텍처를 지원해야 하는 상황에 마주하게 됩니다. 이때 ABI(Application Binary Interface)에 대한 이해가 필수적인데요, 많은 초보 개발자분들이 이 개념을 어려워하십니다.

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

이 글에서는 안드로이드 ABI가 무엇인지부터 실제 프로젝트에 어떻게 적용하고 관리하는지까지 초보 개발자도 쉽게 이해할 수 있도록 상세히 설명합니다. 올바른 ABI 설정을 통해 앱의 크기를 최적화하고, 성능을 향상시키며, 더 넓은 범위의 기기와 호환성을 보장할 수 있습니다.

목차

1. ABI란 무엇인가?

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

3. ABI 설정이 필요한 이유

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

5. ABI 관련 자주 묻는 질문

---

#1. ABI란 무엇인가?

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

1) ABI의 역할과 중요성

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

(1) 프로세서 아키텍처의 이해

프로세서 아키텍처는 CPU가 명령어를 처리하는 방식을 정의합니다. 안드로이드 기기는 주로 ARM 아키텍처를 사용하지만, 일부 태블릿과 에뮬레이터는 x86 아키텍처를 사용합니다.

① ARM 아키텍처: 대부분의 스마트폰과 태블릿에서 사용되는 저전력 고효율 프로세서

② x86 아키텍처: 인텔과 AMD 프로세서에서 사용되는 데스크톱 기반 아키텍처

③ 64비트 vs 32비트: 한 번에 처리할 수 있는 데이터 크기의 차이로 성능과 메모리 처리 능력에 영향

. . . . .

2) ABI와 API의 차이점

많은 초보 개발자들이 ABI와 API를 혼동하는데, 이 둘은 전혀 다른 개념입니다.

구분	ABI	API
정의	바이너리 레벨의 인터페이스	소스 코드 레벨의 인터페이스
대상	컴파일된 바이너리 코드	소스 코드
영향 범위	프로세서 아키텍처 호환성	OS 버전 호환성
예시	arm64-v8a, x86_64	Android API 28, 33

---

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

안드로이드는 다양한 ABI를 지원합니다. 각 ABI는 특정 프로세서 아키텍처에 최적화되어 있으며, 개발자는 앱이 타겟으로 하는 기기에 따라 적절한 ABI를 선택해야 합니다.

1) 주요 ABI 유형

ABI 유형	프로세서	비트	주요 사용 기기
armeabi-v7a	ARM	32비트	대부분의 구형 안드로이드 기기
arm64-v8a	ARM	64비트	최신 안드로이드 기기 (2015년 이후)
x86	Intel/AMD	32비트	일부 태블릿, 에뮬레이터
x86_64	Intel/AMD	64비트	일부 태블릿, 에뮬레이터

중요: armeabi ABI는 Android NDK r17부터 더 이상 지원되지 않습니다. 새로운 프로젝트에서는 사용하지 마세요.

. . . . .

2) 각 ABI의 특징 및 사용 현황

(1) arm64-v8a (64비트 ARM)

현재 가장 널리 사용되는 ABI로, 2015년 이후 출시된 대부분의 안드로이드 기기가 지원합니다.

① 시장 점유율: 현재 안드로이드 시장의 약 80% 이상

② 성능: 64비트 연산으로 더 빠른 처리 속도와 향상된 메모리 관리

③ 메모리: 4GB 이상의 RAM을 효율적으로 활용 가능

④ Google Play 요구사항: 2019년 8월부터 필수 요구사항

(2) armeabi-v7a (32비트 ARM)

구형 기기와의 호환성을 위해 여전히 중요한 ABI입니다.

① 하위 호환성: 2015년 이전 기기 지원에 필수

② 메모리 효율: 64비트보다 메모리 사용량이 적음

③ NEON 지원: SIMD 명령어 세트로 멀티미디어 처리 최적화

(3) x86 및 x86_64

주로 개발 환경에서 중요한 ABI입니다.

① 에뮬레이터: 안드로이드 스튜디오 에뮬레이터가 x86 기반으로 작동

② 실제 기기: ASUS ZenFone, 일부 태블릿 PC

③ 개발 단계: 디버그 빌드에서 에뮬레이터 테스트를 위해 포함 권장

---

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

ABI 설정이 왜 중요한지 구체적인 이유를 살펴보겠습니다. 올바른 ABI 설정은 앱의 성능과 사용자 경험에 직접적인 영향을 미칩니다.

1) 앱 크기 최적화

모든 ABI를 지원하도록 앱을 빌드하면 각 ABI마다 별도의 네이티브 라이브러리가 포함되어 앱 크기가 크게 증가합니다. 필요한 ABI만 포함시켜 앱 크기를 줄일 수 있습니다.

(1) ABI별 용량 증가

네이티브 라이브러리를 사용하는 앱의 경우, 각 ABI마다 다음과 같은 용량이 추가됩니다.

포함 ABI 수	예상 네이티브 라이브러리 크기	총 APK 크기 증가
1개 (arm64-v8a만)	약 5MB	기준
2개 (arm64-v8a + armeabi-v7a)	약 9MB	+80%
4개 (전체)	약 18MB	+260%

① 사용자 다운로드 시간 단축

② 저장 공간 절약으로 사용자 만족도 향상

③ 모바일 데이터 사용량 감소

. . . . .

2) 성능 향상

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

(1) 성능 차이 사례

동일한 기기(arm64-v8a 지원)에서 서로 다른 ABI를 사용했을 때의 성능 비교입니다.

① 64비트 네이티브 코드: 최적 성능, 기준 100%

② 32비트 네이티브 코드: 약 70-80% 성능 (호환 모드로 실행)

③ 메모리 접근 속도: 64비트가 대용량 데이터 처리 시 30-40% 빠름

④ 계산 집약적 작업: 64비트에서 레지스터 활용 증가로 20-30% 향상

. . . . .

3) 호환성 보장

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

(1) 써드파티 라이브러리 고려사항

① 모든 ABI를 지원하는지 확인 필요

② 일부 라이브러리는 arm64-v8a와 armeabi-v7a만 제공

③ x86 지원이 누락된 경우 에뮬레이터 테스트 불가능

④ 라이브러리 업데이트 시 ABI 지원 변경 사항 체크

(2) Google Play 64비트 요구사항

2019년 8월부터 Google Play는 모든 네이티브 코드 앱이 64비트 버전을 제공하도록 요구하고 있습니다. 이는 향후 안드로이드의 32비트 지원 중단을 대비한 조치입니다.

① 32비트만 지원하는 앱은 새로운 업데이트 제출 불가

② 32비트 지원 유지는 가능하나 64비트 필수 포함

③ 기존 32비트 앱은 다운로드 가능하나 업데이트 불가

---

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

안드로이드 스튜디오에서 ABI를 설정하는 가장 일반적인 방법은 Gradle 빌드 스크립트를 사용하는 것입니다. 실제 프로젝트에 적용할 수 있는 다양한 설정 방법을 알아보겠습니다.

1) 기본 ABI 설정

app/build.gradle 파일에서 ABI를 설정하는 가장 기본적인 방법입니다.

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

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

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

이 설정은 앱이 4가지 ABI 모두를 지원하도록 합니다. 각 ABI에 맞는 네이티브 라이브러리가 APK에 포함됩니다.

. . . . .

2) 빌드 타입별 ABI 설정

개발 환경과 프로덕션 환경에서 서로 다른 ABI 전략을 사용할 수 있습니다.

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

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

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

① Release 빌드: 실제 사용자를 위한 최적화, 앱 크기 최소화

② Debug 빌드: 개발 편의성 우선, 에뮬레이터 테스트 지원

③ 용량 절감: 릴리스 APK 크기 약 40-50% 감소

. . . . .

3) ABI 분할(Split) APK 만들기

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

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

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

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

(1) Split APK의 장점

① 사용자별 최소 다운로드 크기 (약 60-70% 감소)

② Google Play에서 자동으로 적절한 APK 배포

③ 각 ABI에 최적화된 바이너리 제공

(2) Universal APK

universalApk를 true로 설정하면 모든 ABI를 포함한 APK도 함께 생성됩니다. 이는 Google Play 외부 배포 시 유용합니다.

. . . . .

4) AAB(Android App Bundle)와 ABI

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

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

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

(1) AAB의 장점

① Google Play가 자동으로 최적화된 APK 생성

② 개발자는 하나의 AAB 파일만 업로드

③ 평균 15-30% 앱 크기 감소

④ 별도의 Split APK 관리 불필요

(2) AAB 사용 시 주의사항

AAB를 사용하면 별도로 ABI 분할 APK를 만들지 않아도 Google Play가 자동으로 최적화된 APK를 사용자에게 제공합니다. 2021년 8월부터 Google Play는 새로운 앱에 대해 AAB 형식을 필수로 요구합니다.

. . . . .

5) NDK 개발에서 ABI 고려사항

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

(1) 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()

(2) 런타임 ABI 확인

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

// Java/Kotlin 코드
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 기기에 특화된 코드
}

---

#5. ABI 관련 자주 묻는 질문

실제 개발 과정에서 자주 발생하는 ABI 관련 질문과 해결 방법을 정리했습니다.

1) 모든 ABI를 지원하는 것이 좋을까요?

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

① AAB 사용 시: 모든 ABI 지원 권장, Google Play가 자동 최적화

② 네이티브 코드 없을 시: ABI 설정 불필요, 안드로이드 런타임이 자동 처리

③ 앱 크기 우선 시: arm64-v8a와 armeabi-v7a만 지원

. . . . .

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

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

구분	32비트	64비트
메모리 주소 공간	최대 4GB	이론상 16EB (실질적으로 제한 없음)
레지스터 수	16개	32개
연산 성능	기준	약 20-40% 향상
메모리 사용량	적음	약 20-30% 더 많음

. . . . .

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

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

① Debug 빌드 타입에만 x86/x86_64 포함

② Release 빌드에서는 제외하여 APK 크기 최적화

③ ARM 에뮬레이터를 사용하면 x86 불필요 (다만 느림)

. . . . .

4) UnsatisfiedLinkError가 발생하면 어떻게 해결하나요?

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

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

(1) 해결 방법

① 앱의 abiFilters에 해당 기기의 ABI가 포함되어 있는지 확인

② 사용 중인 라이브러리가 해당 ABI를 지원하는지 확인

③ System.loadLibrary() 호출 전에 라이브러리 경로가 올바른지 확인

④ APK 내부의 lib 폴더 구조 확인 (APK Analyzer 사용)

. . . . .

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

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

① 네이티브 코드 미사용: ABI 설정 불필요, 모든 기기 지원

② 네이티브 코드 사용: 지원하는 ABI의 기기에서만 작동

③ 하위 호환성: 64비트 기기는 32비트 코드 실행 가능 (성능 저하)

---

마무리

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

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

특히 다음 사항들을 기억하시기 바랍니다.

① Google Play 64비트 요구사항: 2019년 8월부터 arm64-v8a 지원 필수

② AAB 우선 사용: Google Play 배포 시 AAB가 APK보다 유리

③ 빌드 타입별 전략: Debug는 개발 편의성, Release는 최적화 우선

④ 네이티브 라이브러리 확인: 써드파티 라이브러리의 ABI 지원 범위 체크

⑤ 실제 기기 테스트: 주요 ABI별로 실제 기기에서 테스트 필수

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

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

끝.