앱 개발

안드로이드 16KB 페이지 크기 대응, 구글 플레이 기준과 점검 순서

안드로이드 16KB 페이지 크기 대응, 구글 플레이 기준과 점검 순서

안드로이드 16KB 페이지 크기 대응, 구글 플레이 기준과 점검 순서

안드로이드 15 이상을 타깃으로 하는 앱은 64비트 기기에서 16KB 메모리 페이지를 지원해야 하고, 2027년 2월 1일부터 지원하지 않는 업데이트는 구글 플레이에 낼 수 없습니다. 영향받는 앱과 점검, 수정 방법을 다룹니다.

안드로이드 15 이상을 타깃으로 하는 앱은 64비트 기기에서 16KB 메모리 페이지를 지원해야 하고, 2027년 2월 1일부터 지원하지 않는 업데이트는 구글 플레이에 낼 수 없습니다. 영향받는 앱과 점검, 수정 방법을 다룹니다.

7분 소요

7분 소요

안드로이드 15 이상을 타깃으로 하는 앱은 구글 플레이에서 64비트 기기의 16KB 메모리 페이지를 지원해야 합니다. Android Developers 문서에는 2027년 2월 1일부터 16KB를 지원하지 않는 앱 업데이트는 출시할 수 없다고 적혀 있습니다. 영향을 받는 쪽은 C, C++로 만든 네이티브 라이브러리(.so 파일)가 들어간 앱이고, Java와 Kotlin 코드만 있는 앱은 따로 할 일이 없습니다.

안드로이드 16KB 페이지 크기 대응, 구글 플레이 기준과 점검 순서 대표 이미지

올해 8월 31일부터 구글 플레이 업데이트는 타깃 API 36(안드로이드 16) 이상이어야 나갈 수 있습니다. 그러니 지금 업데이트를 내는 앱은 모두 "안드로이드 15 이상 타깃"에 들어가고, 16KB 기준도 모든 업데이트에 걸린다고 보면 됩니다. 타깃 API 요건 자체는 타겟 API 36 대응 글에서 다뤘습니다.

16KB 페이지가 왜 생겼나

메모리 페이지는 운영체제가 메모리를 나눠 관리하는 단위입니다. 안드로이드는 오랫동안 4KB 하나만 썼는데, 안드로이드 15부터 16KB로 설정된 기기도 지원합니다. 메모리가 큰 기기일수록 16KB가 유리해서 제조사들이 점점 이쪽으로 옮겨 갈 것이라는 게 Google의 설명입니다.

Google이 공개한 초기 시험 결과로는 메모리가 부족한 상황에서 앱 실행 시간이 평균 3.16% 줄었고, 앱 실행 중 전력 소모는 평균 4.56% 줄었습니다. 대신 기기 전체의 평균 메모리 사용량은 조금 늘어납니다.

일정은 한 번 바뀌었습니다. 2025년 5월 Android 개발자 블로그는 2025년 11월 1일부터 안드로이드 15 이상을 타깃으로 하는 새 앱과 업데이트에 16KB 지원을 요구한다고 알렸습니다. 지금 공식 문서에 적힌 업데이트 기준일은 2027년 2월 1일입니다. 날짜는 Play Console 경고 문구로 한 번 더 보는 것이 안전합니다.

우리 앱이 영향받는지 가르는 기준

공식 문서는 아래 셋 중 하나라도 해당하면 네이티브 코드를 쓰는 앱으로 봅니다.

  • 앱에 C, C++ 코드가 있거나 Android NDK를 씀
  • 네이티브 라이브러리를 품은 외부 SDK를 씀
  • 기기에서 네이티브 라이브러리를 쓰는 앱 빌더로 만든 앱

두 번째가 가장 흔합니다. 직접 쓴 코드는 Kotlin뿐이어도 지도, 결제 보안, 영상 재생, 얼굴 인식, 암호화 SDK가 .so 파일을 갖고 들어오는 경우가 많습니다. Flutter와 React Native 앱은 프레임워크 자체가 네이티브 라이브러리를 쓰기 때문에 거의 다 대상입니다.

확인하는 방법

가장 쉬운 방법은 Android Studio의 APK Analyzer입니다. Build 메뉴의 Analyze APK에서 APK를 열고 lib 폴더를 봅니다. .so 파일이 없으면 네이티브 코드가 없는 앱이고, 있으면 Alignment 열에 정렬 문제가 경고로 표시됩니다.

명령줄로 보려면 Android SDK Build-Tools 35.0.0 이상이 필요합니다.

  • zipalign -c -P 16 -v 4 앱.apk 결과 마지막 줄에 Verification successful이 나오면 통과
  • check_elf_alignment.sh 앱.apk 결과 arm64-v8a 라이브러리가 모두 ALIGNED면 통과
  • llvm-objdump -p 파일.so의 LOAD 줄에서 align 값이 2**14 이상이면 통과
  • bundletool dump config --bundle=앱.aab 결과에 PAGE_ALIGNMENT_16K가 보이면 번들이 16KB 정렬을 요청하는 상태

이미 Play Console에 올린 앱이라면 앱 번들 탐색기 화면에서 빌드가 기준을 충족하는지 볼 수 있습니다. Google 블로그도 여기서 먼저 보라고 안내합니다.

고치는 방법은 도구 버전부터

공식 문서 기준으로 AGP(Android Gradle Plugin) 8.5.1 이상과 NDK r28 이상을 쓰고, 미리 빌드된 라이브러리가 모두 16KB를 지원하면 기본 설정만으로 대응이 끝납니다. 이 조건에서 빠지는 부분이 있을 때만 아래 작업이 필요합니다.

  • 직접 빌드하는 .so가 NDK r27 이하라면 링커 옵션 -Wl,-z,max-page-size=16384와 -Wl,-z,common-page-size=16384를 넣어 다시 빌드
  • 외부에서 받은 .so는 같은 방식으로 다시 빌드하거나 16KB를 지원하는 버전으로 교체
  • 코드 안에 4KB(4096)를 가정한 계산이나 PAGE_SIZE 상수가 있으면 getpagesize() 또는 sysconf(_SC_PAGESIZE)로 변경

AGP 8.3에서 8.5 사이는 조심해야 합니다. 공식 문서에 따르면 이 버전은 기본으로 16KB 정렬을 하지만 bundletool이 APK를 zipalign하지 않습니다. 그래서 내 컴퓨터에서 바로 설치한 앱은 문제가 없어 보여도, 구글 플레이가 번들에서 만든 APK는 설치되지 않을 수 있습니다. 개발 환경에서 잘 돌았다는 것만으로 안심하면 안 되는 이유입니다.

정렬이 맞아도 RELRO라는 보안 영역의 끝이 16KB 경계에 맞지 않으면, 16KB 기기에서 쓰기 가능한 데이터까지 읽기 전용이 되어 앱이 SIGSEGV로 종료될 수 있습니다. 문서는 NDK r27 이하로 관련 옵션 없이 빌드한 .so에서 이런 일이 생긴다고 설명합니다. APK Analyzer에서 RELRO 정렬 상태도 함께 보입니다.

React Native는 0.77 릴리스 글에서 16KB 페이지를 완전히 지원한다고 밝혔습니다. 그보다 낮은 버전이라면 React Native 업그레이드가 먼저입니다. Flutter는 엔진 외에 네이티브 코드를 가진 플러그인이 많아서, 쓰고 있는 플러그인마다 변경 기록에서 16KB 지원 버전을 찾아 올려야 합니다. 공식 문서도 SDK마다 제공사 사이트에서 16KB 지원 버전을 보라고 안내합니다.

16KB 기기에서 직접 돌려 봅니다

빌드가 통과해도 실제 기기 동작은 따로 봐야 합니다. 시험 환경은 두 가지가 편합니다.

  • 에뮬레이터: SDK Manager에서 Google APIs Experimental 16 KB Page Size 시스템 이미지를 받아 가상 기기를 만듦
  • 실제 기기: Pixel 8, 8 Pro, 8a(안드로이드 15 QPR1 이상)와 Pixel 9, 9 Pro, 9 Pro XL(안드로이드 15 QPR2 이상)은 개발자 옵션의 Boot with 16KB page size로 16KB 모드 부팅 가능

adb shell getconf PAGE_SIZE 결과가 16384면 16KB 환경입니다. 이 상태에서 정렬이 안 된 앱을 실행하면 호환 모드로 돌면서 처음 실행할 때 경고창이 뜹니다. 호환 모드로 돌아가는 앱도 있지만, Google은 안정성을 위해 16KB 정렬을 하라고 권합니다.

저희는 안드로이드 업데이트 전에 이 순서로 봅니다.

  1. APK Analyzer로 .so 파일 목록과 정렬 경고를 뽑습니다.
  2. 경고가 난 라이브러리가 어느 SDK에서 왔는지 찾아 16KB 지원 버전으로 올립니다.
  3. AGP와 NDK 버전을 맞춘 뒤 zipalign 검사를 통과시킵니다.
  4. 16KB 에뮬레이터에서 로그인, 결제, 카메라처럼 SDK가 들어간 화면을 실행해 봅니다.

다른 구글 플레이 일정은 2026년 구글 플레이 정책 글에 날짜순으로 있습니다.

자주 묻는 질문

Kotlin으로만 만든 앱도 16KB 대응을 해야 하나요?

앱 코드와 라이브러리, SDK가 모두 Java나 Kotlin이라면 이미 16KB 기기를 지원합니다. 다만 외부 SDK가 네이티브 라이브러리를 품고 있는 경우가 많으니 APK Analyzer로 lib 폴더에 .so 파일이 있는지 한 번 보는 것이 좋습니다.

16KB를 지원하지 않으면 지금 올라가 있는 앱이 내려가나요?

공식 문서가 막는 것은 2027년 2월 1일 이후의 앱 업데이트 출시입니다. 이미 올라간 앱이 지워진다는 내용은 없습니다. 다만 업데이트를 낼 수 없으니 보안 수정이나 정책 대응도 함께 막힙니다.

Flutter 앱은 무엇을 올려야 하나요?

Flutter 버전과 함께 네이티브 코드를 가진 플러그인을 각각 16KB 지원 버전으로 올려야 합니다. 플러그인 하나라도 정렬이 안 된 .so를 갖고 있으면 앱 전체가 기준을 통과하지 못합니다.

16KB 기기가 없으면 어떻게 시험하나요?

Android Studio에서 16KB 페이지 크기 시스템 이미지로 에뮬레이터를 만들면 됩니다. Pixel 8 이후 일부 기기는 개발자 옵션에서 16KB 모드로 부팅할 수 있습니다.

운영 중인 안드로이드 앱의 16KB 대응이나 SDK 정리가 필요하시면 상담 페이지로 앱 이름과 쓰고 있는 주요 SDK를 알려 주세요.

앱 개발이 고민되시나요?
앱 개발이 고민되시나요?

기획부터 출시까지, 모바일파트너스가 함께합니다