KappS 지식 베이스 · FAQ

16KB 메모리 페이지 크기 요건

FAQ 기술 컴플라이언스

1. Google Play은 Android 15(API 레벨 35) 이상을 타깃으로 하는 앱이 64비트 기기에서 16KB 메모리 페이지 크기를 지원하도록 요구합니다 — 이는 매년 갱신되는 타깃 API 레벨 상향(2026년 8월 31일부터 신규 제출은 API 36)과는 별개의 호환성 규칙입니다.

2. Java 또는 Kotlin으로만 작성된 앱은 함께 포함된 모든 라이브러리와 SDK를 포함해 이미 규정을 준수합니다. 이 규칙은 아티팩트에 네이티브 코드(NDK/C/C++, 서드파티 .so, 또는 기기에서 네이티브 라이브러리를 패키징하는 앱 빌더)가 포함될 때 적용됩니다.

3. Android Gradle 플러그인 8.5.1 이상과 NDK r28 이상으로 네이티브 코드를 다시 빌드해 모든 ELF LOAD 세그먼트가 2^14(16KB) 정렬되도록 하세요. API 36을 타깃으로 해도 사전 빌드된 .so 파일 하나가 4KB 정렬이면 이 검사에서 탈락할 수 있습니다.

4. 업로드 전에 Android Studio APK Analyzer → lib/를 열고 Alignment 열을 확인하세요. 공유 객체에 경고가 하나라도 있으면 해당 번들은 16KB 대응이 되지 않은 것입니다. Play Console도 PAGE_ALIGNMENT_16K가 실패하면 "앱이 16KB 메모리 페이지 크기를 지원해야 합니다"라고 표시합니다.

5. 에뮬레이터에서 16KB Android 15+ 시스템 이미지로 테스트하세요. 4KB 기기에서만 실행되던 라이브러리는 Play 등록정보가 정상으로 보여도 16KB 하드웨어에서 로드에 실패하거나 크래시가 발생할 수 있습니다.

6. 서드파티 SDK가 흔한 문제입니다. 분석, 광고, 결제, 게임 엔진은 오래된 .so 파일을 포함하는 경우가 많습니다. 각 벤더의 16KB 호환 버전을 확인하고, 재빌드가 불가능한 것은 모두 교체하세요.

7. 모든 트랙(내부 테스트, 비공개 테스트, 프로덕션)에서 APK Analyzer를 다시 실행하세요. 단 하나의 트랙에 남은 네이티브 종속성이 있으면, Play가 해당 아티팩트에 16KB 요건을 시행하는 순간 업데이트 전체가 차단될 수 있습니다.