A partir de 27 de março de 2025, recomendamos usar android-latest-release em vez de aosp-main para criar e contribuir com o AOSP. Para mais informações, consulte Mudanças no AOSP.
Ativar a opção de compatibilidade com 16 KB
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
O interruptor de 16 KB
permite executar um dispositivo com um kernel de 16 KB. A opção de compatibilidade
de 16 KB está disponível quando um dispositivo está sendo executado com um kernel de 16 KB. O
gerenciador de pacotes executa um app no modo de compatibilidade de 16 KB se o app tiver arquivos ELF (com uma extensão .so) com um alinhamento de segmento de LOAD de 4 KB ou
se o APK compactado tiver arquivos ELF descompactados alinhados a 4 KB. Se
o gerenciador de pacotes tiver ativado o modo de compatibilidade com 16 KB para um app, o app
vai mostrar um aviso quando for iniciado pela primeira vez informando que está sendo executado no
modo de compatibilidade com 16 KB.
Figura 1. Aviso no modo de compatibilidade de tamanho de página.
O modo de compatibilidade com 16 KB permite que alguns apps funcionem,
mas, para maior confiabilidade e estabilidade, os apps ainda precisam estar alinhados a 16 KB.
Para ativar a opção de compatibilidade com 16 KB, siga estas instruções:
Siga as etapas em Ativar o botão de 16 KB
para ativar o botão de 16 KB.
Ative o modo de compatibilidade com 16 KB usando um dos seguintes métodos:
O Android executa apps no modo de compatibilidade quando necessário. Há duas
partes separadas de compatibilidade com versões anteriores que podem ser ativadas de forma independente: a
propriedade bionic.linker.16kb.app_compat.enabled controla como as bibliotecas
são carregadas, e a propriedade pm.16kb.app_compat.disabled controla como
os APKs são instalados.
Para forçar a compatibilidade com 16 KB em todos os apps do dispositivo:
adb shell setprop bionic.linker.16kb.app_compat.enabled true
adb shell setprop pm.16kb.app_compat.disabled false
Para desativar a compatibilidade com 16 KB para todos os apps no dispositivo:
adb shell setprop bionic.linker.16kb.app_compat.enabled false
adb shell setprop pm.16kb.app_compat.disabled true
Defina a propriedade android:pageSizeCompat como enabled ou disabled para
ativar ou desativar o modo de compatibilidade com versões anteriores de um app específico no
AndroidManifest.xml. Quando essa propriedade é definida, o app não mostra
avisos do modo de compatibilidade com versões anteriores quando é iniciado.
Na página de informações do app, em Advanced, mude a configuração Run app with
page size compat mode para ativar ou desativar o modo de compatibilidade de 16 KB
para um app específico. Essa configuração só fica visível quando o dispositivo está em execução com
tamanho de página de 16 KB.
Figura 2. Configuração do modo de compatibilidade de tamanho da página.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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."]]
