重建旧工作项目时遇FontFamilyFont相关报错,如何解决?
嘿,这个问题我之前帮不少开发者排查过,本质是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

