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.

Esta página foi traduzida pela API Cloud Translation.

Extensões do SDK

O módulo SDK Extensions decide o nível do SDK da extensão do dispositivo e fornece APIs para os aplicativos consultarem o nível do SDK da extensão. Este módulo é atualizável, o que significa que pode receber atualizações de funcionalidades fora do ciclo normal de lançamento do Android.

As extensões do SDK são responsáveis por:

Decidir o nível do SDK da extensão do dispositivo.
Fornecendo APIs para aplicativos para consultar o nível do SDK da extensão.
(Iniciando o Android 12) Determinando os valores para as variáveis de ambiente BOOTCLASSPATH , DEX2OATBOOTCLASSPATH e SYSTEMSERVERCLASSPATH .

Formato do módulo

O módulo SDK Extensions ( com.android.sdkext ) está no formato APEX e está disponível para dispositivos com Android 11 ou superior.

Formato do pacote

O módulo SDK Extensions ( com.google.android.sdkext ) está no formato APEX e contém os seguintes componentes:

(Iniciando o Android 12) bin/derive_classpath : um binário nativo que é executado no início do processo de inicialização do dispositivo. Ele lê arquivos de configuração de caminho de classe individuais do sistema e outros módulos, os mescla e define a definição de variáveis de ambiente CLASSPATH .
bin/derive_sdk : Um binário nativo que é executado no início do processo de inicialização do dispositivo e lê metadados de outros módulos para definir as propriedades do sistema relacionadas à extensão SDK (por exemplo, build.version.extensions.r ).
javalib/framework-sdkextension.jar : Este arquivo está no bootclasspath que expõe as APIs aos aplicativos para consultar o nível do SDK da extensão.

Derivando o nível do SDK da extensão

O programa derive_sdk lê metadados armazenados como arquivos protobuf binários no etc/sdkinfo.binarypb sdkinfo.binarypb dentro de cada módulo APEX. Para detalhes sobre a estrutura do protobuf, consulte o arquivo protobuf .

Lendo o nível do SDK da extensão

O módulo SDK Extensions expõe uma classe java SdkExtensions no pacote android.os.ext . Use o getExtensionVersion(int) para ler a versão de uma extensão do SDK (por exemplo, getExtensionVersion(Build.VERSION_CODES.R) ).

Derivando caminhos de classe

O serviço derive_classpath lê e mescla arquivos de configuração individuais em /system/etc/classpaths/ e /apex/*/etc/classpaths/ . Cada configuração armazena a mensagem protobuf de classpaths.proto em um formato proto binário. O algoritmo de mesclagem exato que determina a ordem das entradas do caminho de classe é descrito em derive_classpath.cpp e pode mudar com o tempo.