You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

重建旧工作项目时遇FontFamilyFont相关报错,如何解决?

解决FontFamilyFont中找不到android:fontVariationSettings属性的错误

嘿,这个问题我之前帮不少开发者排查过,本质是API版本兼容性或者资源配置不匹配导致的,给你几个具体的解决步骤:

1. 检查并升级Compile SDK版本

android:fontVariationSettings是Android API 26(Android 8.0)才引入的属性,你的项目必须至少把编译目标SDK升到26或更高才能识别它。打开模块级的build.gradle文件,修改这两个参数:

android {
    compileSdkVersion 26 // 可以升到更高版本,比如27、30都没问题
    defaultConfig {
        targetSdkVersion 26
        // 其他配置保持不变
    }
}

2. 匹配Build Tools版本

确保buildToolsVersion和compileSdkVersion版本对应,避免版本不兼容导致的aapt工具报错。比如compileSdk用26的话,buildTools可以用26.0.3:

android {
    buildToolsVersion "26.0.3"
}

3. 检查字体资源文件

如果你的项目里手动创建了字体资源(res/font/目录下的xml文件),看看是不是手动添加了android:fontVariationSettings属性。如果你的compileSdk低于26,要么删掉这个属性,要么按照步骤1升级SDK版本。如果是第三方依赖库带的字体资源,要么升级该依赖库到兼容版本,要么在依赖声明里排除冲突的资源。

4. 清理缓存并重建项目

有时候旧的缓存会导致奇怪的资源识别问题,执行以下命令清理缓存:

# Linux/Mac
./gradlew clean

# Windows
gradlew clean

之后重新构建项目,大部分情况下缓存问题都能解决。

5. 排查第三方依赖

如果以上步骤都没用,大概率是某个第三方依赖库使用了API26+的属性,但你的项目SDK版本不够。可以尝试:

  • 升级该依赖库到最新版本(通常新版本会兼容更多SDK级别)
  • 降低依赖库版本到适配你当前SDK的版本
  • 用exclude语法排除依赖中冲突的资源模块

补充说明

这个属性是用来控制可变字体的变体(比如调整字体粗细、斜度等),只有Android 8.0及以上系统支持,所以编译时必须让你的项目SDK版本和build tools能识别这个属性,否则aapt打包工具就会抛出找不到属性的错误。

内容的提问来源于stack exchange,提问作者Midhilaj

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.05.25 03:24:18