Robolectric 4.14 版本中自定义字体加载问题的分析与解决

问题背景

在 Android UI 测试框架 Robolectric 的 4.14 版本中，开发者在使用 Compose UI 进行测试时遇到了一个关于自定义字体加载的问题。当测试代码中使用了 MaterialTheme 并配置了自定义字体时，会抛出 IllegalStateException: Could not load font 异常。

问题现象

开发者在使用 Robolectric 4.14 版本进行 Compose UI 测试时，发现以下情况会导致测试失败：

1. 在测试中使用了 MaterialTheme 并配置了自定义字体
2. 字体资源定义在 Android 库模块(res/font 目录下)
3. 测试代码尝试访问配置了自定义字体的 Text 组件

错误堆栈显示字体资源无法加载，最终抛出 Resources$NotFoundException: Font resource ID #0x7f080000 could not be retrieved。

问题根源

经过分析，这个问题主要与以下因素有关：

1. 资源加载机制变化：Robolectric 4.14 版本中对资源加载机制进行了调整，导致在某些情况下无法正确加载字体资源。

2. 模块结构影响：问题特别容易出现在多模块项目中，当字体资源定义在 Android 库模块而非主应用模块时。

3. 图形模式选择：在 LEGACY 图形模式下，Robolectric 的字体和类型逻辑是模拟实现的，而在 NATIVE 图形模式下则使用真实实现。

解决方案

Robolectric 团队在 4.14.1 版本中修复了这个问题。修复方案主要涉及：

1. 资源加载优化：修正了资源加载逻辑，确保跨模块的字体资源能够正确加载。

2. 兼容性改进：增强了与 Compose 字体系统的兼容性，特别是对于定义在库模块中的字体资源。

最佳实践建议

为了避免类似问题，开发者可以采取以下措施：

1. 及时升级：使用 Robolectric 4.14.1 或更高版本进行测试。

2. 图形模式选择：根据测试需求选择合适的图形模式：

   • NATIVE 模式：提供更真实的渲染行为，适合需要精确像素验证的测试
   • LEGACY 模式：性能更好，但字体相关功能是模拟实现的

3. 模块化设计：

   • 将共享的字体资源放在基础模块中
   • 确保测试配置能够正确访问这些资源

4. 测试隔离：对于涉及自定义字体的测试，考虑使用适当的测试配置和模拟策略。

总结

Robolectric 4.14 版本中的字体加载问题是一个典型的跨模块资源访问问题，通过版本升级即可解决。这个问题提醒我们在进行 Android 多模块开发时，需要特别注意测试环境下的资源加载机制，合理规划资源的位置和访问方式，以确保测试的可靠性和一致性。