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.
Diretrizes de personalização
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
A implementação do discador incluída no AOSP oferece um tema e uma estrutura de base que podem ser adotados
como estão ou modificados.
Na tabela abaixo, as descrições de "SHOULD" e "MAY" são de acordo com o padrão IETF definido
em Palavras-chave para uso em RFCs para
indicar níveis de requisito (RFC 2119), o mesmo padrão usado na
definição de compatibilidade do Android 10.
Diretrizes de personalização
É possível adaptar ou modificar o tema e a estrutura de base de acordo com as restrições mencionadas abaixo.
A tabela a seguir descreve
as responsabilidades do OEM em relação à personalização.
Personalização |
Descrição |
DEVE |
Comportamentos ou interfaces que podem ser personalizados:
- Ajustar o tema e o estilo geral usando uma sobreposição de recursos
- Paleta de cores
- Dimensionamento
- Aparência do texto
- Aparência do widget
- Aparência da caixa de diálogo
- Drawables
- Ativar ou desativar um recurso restrito por uma configuração ou mudar parâmetros configurados por
recursos
|
MAIO |
Comportamentos ou interfaces que o Google recomenda para uma experiência ideal do usuário, mas não
aplica.
- Modifique as regras de resposta adaptativa.
- Modifique a estrutura de IU de alto nível do discador. O componente de interface do layout precisa seguir as
restrições de experiência do usuário.
|
O discador pertence a um conjunto de apps do sistema (incluindo Media, Notification Center e
App Launcher), que compartilham estilos e recursos comuns definidos em diferentes níveis na
estrutura do AOSP:
-
framework/base/core
Todos os estilos básicos do Android são definidos aqui. Especificamente, todos os temas de apps do sistema são
baseados em Theme.DeviceDefault
, o tema projetado para uso por OEMs para personalizar
a aparência padrão do dispositivo.
-
packages/services/Car/car_product/overlay
Essa pasta contém substituições para Theme.DeviceDefault
, que são usadas para produzir
a aparência do AOSP do Android Automotive. Os OEMs podem optar por excluir essa sobreposição e
usar a própria
em vez disso.
-
packages/apps/Car/libs/car-apps-common
Cores e estilos comuns compartilhados entre os apps do sistema fornecidos pelo AOSP. Esses elementos podem
ser personalizados pelos OEMs usando sobreposições em
path/to/overlay/packages/apps/Car/libs/car-apps-common
.
-
packages/apps/Car/Dialer
O discador usa o próprio tema, que se estende de Theme.DeviceDefault
(definido em
framework/base
). Os layouts, cores, estilos e outros recursos do discador também
podem ser personalizados usando uma sobreposição. Assim como o libs
mencionado
acima, a substituição de recursos pode ser localizada em
path/to/overlay/packages/apps/Car/Dialer
.
Mais documentação
Para mais informações sobre temas e sobreposições do AOSP, consulte
Personalizar o build com sobreposições
de recursos.
O conteúdo e os exemplos de código nesta página estão sujeitos às licenças descritas na Licença de conteúdo. Java e OpenJDK são marcas registradas da Oracle e/ou suas afiliadas.
Última atualização 2025-07-27 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-07-27 UTC."],[],[],null,["# Customization guidelines\n\nThe Dialer implementation included in AOSP provides a base theme and structure you can adopt as\nis or modify.\n\nIn the table below, the descriptions of \"SHOULD\" and \"MAY\" are per the IETF standard defined\nin [Key words for use in RFCs to\nIndicate Requirement Levels (RFC 2119)](http://www.ietf.org/rfc/rfc2119.txt), the same standard used in the\n[Android 10 Compatibility Definition](/docs/compatibility/10/android-10-cdd).\n\nCustomization guidelines\n------------------------\n\nYou can adapt or modify the base theme and structure as per the restrictions mentioned below.\nThe following table describes\nthe OEM responsibilities regarding customization.\n\n| Customization | Description |\n|---------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| **SHOULD** | Behaviors or interfaces that may be customized: - Adjust overall theming and styling through a resource overlay - Color pallette - Sizing - Text appearance - Widget appearance - Dialog appearance - Drawables - Enable or disable a feature gated by a config or change parameters configured by resources |\n| **MAY** | Behaviors or interfaces Google recommends for an optimal user experience, but does not enforce. - Modify adaptive-responsive rules. - Modify the high-level UI structure of Dialer. The Layout UI component must follow the User Experience Restrictions. |\n\nDialer belongs to a suite of system apps (including Media, Notification Center, and\nApp Launcher), all of which share common styles and assets that are defined at different levels in\nthe AOSP structure:\n\n- `framework/base/core` \n\n All Android base styles are defined here. Specifically, all system app themes are\n based on `Theme.DeviceDefault`, the theme designed for use by OEMs to customize\n device default appearance.\n\n- `packages/services/Car/car_product/overlay` \n\n This folder contains overrides to `Theme.DeviceDefault` which are used to produce\n the AOSP look and feel of Android Automotive. OEMs might opt for excluding this overlay and\n use their own\n instead.\n\n- `packages/apps/Car/libs/car-apps-common` \n\n Common colors and styles shared among AOSP provided system apps. These elements can\n be customized by OEMs using overlays under\n `path/to/overlay/packages/apps/Car/libs/car-apps-common`.\n\n- `packages/apps/Car/Dialer` \n\n Dialer uses its own theme, which extends from `Theme.DeviceDefault` (defined in\n `framework/base`). The layouts, colors, styles, and other resources of Dialer can\n also be customized through the use of an Overlay. Similar to `libs` mentioned\n above, the resource override can be located in\n `path/to/overlay/packages/apps/Car/Dialer`.\n\nMore documentation\n------------------\n\nFor more information about AOSP theming and overlays, see\n[Customize the build with resource\noverlays](/docs/setup/create/new-device#use-resource-overlays)."]]