É fundamental manter um KMI estável para os módulos do fornecedor. O kernel GKI é construído e distribuído em formato binário e os módulos carregáveis pelo fornecedor são construídos em uma árvore separada. O kernel GKI resultante e os módulos do fornecedor devem funcionar como se fossem construídos juntos.
Geralmente, a comunidade Linux desaprova a noção de estabilidade ABI no kernel para o kernel principal. Diante de diferentes cadeias de ferramentas, configurações e um kernel Linux em constante evolução, não é viável manter um KMI estável na linha principal. No entanto, é possível manter um KMI estável no ambiente GKI altamente restrito com estas restrições:
Apenas uma única configuração,
gki_defconfig, pode ser usada para construir o kernel.O KMI só é estável dentro da mesma versão LTS e Android de um kernel, como
android13-5.10,android12-5.10ouandroid13-5.15.- Nenhuma estabilidade KMI é mantida para
android-mainline.
- Nenhuma estabilidade KMI é mantida para
Apenas a cadeia de ferramentas Clang específica fornecida no AOSP e definida para a ramificação correspondente é usada para construir o kernel e os módulos.
Apenas os símbolos conhecidos por serem usados pelos módulos conforme especificado em uma lista de símbolos são monitorados quanto à estabilidade e considerados símbolos KMI.
- O corolário é que os módulos do fornecedor devem usar apenas símbolos KMI. Essa restrição é imposta pela falha no carregamento do módulo se símbolos não KMI forem necessários.
Depois que a ramificação KMI é congelada, as alterações são permitidas, mas não podem interromper a KMI. Essas alterações incluem o seguinte:
- Alterações de configuração
- Alterações no código do kernel
- Alterações na cadeia de ferramentas (incluindo atualizações)
Use o processo de construção hermético e a cadeia de ferramentas LLVM
O processo de compilação hermético garante um repo estável fazendo com que manifestos de repositório no kernel/manifest descrevam completamente o ambiente de compilação. Por exemplo, o manifesto para android13-5.15 inclui a cadeia de ferramentas, scripts de compilação e tudo o mais necessário para compilar o kernel Generic Kernel Image (GKI). Os respectivos arquivos de configuração build.config , como o GKI build config build.config.gki.aarch64 , garantem que as ferramentas incluídas sejam usadas corretamente para gerar resultados de compilação consistentes.
O uso de um processo de compilação hermético também garante que a descrição da ABI para a árvore seja consistente, seja gerada pelo Google (por exemplo, abi_gki_aarch64.xml para android13-5.15 ou gerada em uma árvore local que inclui os módulos do fornecedor. As ferramentas para criar e comparar o A descrição da ABI para a Kernel Module Interface (KMI) também é fornecida como parte do repositório descrito pelo manifesto.
A cadeia de ferramentas usada para compilar o kernel GKI deve ser totalmente compatível com a cadeia de ferramentas usada para compilar os módulos do fornecedor. A partir do Android 10, todos os kernels do Android devem ser construídos com uma cadeia de ferramentas LLVM. Com o GKI, a cadeia de ferramentas LLVM usada para criar kernels de produtos e módulos de fornecedores deve gerar a mesma ABI que a cadeia de ferramentas LLVM do AOSP e os parceiros devem garantir que a KMI seja compatível com o kernel GKI. O uso das ferramentas de compilação fornecidas é fortemente recomendado, pois elas fornecem garantias de compatibilidade.
Qual é o próximo?
Para obter instruções sobre como construir o kernel usando o processo de construção hermético e a cadeia de ferramentas LLVM, consulte Build kernels .
Para obter instruções sobre como monitorar a ABI e corrigir problemas, consulte Monitoramento da ABI do kernel do Android