readme.md
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