Os OEMs precisam mudar para a versão mais recente do car-ui-lib-plugin-apis
(1.2.0 ou mais recente) assim que possível. O ideal é que os OEMs não enviem nenhum plug-in
que use uma versão mais antiga.
Por que essa atualização?
As APIs Java 8+ são compatíveis com versões anteriores do Android pelo suporte à simplificação de APIs Java 8+. As implementações das APIs ausentes são compiladas em apps, e o bytecode dos APKs é reescrito para referenciar as implementações em vez das bibliotecas na plataforma.
Para carregar implementações de componentes de interface do usuário de um plugin da biblioteca Car UI,
é necessário referenciar métodos definidos por interfaces
car-ui-lib-plugin-apis
. Essas referências de método são feitas de apps para plugins da biblioteca Car UI
em tempo de execução, com a expectativa de que as assinaturas de método sejam idênticas nas implementações de app e
plugin.
Alguns sistemas de build ativam a remoção de açúcar sintático da API em todos os momentos devido aos requisitos de um
nível mínimo específico do SDK. As assinaturas de método dessintetizadas para
interfaces car-ui-lib-plugin-apis
podem não corresponder às de uma implementação
de plug-in OEM que não foi dessintetizada, o que faz com que os plug-ins não sejam
carregados.
Como resultado, alguns apps do GAS compilados com o sistema de build interno do Google são
incompatíveis com o plug-in da biblioteca Car UI. Por isso, removemos todas as
dependências das APIs Java 8 (e mais recentes) que exigem desaçucaramento. Essa mudança
requer atualizações na API das interfaces definidas por
car-ui-lib-plugin-apis
.
Etapas necessárias para plug-ins de OEM
Siga estas etapas para atualizar sua API:
Atualize a implementação do plug-in para usar a versão mais recente de
car-ui-lib-plugin-apis
. Para acessar a versão mais recente (1.2.0 ou mais recente), consulte o Repositório Maven do Google.Atualize a implementação do plug-in para implementar a interface
PluginFactoryOEMV4
. Essa mudança exige as seguintes etapas quando um componente é implementado pelo plug-in do OEM. Atualize a implementação do OEM de:Barra de ferramentas para implementar
ToolbarControllerOEMV2
.Itens da lista de conteúdo para estender
ContentListItemOEMV2
.Processamento de resultados da pesquisa do IME para estender
ImeSearchInterfaceOEMV2
.
Atualize o app para usar a versão mais recente da biblioteca Car UI.
O que acontece se essa atualização não for aplicada?
Se as etapas fornecidas nesta página não forem concluídas para um plug-in OEM, os apps desaçucarados, como o Google Automotive Services (GAS), não vão carregar implementações do plug-in da biblioteca Car UI, e nenhuma personalização do OEM será aplicada pelo mecanismo de plug-in.
As personalizações de RRO atuais para a biblioteca Car UI não são afetadas por esse problema e continuam funcionando normalmente.