2025년 3월 27일부터 AOSP를 빌드하고 기여하려면 aosp-main
대신 android-latest-release
를 사용하는 것이 좋습니다. 자세한 내용은 AOSP 변경사항을 참고하세요.
16KB 하위 호환성 옵션 사용 설정
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
16KB 전환을 사용하면 16KB 커널로 기기를 실행할 수 있습니다. 16KB 백호환 옵션은 기기가 16KB 커널로 실행 중일 때 사용할 수 있습니다. 앱에 LOAD 세그먼트 정렬이 4KB인 ELF 파일 (.so
확장자가 있음)이 있거나 압축된 APK에 4KB ZIP 정렬된 압축되지 않은 ELF 파일이 있는 경우 패키지 관리자는 16KB 백호환 모드로 앱을 실행합니다. 패키지 관리자가 앱에 16KB 백호환 모드를 사용 설정한 경우 앱이 처음 실행될 때 16KB 백호환 모드로 실행되고 있다고 경고를 표시합니다.
그림 1. 페이지 크기 호환 모드의 경고
16KB 백호환성 모드를 사용하면 일부 앱이 작동하지만 최상의 안정성과 안정성을 위해 앱은 여전히 16KB로 정렬되어야 합니다.
16KB 백호환 옵션을 사용 설정하려면 다음 안내를 따르세요.
16KB 전환 사용 설정의 단계에 따라 16KB 전환을 사용 설정합니다.
다음 방법 중 하나를 사용하여 16KB 백호환 모드를 사용 설정합니다.
Android는 필요한 경우 백호환성 모드로 앱을 실행합니다. 백호환에는 독립적으로 사용 설정할 수 있는 두 가지 섹션이 있습니다. bionic.linker.16kb.app_compat.enabled
속성은 라이브러리가 로드되는 방식을 제어하고 pm.16kb.app_compat.disabled
속성은 APK가 설치되는 방식을 제어합니다.
기기의 모든 앱에 16KB 백호환성을 강제로 사용 설정하려면 다음 단계를 따르세요.
adb shell setprop bionic.linker.16kb.app_compat.enabled true
adb shell setprop pm.16kb.app_compat.disabled false
기기의 모든 앱에서 16KB 백호환성을 강제로 사용 중지하려면 다음 단계를 따르세요.
adb shell setprop bionic.linker.16kb.app_compat.enabled false
adb shell setprop pm.16kb.app_compat.disabled true
android:pageSizeCompat
속성을 enabled
또는 disabled
로 설정하여 AndroidManifest.xml
에서 특정 앱의 백호환 모드를 사용 설정하거나 중지합니다. 이 속성이 설정되면 앱이 실행될 때 백호환성 모드 경고가 표시되지 않습니다.
앱 정보 페이지의 고급에서 페이지 크기 호환 모드로 앱 실행 설정을 전환하여 특정 앱의 16KB 백호환 모드를 사용 설정 또는 사용 중지합니다. 이 설정은 기기가 16KB 페이지 크기로 실행 중일 때만 표시됩니다.
그림 2. 페이지 크기 호환 모드 설정
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["필요한 정보가 없음","missingTheInformationINeed","thumb-down"],["너무 복잡함/단계 수가 너무 많음","tooComplicatedTooManySteps","thumb-down"],["오래됨","outOfDate","thumb-down"],["번역 문제","translationIssue","thumb-down"],["샘플/코드 문제","samplesCodeIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-07-27(UTC)"],[],[],null,["# Enable 16 KB backcompat option\n\n[16 KB toggle](/docs/core/architecture/16kb-page-size/16kb-developer-option)\nlets you to run a device with a 16 KB kernel. The 16 KB backcompat\noption is available when a device is running with a 16 KB kernel. The\npackage manager runs an app in 16 KB backcompat mode if the app has ELF\nfiles (with an `.so` extension) with a LOAD segment alignment of 4 KB, or\nif the zipped APK has uncompressed ELF files that are 4 KB zip aligned. If\nthe package manager has enabled 16 KB backcompat mode for an app, the app\ndisplays a warning when it's first launched saying that it's running in\n16 KB backcompat mode.\n\n**Figure 1.** Warning in page size compat mode.\n\n16 KB backcompat mode allows some apps to work,\nbut for best reliability and stability, apps should still be 16 KB aligned.\n\nTo enable the 16 KB backcompat option, follow these instructions:\n\n1. Follow the steps in [Enable 16 KB toggle](/docs/core/architecture/16kb-page-size/16kb-developer-option)\n to enable 16 KB toggle.\n\n2. Enable 16 KB backcompat mode using any of the following methods:\n\n - Android runs apps in backcompat mode where it is needed. There are two\n separate parts to backcompat that can be enabled independently: the\n `bionic.linker.16kb.app_compat.enabled` property controls how libraries\n are loaded, and the `pm.16kb.app_compat.disabled` property controls how\n APKs are installed.\n\n - To force 16 KB backcompat on for every app on the device:\n\n adb shell setprop bionic.linker.16kb.app_compat.enabled true\n adb shell setprop pm.16kb.app_compat.disabled false\n\n - To force 16 KB backcompat off for every app on the device:\n\n adb shell setprop bionic.linker.16kb.app_compat.enabled false\n adb shell setprop pm.16kb.app_compat.disabled true\n\n - Set the `android:pageSizeCompat` property to `enabled` or `disabled` to\n turn on or off backcompat mode for a specific app in its\n `AndroidManifest.xml`. When this property is set, the app won't display\n backcompat mode warnings when it launches.\n\n - On the app info page, under **Advanced** toggle the setting **Run app with\n page size compat mode** to enable or disable the 16 KB backcompat mode\n for specific app. This setting is only visible when the device is running with\n 16 KB page size.\n\n **Figure 2.** Page size compat mode setting."]]