AboutLibraries 库版本升级指南：从8.9.4迁移到11.2.2的技术要点

背景概述

AboutLibraries 是一个用于展示Android应用中使用的开源库信息的工具库。在从8.9.4版本升级到11.2.2版本的过程中，开发者需要注意一些重要的API变更和架构调整。

主要变更点

1. LibsBuilder.withFields方法的移除

在旧版本(8.9.4)中，开发者可以通过LibsBuilder().withFields方法来配置库信息的显示字段。但在11.2.2版本中，这个方法已被完全移除。这是架构重构的一部分，开发者无需寻找替代方法，直接删除相关代码即可。

2. 新版本的工作原理

11.2.2版本采用了全新的工作机制：

• 构建时会生成一个JSON文件
• 该JSON文件会被包含在应用资源中
• 库会解析这个JSON文件并显示相关信息

这种机制相比旧版本更加高效和可靠，减少了运行时配置的需要。

升级建议

1. 代码清理：直接移除所有withFields相关的调用，这是安全的操作。

2. 构建流程检查：确保构建系统能够正确生成所需的JSON资源文件。

3. 功能验证：升级后应检查库信息的显示是否完整，特别注意自定义字段是否仍然正确显示。

注意事项

虽然API发生了变化，但核心功能保持不变。开发者无需担心功能缺失，新版本的架构设计更加合理，长期来看会减少维护成本。

对于从较旧版本升级的项目，建议仔细阅读变更日志，了解所有破坏性变更，确保平稳过渡。