• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1This directory contains customizations to define and apply OEM Design Token to both the system and apps that reference the tokens.
2
3### OEMDesignTokenBase
4Android library that is a singular source of truth for the definition of token values. Set the values of color, text and shape tokens as resources in this library, which will be a dependency for RROs applying OEM Design Token values across the system.
5
6### OEMDesignTokenShim
7This library maps the resources (token values) from `OEMDesignTokenBase` to the resource names matching the resources defined in `car-resource-common`. This shim allows values defined in `OEMDesignTokenBase` to be easily substituted in modules that depend on `car-resource-common`.
8
9### OEMDesignTokenFrameworkResRRO
10This RRO applies the token values defined in `OEMDesignTokenBase` to `framework-res` by overlaying framework resources (themes, textAppearances, colors etc.).
11
12### OEMDesignTokenRRO
13This RRO applies the token values defined in `OEMDesignTokenBase` to the OEM Design Token Shared Library installed on the system. Apps that directly reference token values will resolve values defined in this RRO.
14
15### OEMDesignTokenCarUiPluginRRO
16This RRO overlays the resources of the Car UI Library plugin to reference OEM Design Token values where appropriate.
17
18```
19                          +----------------------+               +-----------------------------+            +-----------------+
20                          |                      |               |                             |            |                 |
21                          |                      |               |                             |            |                 |
22                          |                      |  Sets values  |                             | Customizes |                 |
23                          |  OEMDesignTokenShim  +---------------> Existing framework-res RROs +------------>  framework-res  |
24                          |                      |               |                             |            |                 |
25                          |                      |               |                             |            |                 |
26                          |                      |               |                             |            |                 |
27                          +------------^---------+               +-----------------------------+            +-----------------+
28                                       |
29+----------------------+               |
30|                      |               |Renames resources
31|                      |               |
32|                      |               |
33|  OEMDesignTokenBase  +---------------+
34|                      |               |
35|                      |               |
36|                      |               |Sets values
37+----------------------+               |
38                                       |
39                         +-------------v------------+            +---------------------------------+
40                         |                          |            |                                 |
41                         |                          |            |                                 |
42                         |                          |            |                                 |
43                         |     OEMDesignTokenRRO    +------------> OEM Design Token Shared Library |
44                         |                          | Customizes |                                 |
45                         |                          |            |                                 |
46                         |                          |            |                                 |
47                         +--------------------------+            +-----------------+---------------+
48                                                                                   |
49                                                                                   |
50                                                                                   |
51                                                                                   |References tokens
52                                                                                   |
53                                                                                   |
54                                                                                   |
55                                                                   +---------------v--------------+            +-----------------------+
56                                                                   |                              |            |                       |
57                                                                   |                              |            |                       |
58                                                                   |                              |            |                       |
59                                                                   | OEMDesignTokenCarUiPluginRRO +------------>  Car UI Proxy Plugin  |
60                                                                   |                              | Customizes |                       |
61                                                                   |                              |            |                       |
62                                                                   |                              |            |                       |
63                                                                   +------------------------------+            +-----------------------+
64```
65