A partir del 27 de marzo de 2025, te recomendamos que uses android-latest-release
en lugar de aosp-main
para compilar y contribuir a AOSP. Para obtener más información, consulta Cambios en AOSP.
Activar el botón de activación de 16 KB
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
El botón de activación de 16 KB te permite probar un kernel de 16 KB. Este botón de activación cambia entre un kernel de 4 KB y uno de 16 KB, y se puede encontrar en el menú "Opción para desarrolladores" de la app de configuración. El botón de activación de 16 KB se puede usar para verificar la compatibilidad de la aplicación con el kernel de 16 KB, pero es posible que no refleje el rendimiento del dispositivo real de 16 KB debido al uso de bloques de subpáginas (cuando se usa EXT4 para particiones /data
y /metadata
) en el modo de 16 KB.
Pasos para configurar el botón de activación
Asegúrate de que el dispositivo haya configurado las variables para que sean independientes de la página (para que funcionen con kernels de tamaño de página de 4 KB y 16 KB).
Te recomendamos que instales el kernel de 16 K directamente para asegurarte de que el dispositivo funcione en el modo de 16 KB antes de continuar con la adición de la opción para desarrolladores.
Consulta el ejemplo de configuración de destino del dispositivo virtual.
PRODUCT_NO_BIONIC_PAGE_SIZE_MACRO := true
PRODUCT_MAX_PAGE_SIZE_SUPPORTED := 16384
Configura la variable del producto para mostrar la opción para desarrolladores en la configuración
PRODUCT_16K_DEVELOPER_OPTION := true
Configura la ruta del kernel con BOARD_KERNEL_PATH_16K
.
Este kernel se debe compilar con CONFIG_ARM64_16K_PAGES=y.
.
BOARD_KERNEL_PATH_16K := kernel/prebuilts/mainline/$(TARGET_KERNEL_ARCH)/16k/kernel-mainline.
Establece la variable de ruta de configuración de los módulos BOARD_KERNEL_MODULES_16K
. Esta variable apunta a módulos de kernel que admiten 16 KB. Si configuras estos parámetros, se crean dos OTA en la partición del sistema : boot_ota_16k.zip
(para cambiar al kernel de 16 KB) y boot_ota_4k.zip
(para cambiar al kernel de 4 KB). Para habilitar las actualizaciones OTA incrementales, configura BOARD_16K_OTA_USE_INCREMENTAL := true
para las actualizaciones OTA de arranque de tamaño más pequeño.
BOARD_KERNEL_MODULES_16K += $(wildcard kernel/prebuilts/mainline/$(TARGET_KERNEL_ARCH)/16k/*.ko)
BOARD_KERNEL_MODULES_16K += $(wildcard kernel/prebuilts/common-modules/virtual-device/mainline/$(TARGET_KERNEL_ARCH)/16k/*.ko)
Establece BOARD_16K_OTA_MOVE_VENDOR := true
para mover las actualizaciones OTA a la partición del proveedor.
Solo configúralo para mover las actualizaciones OTA del sistema a la partición del proveedor.
Verificación
Después de configurar correctamente el botón de activación, sigue estos pasos:
- Verifica si el botón de activación Iniciar en tamaño de página 16 KB se puede ver en la app de configuración.
- Comprueba si
/system/boot_otas
o /vendor/boot_otas
contiene dos archivos ZIP OTA : boot_ota_16k.zip
y boot_ota_4k.zip
.
Usa el botón de activación de 16 KB
- Ve a Configuración > Sistema > Actualizaciones de software y aplica las actualizaciones disponibles.
- Habilita las opciones para desarrolladores. Para obtener instrucciones, consulta Cómo configurar las opciones para desarrolladores en el dispositivo.
- Si se detecta que el dispositivo está bloqueado por el OEM, aparecerá un diálogo en el que se te pedirá que desbloquees el teléfono con el OEM. Para obtener instrucciones, consulta Cómo bloquear y desbloquear el bootloader.
- Haz clic en Boot with 16 KB page size. Si
/data
y /metadata
no son ext4, aparecerá un diálogo en el que se te pedirá que borres el dispositivo. Haz clic en Borrar todos los datos para limpiar el dispositivo. Se borrará el dispositivo y deberás volver a habilitar las opciones para desarrolladores.
- Haz clic en Boot with 16 KB page size. Aparecerá un diálogo en el que se te pedirá que cambies a 16 KB y, cuando confirmes, se aplicarán las actualizaciones OTA de inicio. Luego, puedes cambiar entre los modos de 4 KB y 16 KB sin borrar la partición de datos para probar el comportamiento de la app.
Cómo verificar el modo de 16 KB
Sigue los pasos que se indican en Cómo obtener el tamaño de la página para verificarlo.
El contenido y las muestras de código que aparecen en esta página están sujetas a las licencias que se describen en la Licencia de Contenido. Java y OpenJDK son marcas registradas de Oracle o sus afiliados.
Última actualización: 2025-07-27 (UTC)
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Falta la información que necesito","missingTheInformationINeed","thumb-down"],["Muy complicado o demasiados pasos","tooComplicatedTooManySteps","thumb-down"],["Desactualizado","outOfDate","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Problema con las muestras o los códigos","samplesCodeIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-07-27 (UTC)"],[],[],null,["# Enable 16 KB toggle\n\n16 KB toggle lets you to try a 16 KB kernel. This toggle switches\nbetween a 4 KB kernel and 16 KB kernel and can be found inside the\n\"Developer option\" menu in the settings app. The 16 KB toggle can be used\nto check application compatibility with the 16 KB kernel, but it might not\nreflect performance of actual 16 KB device due to the use of subpage blocks\n(when using EXT4 for `/data` and `/metadata` partitions) in 16 KB mode.\n\nSteps for configuring toggle\n----------------------------\n\n1. Make sure the device has set up the variables to be page-agnostic (to work\n with both 4 KB and 16 KB page size kernels).\n You may want to install the 16k kernel directly to make sure the device works in\n 16 KB mode directly before continuing to add the developer option.\n See the virtual device example [target config](https://cs.android.com/android/platform/superproject/+/android-latest-release:device/google/cuttlefish/vsoc_arm64_pgagnostic/phone/aosp_cf.mk;l=68).\n\n PRODUCT_NO_BIONIC_PAGE_SIZE_MACRO := true\n PRODUCT_MAX_PAGE_SIZE_SUPPORTED := 16384\n\n2. Setup product variable to display developer option in settings\n `PRODUCT_16K_DEVELOPER_OPTION := true`\n\n3. Set kernel path using `BOARD_KERNEL_PATH_16K`.\n This kernel should be built with `CONFIG_ARM64_16K_PAGES=y.`\n\n BOARD_KERNEL_PATH_16K := kernel/prebuilts/mainline/$(TARGET_KERNEL_ARCH)/16k/kernel-mainline.\n\n4. Set modules config path variable `BOARD_KERNEL_MODULES_16K`. This variable\n points to kernel modules which support 16KB. Setting these parameters creates\n two OTAs on the system partition : `boot_ota_16k.zip`(to switch to 16 KB\n kernel) and `boot_ota_4k.zip`(to switch to 4 KB kernel). Enable incremental\n OTAs by setting `BOARD_16K_OTA_USE_INCREMENTAL := true` for smaller size boot\n OTAs.\n\n BOARD_KERNEL_MODULES_16K += $(wildcard kernel/prebuilts/mainline/$(TARGET_KERNEL_ARCH)/16k/*.ko)\n BOARD_KERNEL_MODULES_16K += $(wildcard kernel/prebuilts/common-modules/virtual-device/mainline/$(TARGET_KERNEL_ARCH)/16k/*.ko)\n\n5. Set `BOARD_16K_OTA_MOVE_VENDOR := true` to move OTAs to the vendor partition.\n Only set this to move OTAs from system to vendor partition.\n\n### Verification\n\nAfter successfully configuring the toggle, follow these steps:\n\n1. Check if **Boot with 16 KB page size** toggle is visible in settings app.\n2. Check if `/system/boot_otas` or `/vendor/boot_otas` contains two OTA zip files : `boot_ota_16k.zip` and `boot_ota_4k.zip`.\n\nUse 16 KB toggle\n----------------\n\n1. Go to **Settings \\\u003e System \\\u003e Software updates** and apply any updates which are available.\n2. Enable developer options. For instructions, see [Configure on-device developer options](https://developer.android.com/studio/debug/dev-options).\n3. If the device is detected as OEM locked, a dialog displays asking you to OEM unlock the phone. For instructions, see [Lock and unlock the bootloader](/docs/core/architecture/bootloader/locking_unlocking).\n4. Click **Boot with 16 KB page size** . If `/data` and `/metadata`aren't ext4, a dialog displays asking you to wipe the device. Click **Erase all data** to wipe the device. The device is wiped and you must enable developer options again.\n5. Click **Boot with 16 KB page size**. A dialog displays asking you to switch to 16 KB, and on confirming, boot OTAs are applied. You can then toggle back and forth between 4 KB and 16 KB mode without clearing the data partition to test app behavior.\n\nCheck 16 KB Mode\n----------------\n\nFollow steps at [getting page size](/docs/core/architecture/16kb-page-size/getting-page-size)\nto verify page size."]]