文字太多？控件太小？试试 TextView 的新特性 Autosizeing 吧！

Hi，大家好，我是承香墨影！

Android 8.0 已经发布了有一阵子了，如果你有在关注它，你应该会知道它新增了一个对于 TextView 字体大小变动的新特性：Autosizing。

本身这个新特性，如果只是在 Android 8.0 才有效，对于开发者而言，就显得有点鸡肋了，可能还需要一段时间才能普及使用。不过呢，在 Android Support v26 之上，也对 Autosizeing 提供了兼容支持，最低可以支持到 Android Level 14。

这样，我们就有了研究的必要了，接下来本文就来讲解一下，Autosizeing 属性，你在使用过程中的所有细节。

一、什么是 Autosizeing？

Autosizeing 允许 TextView 根据其内部文本的显示大小，动态的调整其 TextSize 属性值得大小，通过此设置，开发者可以很轻松的在具有动态内容的情况下，对不同的屏幕中，文本大小进行优化。

简单来说，一个 100dp 长度的 TextView ，正常来说只能显示 10 个 10dp 的文字，而如果它的内容超出了 10 个字，以前的通用做法，是通过属性设置，让它在末尾显示 "…" 。而采用了 Autosizeing 这个新特性，它的方案是将字体的尺寸缩小，例如缩小到 8dp，让 TextView 可以容纳下更多的文字，显示完全。而这一切，使用 Autosizeing 我们只需要设置一些属性就可以做到，非常的简单。

上面这个 Gif 应该可以很直观的描述 Autosizeing 的特性，而它也反映出，触发 Autosizeing 重新计算 TextSize 的时机有两个：

TextView 中的文字增多到无法容纳的地步。
TextView 本身的尺寸被放大或缩小了。

Autosizeing 的核心设计思想，就是为了让文本尽可能的完全显示在既定大小的 TextView 中，哪怕是修改它的文字大小。

二、使用 Autosizeing

2.1 Autosizeing 不同使用方式

前面也提到，使用 Autosizeing 其实是区分使用 Android Api Level 26（8.0）和使用 Support Library v26 两种。它们的使用方式，会略微有点区别。

下面，我们先来了解一下它们之间的区别。

Autosizeing 的带来的效果很简单，就是根据文字的内容，动态修改 TextSize ，而想要使用它，可以通过动态编码和静态的 layout-xml 布局属性的方式使用。

对于 Android 8.0 Api：

动态编码是直接操作的 TextView 上的方法。
layout-xml 布局属性，是使用的 android: 命名空间下的属性进行设置。

<?xml version="1.0" encoding="utf-8"?>

<TextView

    android:layout_width="match_parent"

    android:layout_height="200dp"

    android:autoSizeTextType="uniform" />

而在低于 Android 8.0 的设备上，只能使用 Support v26 了。此时，TextView 上并没有对应的方法能让我们调用，所以我们需要绕一层。

动态编码，使用 TextViewCompat 中提供的方法。
layout-xml 布局属性，需要使用 app: 命名空间下的属性，记住要添加 xmlns:app="http://schemas.android.com/apk/res-auto" 这个命名空间。

<?xml version="1.0" encoding="utf-8"?>

<LinearLayout

    xmlns:android="http://schemas.android.com/apk/res/android"

    xmlns:app="http://schemas.android.com/apk/res-auto"

    android:layout_width="match_parent"

    android:layout_height="match_parent">

  <TextView

      android:layout_width="match_parent"

      android:layout_height="200dp"

      app:autoSizeTextType="uniform" />

</LinearLayout>

使用标准的 8.0 Api 的使用场景，在现阶段会非常的少，所以我们这里只是简单了解一下区别就好了，下面的文章内容会主要以 Support v26 的方式进行讲解。

2.2 Autosizeing 基础

到这里，你应该对 Autosizeing 有了基本的概念，知道它是干什么的。

那么，如果让你来设计一个这样的功能，你会想要做到哪些点？

有开关限制，只在我们需要的 TextView 上，才开启这个特性。
允许设置边界值，最大缩放和最小缩放。
能配置每次缩放的最小尺寸，例如：10sp 为粒度进行缩放。
能预设一些缩放的定位尺寸，例如预设一组尺寸，只让它在这个范围内的值中选一个。
方便的 Api ，可以通过 layout-xml 属性和动态编码的方式操作它。

嗯，功能上大概就是这些了，已经满足我的需要了。

如果你看了 Autosizeing 的文档，你会发现，它全部都支持！

Autosizeinging TextView Doc:

https://developer.android.google.cn/guide/topics/ui/look-and-feel/autosizing-textview.html

2.3 Autosizeing 开关

Autosizeing 是直接作用在 TextView 上的，对于它的开启和关闭，我们可以直接操作 autoSizeTextType 属性。

对于动态编码，可以使用 TextViewCompat 的 setAutosizeingTextTypeWithDefaults() 方法，下面是它的方法签名。

参数中的 textView 是我们要操作的 TextView，而 autoSizeTextType，就是我们关心的 Autosizeing 的开关属性了，它接受两个参数。

AUTO_SIZE_TEXT_TYPE_NONE：关闭自动调整功能。
AUTO_SIZE_TEXT_TYPE_UNIFORM：开启统一缩放碎片轴和垂直轴。

我们也可以通过 layout-xml 属性的方式，来设置 autoSizeTextType，因为是 Support ，所以使用的 app： 命名空间下的属性。

<?xml version="1.0" encoding="utf-8"?>

<LinearLayout

    xmlns:android="http://schemas.android.com/apk/res/android"

    xmlns:app="http://schemas.android.com/apk/res-auto"

    android:layout_width="match_parent"

    android:layout_height="match_parent">

  <TextView

      android:layout_width="match_parent"

      android:layout_height="200dp"

      app:autoSizeTextType="uniform" />

</LinearLayout>

app:autoSizeTextType 同样接收两个参数 uniform 和 none，含义和上面代码中设置的参数一致。

2.4 操作 Autosizeing 的粒度

粒度的含义其实就是 Autosizeing 每次变动的最小单位，当然在设置粒度的同时，你还需要为其设置一个缩放的范围，最大值和最小值。

这样，在 Autosizeing 生效的时候，它会在这个范围内，按照我们设定的粒度，去动态的调整文字的大小。

想要操作这些属性，动态编码的方式你需要调用 TextViewCompat 的 setAutosizeingTextTypeUniformWithConfiguration() 方法。

参数很直观，没什么好解释的，一个最小值、一个最大值、变动的粒度、前面设置的尺寸的单位。

我们可以通过 unit 参数，通过 TypedValue 来设置前面设置的几个参数的单位，例如：sp 、dp、px，都可以。

这里操作的参数，在 layout-xml 中，都提供了对应的属性可供我们使用。

<?xml version="1.0" encoding="utf-8"?>

<LinearLayout

    xmlns:android="http://schemas.android.com/apk/res/android"

    xmlns:app="http://schemas.android.com/apk/res-auto"

    android:layout_width="match_parent"

    android:layout_height="match_parent">

  <TextView

      android:layout_width="match_parent"

      android:layout_height="200dp"

      app:autoSizeTextType="uniform"

      app:autoSizeMinTextSize="12sp"

      app:autoSizeMaxTextSize="100sp"

      app:autoSizeStepGranularity="2sp" />

</LinearLayout>

下面我们举两个例子看看，就清晰了。

在默认情况下，如果你没有设置这三个属性，Autosizeing 会根据当前 TextView 控件的大小，估算出一个最大值和最小值，并且将粒度设置为 1sp 。

可以看到，它设置的尺寸是跳动的，非常的不可控，我们很难知道下一次缩放，会将文本尺寸，设置成多大，所以才需要使用粒度的概念来限制它缩放的大小。

例如，现在我们修改上面的例子，将（minSize,maxSize），限制在（10sp,80sp）之间，粒度（Granularity）设置为 10sp，此时再来看它的效果。

到这里可以看到，它每次放大或者缩小，粒度都是以 10sp 为基准。

所以，如果你需要使用 Autosizeing ，强烈建议你使用粒度来控制它缩放的大小，让它在可控的范围内使用。需要注意的是，这里介绍的三个属性，一定要设置在一个合理的范围内，否则 TextView 会认为这是一个无效的设置，将它忽略掉。

2.5 预设尺寸范围

如果你按上一小节，介绍的属性，设置了 Autosizeing 的粒度，就可以在这个范围内，根据我们设置的粒度进行缩放。通常，使用粒度来控制基本上可以达到我们的要求，但是如果对缩放有更精准的要求，例如：[10.15,40,60,100] 这样的缩放，使用粒度就达不到我们的要求了。

针对这样的操作，Autosizeing 也提供了对应的属性来设置，那就是预设尺寸（Preset Size）。

如果想要使用预设尺寸，动态编码的方式，你需要操作 TextViewCompat 的 setAutosizeingTextTypeUniformWithPresetSizes() 方法。

预设尺寸可以接受一个尺寸数组，Autosizeing 就会从我们设定的尺寸数组中，取一个尺寸进行设置。同时你可以为这些尺寸设置一个统一的尺寸单位。

如果想要在 layout-xml 使用属性的形式使用预设尺寸，你首先需要一个 array 的资源，然后通过 autoSizePresetSizes 属性进行设置即可。

array 资源的格式：

<resources>

  <array name="autosize_text_sizes">

    <item>10sp</item>

    <item>12sp</item>

    <item>20sp</item>

    <item>40sp</item>

    <item>100sp</item>

  </array>

</resources>

定义好 array 的尺寸资源之后，就可以在 layout-xml 中使用它。

<?xml version="1.0" encoding="utf-8"?>

<LinearLayout

    xmlns:android="http://schemas.android.com/apk/res/android"

    xmlns:app="http://schemas.android.com/apk/res-auto"

    android:layout_width="match_parent"

    android:layout_height="match_parent">

  <TextView

      android:layout_width="match_parent"

      android:layout_height="200dp"

      app:autoSizeTextType="uniform"

      app:autoSizePresetSizes="@array/autosize_text_sizes" />

</LinearLayout>

预设尺寸非常简单，这里就不再给运行效果了。

三、查缺补漏

到这里，我们就把 Autosizeing 的基本使用细节，都讲解清楚了。但是，依然还有一些概念，是在文档上没有反应出来的，下面我们就来讲讲这些 “经验”。

3.1 TextView 必须限定尺寸

如果你想要使用 Autosizeing，就必须对 TextView 这个控件，限定大小，不能使用 wrap_content 来作为限定符。

用官方文档话来说，使用 wrap_content 可能出现不可预料的效果。其实这也非常好理解，如果 TextView 的尺寸不是固定的，那就不存在 TextView 重新计算尺寸的依据了，同比放大 TextView 就可以达到容纳文字的效果了。

我在实际使用过程中会发现，它会阻止放大效果。例如一个 TextView 中使用了 Autosizeing，一直增加文本内容，是可以正常缩小的，但是当你删除文本的时候，它并不会随之放大文字尺寸。

但是不确定还有没有其它的问题，这里建议按照官方文档的建议来操作，限定 TextView 的尺寸。

3.2 Autosizeing 不能作用在 EditText 中

虽然通常作用在 TextView 上的新属性，对于同样用于显示文本的控件，例如：Button、EditText 等，都是同样适用的。

但是 Autosizeing 就是这么特殊，它只对单纯只能显示文本的控件有效，例如 Button，而对于 EditText 这种可以输入文本的控件，是无效的。

这个，你可以在 AppCompatTextViewAutosizeingHelper 这个类的 supportsAutosizeingText() 方法中找到答案，它是一个兼容类，用于向下兼容 Autosizeing 特性。

这里可以看到，只要不是 AppCompatEditText 就返回 true，注释也说明了这一点。

暂时没有想到这样设计的原因，可能是因为输入文本的控件，本身长度就是在经常变化的，是一个极端不可控的情况，所以应该为输入的控件，限定一个固定的尺寸。

3.3 预设尺寸不一定都命中

如果想要控制文字的缩放尺寸为限定的范围内，例如使用粒度限定它在一个 10sp 的精度下缩放；或者使用预设尺寸，限定一些尺寸，让它只能使用我们预定的一些尺寸。

但是这些，并不是一定的。

例如，我们使用预设尺寸，预设了一组[10sp,20sp,25sp,40sp]，这样一组尺寸，其中，可能某个尺寸就永远不会被命中，例如 25sp。

这是因为，Autosizeing 在起作用的时候，会去计算尺寸是否合适，假如到 20sp 之后，再减少文字，这个时候先获取 25sp ，通过计算发现 25sp 也放不下这些文字，就会直接跳到 40sp 这个尺寸上去。

所以，并不是我们设定的尺寸，它就是以线性的方式去获取尺寸。

3.4 和 singleLine 冲突

如果你想在 TextView 中，只显示一行文字，在之前你可以使用 android:singleLine 这个属性，对其标记。而如果你同事使用 Autosizeing，你会发现 AutoSizeing 就不再生效，它会在末尾显示 “…”。

所幸的是，android:singleLine 已经被标记为废弃，所以本身我们就不建议使用它，如果你想让 TextView 只显示单行文字，可以使用 android:maxLines="1" 属性，它是可以正常和 Autosizeing 兼容的。

四、使用场景

Autosizeing 说起来非常的简单，但是它能有哪些适用场景呢？简单说说我能想到的一些适用场景吧，大家可以开放思维。

4.1 限定条目的 UI

这个，其实很常见，例如一些选择题的 UI，当你有多个需要选择答案的 UI ，并列的显示出来。如果它们的文字长度是可变的（通常都是可变的），你除了放大某一行的高度之外，现在还可以使用 Autosizeing 来控制它的大小。

例如最近比较火的冲顶大会类 App，就是一个标准的选择题的 UI 布局。

我们可以在答案文字过多的时候，使用 Autosizeing 将它缩小，就能正好放在这个既定大小的选项 UI 中。

4.2 多语言

Autosizeing 在 App 的多语言适配中，也可以大放异彩。

首先你要考虑到，当你想让 App 适配多语言的话，一个很严重的问题，就是不同的语言，描述同一个词的时候，长度是不一致的。

例如中文下简单的一句：我是 Android 开发者，翻译成不同的语言，长度是不一致的。

英语：I am an Android developer
阿拉伯语：أنا مطور الروبوت
意大利语：Sono uno sviluppatore Android
德语：Ich bin ein Android-Entwickler
法语：Je suis un développeur Android

在这样的情况下，我们如果有 Autosizeing 就非常的好解决这个问题了。

五、小结

本文到这里，就已经完成了 Autosizeing 的所有细节，从基本使用到注意事项，应该算是解释的很详细了。

不知道你觉得 Autosizeing 在实际使用中，还有什么使用场景？可以在评论中留言，分享给大家！

今天在承香墨影公众号的后台，回复『成长』。我会送你一些我整理的学习资料，包含：Android反编译、算法、设计模式、虚拟机、Linux、Kotlin、Python、爬虫、Web项目源码。

我另外还维护了一个技术交流群，有兴趣可以在公众号后台回复："加群"