Manter uma interface estável do módulo do kernel

É essencial manter uma interface estável do módulo do kernel (KMI, na sigla em inglês) para os módulos do fornecedor. O kernel da GKI é criado e enviado em formato binário, e os módulos de carregamento do fornecedor são criados em uma árvore separada. O kernel e os módulos do fornecedor do GKI resultantes precisam funcionar como se tivessem sido criados juntos.

Em geral, a comunidade do Linux não aceita a noção de estabilidade da ABI no kernel para o kernel principal. Diante de diferentes toolchains, configurações e um kernel principal do Linux em constante evolução, não é viável manter um KMI estável no mainline. No entanto, é possível manter um KMI estável no ambiente de GKI com muitas restrições com estas restrições:

  • Apenas uma única configuração, gki_defconfig, pode ser usada para criar o kernel.

  • O KMI só é estável na mesma versão LTS e Android de um kernel, como android14-6.1, android15-6.6 ou android16-6.12.

    • Não há estabilidade do KMI para android-mainline.

  • Somente a cadeia de ferramentas Clang específica fornecida no AOSP e definida para a ramificação correspondente é usada para criar o kernel e os módulos.

  • Somente os símbolos conhecidos por serem usados por módulos, conforme especificado em uma lista de símbolos, são monitorados quanto à estabilidade e considerados símbolos de KMI.

    • O corolário é que os módulos do fornecedor precisam usar apenas símbolos KMI. Essa restrição é aplicada ao falhar em carregamentos de módulo se símbolos que não são do KMI forem necessários.

  • Depois que a ramificação da KMI é congelada, as mudanças são permitidas, mas não podem interromper a KMI. Essas mudanças incluem:

    • Mudanças de configuração
    • Mudanças no código do kernel
    • Mudanças na cadeia de ferramentas (incluindo atualizações)

Usar o processo de build hermético e o conjunto de ferramentas LLVM

O processo de build hermético garante um KMI estável com a descrição completa do ambiente de build em manifestos repo em kernel/manifest. Por exemplo, o manifesto para android16-6.12 inclui o conjunto de ferramentas, o sistema de build e tudo o que é necessário para criar a imagem genérica do kernel (GKI). A configuração do build, principalmente BUILD.bazel, garante que as ferramentas incluídas sejam usadas corretamente para gerar resultados de build consistentes.

O uso de um processo de build hermético também garante que a descrição da ABI para a árvore seja consistente, seja gerada pelo Google (por exemplo, gki/aarch64/abi.stg para android16-6.12) ou gerada em uma árvore local que inclui os módulos do fornecedor. As ferramentas para criar e comparar a descrição da ABI para a Interface de Módulo do Kernel (KMI, na sigla em inglês) também são fornecidas como parte do repositório descrito pelo manifesto.

A cadeia de ferramentas usada para criar o kernel do GKI precisa ser totalmente compatível com a cadeia de ferramentas usada para criar módulos do fornecedor. A partir do Android 10, todos os kernels do Android precisam ser criados com uma cadeia de ferramentas LLVM. Com o GKI, o conjunto de ferramentas LLVM usado para criar kernels de produtos e módulos de fornecedores precisa gerar a mesma ABI que o conjunto de ferramentas LLVM do AOSP, e os parceiros precisam garantir que o KMI seja compatível com o kernel do GKI. É altamente recomendável usar as ferramentas de build fornecidas, porque elas oferecem a melhor compatibilidade.

Quais são as próximas etapas?