前言

作为 Android 开发者，不知你是否也有这样的体验，随着项目变得越来越大，各种不同圆角的 shape，不同透明度的 color，不同大小的阴影效果，它们使资源文件越来越多

我认为造成这种问题的原因有两个：一个是产品设计的不规范，整个 app 没有统一的设计风格；第二个便是开发者在开发过程中编码的不规范

Android Dev Summit '19 有一场关于 Style 与 Theme 的演讲，它的 中文字幕视频在这里

我为你整理了每个主题所在的位置

在视频下方的评论区，点击相应时间即可跳转到指定内容

与之对应的有一个 Styling 的系列文章，我最近翻译成了中文

• 【译】Android Styling 1： Themes vs Styles

• 【译】Android Styling 2： 常用主题属性

• 【译】Android Styling 3： 使用主题和主题属性的优势

• 【译】Android Styling 4： 主题实战

本文整理了视频与文章中的内容，介绍在开发过程中，我们应如何利用 theme 与 style 更优雅地管理资源文件，并提供了很多实用的技巧，在标题中找到技巧相关的查看即可

并且提供了演示 demo，效果如下

理解 Style 与 Theme 的区别

这部分内容在视频的 02.14 处

Style 是 View 属性的集合，可以将 Style 视为 Map<View Attribute, Resource>，其中 key 为 View 的属性，value 为资源

Resource 可以为以下类型

而 Theme 则不同，它的 key 是 「主题属性」，很显然下图中的 colorPrimary 不是任何 View 中的属性

主题属性有点像把配置抽象为语义化的命名的变量，并把它们塞到 map 中，以便未来使用，主题属性 与 View 属性很像，它们在 attr 中定义的方式以及对应的类型都是类似的，但二者仍有差异

在引用主题属性时，可以使用 ?.attr 语法，其中 ？代表在当前主题中搜索

主题属性带来的优势

如果我们 app 需要支持普通版本和 Pro 版本，它们的主色不同，我们只需定义两个主题，配置不同的 colorPrimary。接着我们需要适配深色主题，那么只需提供不同的数值即可

这就好比我们有一个 Theme 抽象类，而其中有一个抽象属性 colorPrimary，它有四个实现类，分别重写了 colorPrimary 属性，这样我们便得到了 四个变体，未来想加入新的变体，只需继承该抽象类并重写属性即可。看过 第一篇译文 的小伙伴知道，主题的作用范围是 「树」中的所有子节点。这样我们便很轻松地实现了更改程序主色的功能

如果要使用 Style 实现这一功能，首先，我们需要定义四种 Style。由于 Style 的作用范围是特定 View，因此我们要为每个 View 均定义四套 Style

小结

简单来说，Style 与 Theme 的作用范围不同

Style 只会作用于单一的 View 中，使用时用 style 标签

Theme 会作用于「树」中的所有子节点，使用时用 theme 标签

在任意时刻，程序都是运行在某一特定主题下的，例如 activity 被设置了特定主题

我们在使用时应该注意 theme 与 style 各自的优势，灵活运用二者

Theme Overlay

这部分内容在视频的 08.55 处

主题是有继承关系的，当该继承关系链中有多个主题配置了同一属性，那么最继承链最底部的内容会生效，在下图中，如果多个主题都声明了 colorPrimary，那么 Theme.Owl.Pink 中的内容会生效（这有点像 Java 的继承关系）

利用这种继承关系我们可以实现在粉色主题下将部分界面使用蓝色主题

我们看一下两种主题的继承关系，这两种主题的父级应该是比较相似的，这看起来比较浪费，因为很多属性是相同的

另外，当你把一个主题设置在另一个主题之上，你需要注意不能将自己想要保留的东西被覆盖掉

Theme Overlay 可以很好地解决这一问题，它并不是一项新技术，而是属于一种技巧

接下来我们只需关注想要更改的东西，应用下图的声明的主题，则会只改变 colorPrimary 和 colorSecondary 两项属性的值，而其它的所有属性均不变

技巧1：反转颜色

MaterialComponents 提供了 暗色的 Theme Overlay

使用该 Theme Overlay 可以将浅色主题中的某部分做成暗色主题

技巧2：使用正确的 Context

我们知道主题与 Context 相关，由于上文我们提到的主题的继承关系，使用正确的 Context 很重要

记住：使用距离最近 View 所在的 Context

当然更好的做法是使用主题属性

技巧3：在代码中使用 Theme Overlay

如果想要在代码中使用 Theme Overlay ，可以将其包裹为 ContextThemeWrapper，这也是 android:theme 标签内部做的事情

使用 Theme 和 Style

Color

这部分内容在视频的 12.36 处

程序内最重要的资源便是 Color，Android 定义 Color 有很多种方式，比如 Color tag，它主要由 ARGB 色值组成

Color tag 也可以引用其他的 Color tag。需要注意的是，你不能在 Color tag 引用主题属性

以上是静态的颜色，下面我们谈一谈有状态的颜色

Color state list 允许你在不同状态下定义不同的颜色，它们也可以用作 drawable，例如下面的例子，在 button 按下或禁用时都有相应的颜色

下面我们来看一下 Color state list 是如何定义的，我们看到这里使用了 selector 标签，本示例中有两个 item，第一项定义了一种颜色，并指定它是在选中状态下才被使用；第二项 没有定义任何状态，这意味着它是默认颜色。如果没有其他颜色可以匹配当前状态时，它就会被使用

这里有一个小技巧，可以将 Color state list 按照最容易出现——最不容易出现的顺序进行排序，这由其背后的实现原理决定，系统会遍历每个 item 直至找出匹配项

在 API 21 官方引入了 android:alpha tag 来设置透明度，并在 API 23 中可以引用主题属性。如果你使用 AppCompat 的话，它可以向下兼容到 API 14

技巧1：设置透明度

我们在开发中可能会遇到这种情况：对于同一个颜色，我们需要不同的透明度。因此我们可能会复制不同透明度的色值

你可能不想在更改一个颜色后然后再逐一更改其相应透明度的色值，此处我们可以使用 ColorStateList，我们可以使用默认颜色的功能，只配置一个 item，并在此处配置透明度（从 0 到 1）

技巧2：ColorStateList 与 Drawable 的转换

我们在 View 配置 background 等属性时可以直接传入 color，在内部系统会填充该颜色并将其包装为 ColorDrawable

但如果你将 ColorStateList 传入是不行的，在 API 28 及之前的设备会崩溃

这是因为 ColorDrawable 是无状态的，在 Android 10 中，官方加入了 ColorStateListDrawable 解决了这一问题

为了在所有 API 中获得相同的体验，我们可以使用一种变通的做法，使用 backgroundTint

此处使用纯色设置了一个矩形，接着使用 backgroundTint 指向了 ColorStateList

常用技巧

这部分内容在视频的 17.35 处

技巧1：正确命名资源

我们的项目中肯定有这样命名的资源，它们是按照主题属性命名的。Android Studio 新建项目默认的资源就是这样命名的

而你的主题大概是这样，主题属性指向同名的颜色资源

这样做是不推荐的

我们需要的不是一个语义的命名，而是需要一个文字的命名，我们可以用品牌颜色命名，也可以像 Material Color System，根据色调命名

技巧2：使用统一的 style 名称

大家可能见过这样的样式，一个叫 AppTheme，一个叫 Toolbar，从命名便可以看出它们的用途

但是如果我们加入了第三种样式，它的用途不是很明显，我们无法区分它是一个主题还是样式

为此我们可以约定一个命名规则

第一部分为 Style type：主题，样式，文本外观，Theme Overlay，形状外观等等

第二部分为 Group name：通常采用应用名称，如果是多 module 也可以为 module 名

第三部分为 Sub-group name：这名字通常用于 Widget，也就是使用样式的 View 的名称

第四部分为 Variant name：这是可选的，它是主题的变量

回到最初的例子，按照我们约定的命名规范改造就变成了这样

这里有一个值得注意的地方，在 Android System 中，. 是一个十分神奇的符号，这里有一个基于它的隐含的继承系统

上图的 Widget.MyApp.Toolbar.Blue 实际上继承了中间的这个主题

这种命名规范可以在 code review 时直观地判断出 style 或 theme 是否用错。如下图，很明显这里使用了 style 标签，却传入了一个主题

你甚至可以使用 Lint 来解决此问题，详情移步

技巧3：拆分多个文件

简单模式

将资源类型文件进行标准的分类

• theme.xml ：Theme 和 Theme Overlay
• type.xml：字体，文本外观，文本尺寸，字体文件等
• style.xml：只有 Widget style
• dimens.xml colors.xml strings.xml：其它类型归类于实际的资源类型

复杂模式

复杂模式是按照逻辑进行分类，例如形状相关的放入 shape.xml，如果想要实现全屏的UI，可以在 sys_ui.xml 中控制状态栏/导航栏颜色，以及是否显示等等

在 Android Studio 的 Android 视图下，这样做的效果是很好的。如下图，可以很清晰的看到 light 主题和 dark 主题的主题文件

Material

颜色系统

这部分内容在视频的 24:00 处

该系统构建基础是大量使用语义命名的变量，这些变量都属于「主题属性」。它的运作原理是 library 展示与这些使用语义命名的颜色相关的主题属性，而开发者负责为这些颜色提供数值。在 library 内，用这些颜色构建所有的 Widget

对于颜色系统，开发者需要了解一些常用的颜色

colorPrimary 和 colorSecondary 是 app 品牌的主要颜色，Variant 为主色的对比色；colorSurface 十分有用，它负责在某些控件表面的颜色；colorError 是错误的警示色，因此你没必要在使用时硬编码这些颜色

颜色系统还会提供一些 On 命名的颜色，这种颜色会保证拥有和类似名称颜色形成对比的颜色，例如 colorOnPrimary 永远会和 colorPrimary 形成对比

你可以在自己的主题中配置这些颜色，注意这里不必配置所有的颜色，如果你继承了一些 Material 主题，它们会提供所有颜色的默认色，比如下图中没有设置 colorSurface，则会使用 Material Light 主题内定义的 colorSurface

之后你便可以在 layout 或 style 中使用这些颜色了

技巧

一个有用的技巧是可以将这些颜色与 ColorStateList 结合

比如我们想做一个分割线，不必创建名为 colorDivider 的新颜色，直接从 colorOnSurface 中取一个颜色即可，这个颜色肯定会和背景色形成对比

而且它会响应不同的主题，在浅色主题下，20% colorOnSurface 是一种黑中带白的颜色。在暗色主题下，colorOnSurface 会变成白色，此时的 20% colorOnSurface 会提供合适的对比

以语义命名的颜色是十分有用的，你可以省去大量的颜色定义

排版系统

这部分内容在视频的 28:06 处

在设计中，通常使用固定的几种字号进行排版，例如大标题1，大标题2，文本主体，副标题，按钮等等

而这些都是作为主题属性实现的

然后便可以在应用中引用这些主题属性

Material 的 Text 十分强大，它可以设置行高，如果你遇到了设置行高却不生效的问题，使用 Material 组件可以解决这一问题

形状系统

这部分内容在视频的 30:07 处

Material 采用了 shape system，该系统为小型，中型和大型组件 提供 了主题属性。请注意，如果要在自定义组件上设置 shape，则可能要使用 MaterialShapeDrawable 作为其背景，它可以理解并实现 shape

这里是通过 ShapeAppearance 来定义的，ShapeAppearance 和 TextAppearance 类似，是一种针对形状系统的配置

它由几个组件组成

首先是 cornerFamily，支持圆角和切角，圆角的方向等等

ShapeAppearance 还支持 overlay，可以更改特定的 Widget

在使用 overlay 时要注意的是很多 Material 组件是有着自己的 ShapeAppearance overlay，例如 BottomSheet，它会取消底部的圆角

技巧

形状系统是由 MaterialShapeDrawable 实现的

而 MaterialShapeDrawable 有一个强大的功能就是它有着一个属性叫 interpolation

使用它可以为形状系统做动画，如果它的值为0，那么所配置形状不会生效，如果值为1，那么形状系统会完整地应用到 drawable 上

暗黑主题

这部分内容在视频的 34:41 处

暗黑主题的适配很简单，可以通过代码设置当前主题和获取当前主题

可以使用 Material 组件的 DayNight，这样在打开/关闭 暗黑主题时相应的主题属性的色值都会跟随变化

技巧1 ：抽取主题

很多时候只做上面的两步并不能很好地适配暗黑主题，例如我们的应用在浅色主题下是这样的，深色的内容在浅色的背景上

而使用了夜间主题，可能会变成这样

而我们想要的效果是这样的

这是由于设置颜色时硬编码导致的

实际上，这种情况使用主题属性会有更好的效果

如果想要 colorPrimary 在不同的主题下使用不同的颜色，我们应该如何设置？

或许你会在 values-night/colors.xml 为暗色主题定义色值，但不建议这样做！

最好的做法是抽取公共部分到基础主题，然后在此基础上对浅色和深色主题分别配置差异化的属性

技巧2：ColorPrimary 的使用

有些时候我们的 colorPrimary 是一种亮色，例如下图中的蓝色，但在暗黑主题下我们想使用相对较暗的颜色，例如 ?attr/colorSurface，Material 组件内部为我们做好了转换，直接使用 ?attr/colorPrimarySurface 即可