Android 字体字重设置：从XML到Kotlin的奇妙之旅

小码哥_常
9 阅读10分钟

Android 字体字重设置：从XML到Kotlin的奇妙之旅

引言：字重 ——Android UI 的隐形魔法师

在 Android 开发的奇妙世界里，你是否曾留意过，那些看似普通的文字，在不同的字重设定下，竟能展现出截然不同的魅力？就像一位隐形的魔法师，字重悄然改变着 UI 的氛围与格调。想象一下，一款新闻应用，标题以粗重有力的字体呈现，瞬间抓住你的眼球，引导你迫不及待地去了解内容；而正文则采用适中的字重，让你在阅读时轻松惬意，不会感到丝毫疲惫。又比如一款时尚购物 APP，促销信息用醒目的粗体字呐喊着 “优惠来袭”，刺激你的消费欲望，而商品描述则以细腻的轻字体娓娓道来，营造出优雅的购物氛围。

字重，这个看似不起眼的元素，实则是打造沉浸式用户体验的关键密码。它不仅关乎美观，更与可读性、信息层级的传达紧密相连。那么，如何在 Android 开发中精准地掌控这股 “魔法力量” 呢？接下来，就让我们一同开启这场从 XML 到 Kotlin 的字重设置全攻略之旅 ，揭开字重设置的神秘面纱！

一、FontWeight：揭开神秘面纱

（一）什么是 FontWeight

在 Android 开发中，FontWeight（字重）就像是给文字赋予了不同的 “力量感”。简单来说，它决定了字体笔画的粗细程度 。想象一下，你手中有一支神奇的画笔，FontWeight 就是调节画笔笔触粗细的旋钮。当你将旋钮调至较轻的一端，文字就变得纤细轻盈，仿佛是微风中轻轻飘动的丝带，给人一种精致、优雅的感觉；而当你把旋钮转向较重的一端，文字瞬间变得粗壮有力，如同坚实的石柱，传递出强烈、醒目的视觉信号 。

在实际的应用场景中，FontWeight 发挥着至关重要的作用。在 APP 的导航栏中，为了突出标题，我们通常会使用较重的字重，让用户一眼就能聚焦到关键信息；而在正文内容中，适中的字重则能确保阅读的舒适性，减轻用户的视觉疲劳。再比如，在电商 APP 的促销页面，限时折扣的数字用粗重的字体显示，能够极大地吸引用户的注意力，激发他们的购买欲望。

（二）字重数值大揭秘

现代 Android 系统为我们提供了丰富的字重选择，支持从 1 - 1000 的字重数值 ，每一个数值都代表着一种独特的字体粗细程度。

  • 400：常规（Normal）：这是我们最常见的字重，就像一位低调的绅士，以恰到好处的粗细展示着文字，给人一种平和、自然的阅读体验。在大多数 APP 的正文部分，400 字重的字体被广泛应用，确保用户在长时间阅读时不会感到疲惫。例如，新闻类 APP 的文章正文，采用 400 字重的字体，让用户能够轻松地获取信息。

  • 500/600：中等粗细（Medium / Semi - Bold）：当你需要稍微强调某些文字，但又不想过于张扬时，500 或 600 字重就是绝佳的选择。它们像是在轻声提醒用户：“嘿，这里有重要信息哦！” 比如，在 APP 的列表项中，标题使用 500 或 600 字重，能够与正文形成层次对比，让用户快速区分不同的内容块。在一些知识科普类的 APP 中，小标题采用 500 字重，既突出了内容的结构，又不会显得过于突兀。

  • 700：粗体（Bold）：700 字重的字体宛如舞台上的主角，以醒目的姿态吸引着所有人的目光。它常用于强调关键信息、突出重要标题或警示性内容。在电商 APP 的促销活动页面，“限时抢购”“今日特价” 等字样通常会使用 700 字重，强烈地刺激用户的视觉神经，激发他们的购买冲动。在一些紧急通知类的 APP 中，重要的提示信息也会采用 700 字重，确保用户能够第一时间注意到。

二、XML 实战：“空文件” 的神奇魔法

（一）创建神奇的配置文件

接下来，让我们进入神奇的 XML 世界，探索一个看似 “空文件” 的奇妙魔法。首先，在项目的 res/font 目录下，创建一个名为 system_font.xml 的文件。别小看这个文件，它可是我们控制字重的关键 “魔法道具”。打开 system_font.xml，输入以下代码：

<?xml version="1.0" encoding="utf-8"?>
<font-family xmlns:app="http://schemas.android.com/apk/res-auto">
</font-family>

你可能会疑惑，这不是一个几乎空白的文件吗？没错，就是这个 “空文件”，配合上特定的属性设置，就能实现令人惊叹的字重控制效果 。

（二）布局中的奇妙运用

文件创建好后，让我们把它运用到布局中。在布局文件里添加一个 TextView，并设置相关属性：

<TextView
    android:layout_width="wrap_content"
    android:layout_height="wrap_content"
    android:fontFamily="@font/system_font"
    android:textFontWeight="600"
    android:text="精准控制字重"/>

运行你的应用，你会发现，TextView 中的文字字重已经神奇地变成了我们设置的 600，呈现出中等偏粗的效果，就好像被施了魔法一样，原本普通的文字瞬间变得更加醒目 。

（三）原理大揭秘

这背后的原理是什么呢？其实，这种做法巧妙地利用了系统的 Font Fallback（回退）机制 。当我们在 XML 中定义了一个空的 font-family 时，系统会将其指向默认字体族（通常是 Roboto） 。而我们设置的 android:textFontWeight 属性，就像是给系统下达了一个指令，让它在默认字体族中寻找最接近指定字重（比如这里的 600）的字体文件进行渲染 。所以，即使我们没有引入任何外部字体文件，也能轻松实现字重的精准控制，是不是很神奇呢？这就好比你在一个图书馆里，虽然没有指定具体的某本书，但通过描述书的特征（字重），图书馆管理员（系统）就能帮你找到最符合要求的那本书（字体文件） 。

三、Kotlin 进阶：动态设置字重的艺术

（一）针对 Android 9.0 + 的精准控制

在 Kotlin 的世界里，我们拥有更强大的动态设置字重的能力，尤其是在 Android 9.0（API 28）及以上版本 。下面是一段简洁而强大的代码示例，展示了如何在 Kotlin 中针对 Android 9.0 + 版本精准控制字重：

fun TextView.setFontWeight(weight: Int) {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
        // Typeface.create(Typeface, Weight, isItalic)
        this.typeface = Typeface.create(this.typeface, weight, false)
    }
}

这段代码定义了一个扩展函数setFontWeight，它接收一个weight参数，表示我们想要设置的字重 。通过Build\.VERSION\.SDK\_INT检查当前设备的 Android 版本是否大于或等于 Android 9.0 。如果满足条件，就使用Typeface\.create方法创建一个新的Typeface对象，将当前 TextView 的typeface、指定的weight和false（表示非斜体）作为参数传入，从而实现精准的字重设置 。例如，我们想要将一个 TextView 的字重设置为 700（粗体），只需要调用textView\.setFontWeight\(700\)即可 。

（二）全版本兼容扩展函数

为了兼顾旧版本的设备，我们需要编写一个全版本兼容的扩展函数 。这个函数会根据不同的 Android 版本，采用不同的方式来设置字重，确保在所有设备上都能达到预期的效果 。下面是具体的代码实现及解释：

fun TextView.setSmartFontWeight(weight: Int) {
    when {
        Build.VERSION.SDK_INT >= Build.VERSION_CODES.P -> {
            this.typeface = Typeface.create(this.typeface, weight, false)
        }
        weight >= 500 -> {
            // 低版本回退到系统预设的中等粗细
            this.typeface = Typeface.create("sans-serif-medium", Typeface.NORMAL)
        }
        else -> {
            this.typeface = Typeface.DEFAULT
        }
    }
}

在这个扩展函数setSmartFontWeight中，我们使用了when表达式来根据不同的条件进行处理 。

  • 当设备的 Android 版本大于或等于 Android 9.0 时，采用与前面相同的方式，使用Typeface\.create方法精准设置字重 。

  • 当weight大于或等于 500 时，对于低版本设备，我们通过Typeface\.create\(\&\#34;sans\-serif\-medium\&\#34;, Typeface\.NORMAL\)将字重设置为系统预设的中等粗细 。这是因为在低版本中，无法直接设置具体的字重数值，所以采用这种替代方式来模拟中等粗细的效果 。

  • 当weight小于 500 时，直接将typeface设置为Typeface\.DEFAULT，即使用系统默认的字体和字重 。这样，无论设备运行的是哪个版本的 Android 系统，我们都能通过这个扩展函数灵活且兼容地设置 TextView 的字重，为用户提供一致的视觉体验 。

四、常见问题与坑点：排雷指南

（一）版本兼容性问题

在 Android 开发的过程中，版本兼容性问题是我们无法回避的一道坎。就像在字体字重设置中，android:textFontWeight 属性仅在 API 28 及以上版本才生效 。这意味着，当你的应用需要支持旧版本设备时，这个属性就如同被施了 “沉默咒”，完全不会起作用，旧设备会直接忽略该属性的设置 。比如，你满心欢喜地在布局文件中为一个 TextView 设置了 android:textFontWeight = &#34;600&#34;，满心期待着文字能呈现出中等粗细的优雅效果，可当你在 API 28 以下版本的设备上运行时，却发现文字依旧保持着默认的字重，丝毫没有变化 。这时候，你就需要借助我们前面提到的 Kotlin 全版本兼容扩展函数setSmartFontWeight来解决这个问题，确保在所有版本的设备上都能实现字重的灵活控制 。

（二）厂商定制的 “小陷阱”

除了版本兼容性，部分国产手机厂商定制的系统也可能会给我们带来一些意想不到的 “小陷阱” 。一些国产手机系统为了优化系统资源，会对内置字体库进行精简 。这就导致在这些设备上，即使你设置了不同的字重，比如 500 和 600，实际显示效果可能完全一样 。因为系统字库里可能只有 Regular（常规）和 Bold（粗体）两个物理文件，根本无法区分更细腻的字重差异 。曾经就有开发者在开发一款面向国内市场的 APP 时，精心设计了不同字重的文字样式，以区分信息层级。然而，在部分国产手机上进行测试时，却发现所有设置了不同字重的文字看起来都一模一样，排查后才发现是厂商定制系统字体库精简惹的祸 。所以，在开发过程中，尤其是针对国内市场的应用，一定要在多种不同品牌和型号的国产手机上进行充分测试，避免这类问题影响用户体验 。

（三）空 XML 的潜在风险

虽然在新系统上，使用空的 font-family 文件配合 android:textFontWeight 属性能够实现神奇的字重控制效果，但这其中也存在一些潜在风险 。尽管目前这种做法在大多数新系统上都能正常工作，但从代码健壮性和可维护性的角度来看，建议在 XML 中显式指向 @android:font/sans_serif 。如果仅仅依赖一个空的 font-family 文件，当系统的 Font Fallback 机制发生变化或者未来版本更新时，可能会导致字重设置失效或者出现不可预期的显示问题 。就好比你搭建了一座看似坚固的房子，但基础却不够稳固，一旦遇到 “风吹草动”（系统变化），房子就可能出现问题 。所以，为了让我们的应用更加稳定可靠，显式指向字体资源是一个明智的选择 。

avatar
文章
阅读
粉丝