更新日志
这里记录了
KavaRef的版本更新历史。
特别注意
我们只会对最新的 API 版本进行维护，若你正在使用过时的 API 版本则代表你自愿放弃一切维护的可能性。
1.1.1 | 2026.10.09 最新
kavaref-core
- ⚠️ 破坏性更新：调整
Configuration.superclass为Superclass枚举类型 - ⚠️ 破坏性更新：调整
exceptionTypes、genericParameters等需要按位置匹配的条件属性为List - ⚠️ 破坏性更新：调整
annotatedParameterTypes、annotatedExceptionTypes为按位置传入注解集合 - 新增
superclass(interfaces = true)用于在接口中过滤成员 - 新增
emptyExceptionTypes()等过滤空结果的条件 - 新增
withHandler()用于自定义MethodResolver、ConstructorResolver、FieldResolver的调用与读写行为 - 调整
MemberResolver、InstanceAwareResolver的泛型参数，新增处理器类型H - 调整注解相关条件与
WildcardTypeMatcher的匹配逻辑，与 Java 反射保持一致 - 调整
asResolver()的行为，现在总是将调用者作为实例，在KClass、Class上请使用resolve() - 调整
createAsType<T>()为非 reified 方法，现在可以传入类上的泛型 - 统一自由条件抛出异常时的处理逻辑，并在异常信息中列出
- 修复
superclass()会影响同一作用域中后续过滤的问题以及若干条件匹配错误的问题 - 修复
copy()与mergeWith会丢失修饰符条件的问题 - 优化字符串类型条件的解析性能
kavaref-android
- 新增 Lint 规则
EmptyConditionArguments - 新增
ReplaceWithKavaRefExtension规则对isNotSubclassOf、toClassOrNull、genericSuperclassTypeArguments等扩展的替换建议 - 修复
ReplaceWithKavaRefExtension规则对类字面量以及非Member、Class类型modifiers的误报问题 - 修复
UnsupportedExecutableCondition、ReplaceWithKavaRefExtension规则的快速修复在链式调用等上下文中会生成错误代码的问题
kavaref-jvm
- 移除 SLF4J 依赖以避免修改全局日志配置，默认日志改为输出到控制台
kavaref-extension
- 调整
createInstance()的构造方法选择逻辑，与 Java 的重载规则保持一致 - 调整
createInstanceAsType<T>()为非 reified 方法，现在可以传入类上的泛型 - 新增
TypeRef对可空类型与泛型数组的支持，并内置 R8/ProGuard 规则 - 优化
LazyClass的加载逻辑，保证线程安全并缓存加载失败的结果 - 优化
makeAccessible()，成员已可访问时不再重复设置 - 修复未传入
ClassLoader时toClass()会初始化类以及VariousClass无法加载类的问题 - 修复
createInstance()的缓存导致ClassLoader无法回收的问题 - 修复
isTransient、isVolatile等修饰符扩展对可变参数方法与桥接方法的误判问题
1.1.0 | 2026.06.06 过旧
kavaref-core
- 新增平台底座接入机制，核心 API 保持不变，使用时需按平台引入 kavaref-android 或 kavaref-jvm
- 新增
MethodCondition.genericReturnType(...)与MethodCondition.defaultValue(...)条件 - 调整
ExecutableCondition内部实现，避免低版本 Android 直接依赖Executable - 将成员访问、可访问性、注解与泛型等平台差异能力下沉到平台底座
kavaref-android
- 新增 Android 平台底座模块，支持 Min SDK 21 环境下使用 KavaRef
- 新增 Android Lint 规则
- 新增 R8/ProGuard 配置与 Android 平台日志实现
kavaref-jvm
- 新增 JVM 平台底座模块，提供完整 JVM 反射能力支持
- 新增 JVM 平台日志实现，并保持原有 JVM 使用体验
kavaref-extension
- 优化
createInstance()的构造方法参数匹配逻辑，兼容低版本 Android - 优化
Type.toClass()的类型解析实现
1.0.3 | 2026.05.28 过旧
kavaref-core
- 统一
MethodResolver、FieldResolver、ConstructorResolver的成员可访问性处理逻辑 - 优化
MemberProcessor的注解处理逻辑，并改进条件匹配失败时的提示信息 - 修复可选模式下字符串类型解析失败时可能误匹配
Any的问题
kavaref-extension
- 调整
makeAccessible()的行为，现在会返回Boolean表示是否成功，并支持使用trySetAccessible()设置可访问性 - 优化
createInstance()的构造方法缓存逻辑，并补充构造方法可访问性校验
历史版本
kavaref-core
1.0.2 | 2025.09.23 过旧
- 移除
org.slf4j:slf4j-simple依赖以修复在 SpringBoot 项目中引起的冲突问题 - 移除已被弃用的
T.resolve()方法避免其污染作用域，如果仍未迁移，请按照文档指引迁移到T.asResolver()
1.0.1 | 2025.07.06 过旧
T.resolve()已被弃用，因为其存在命名空间污染问题，现在推荐迁移到T.asResolver()- 移除了 KavaRef 中存在的残留
block方法，如果有用到此类方法，你可以手动使用apply来实现
1.0.0 | 2025.06.25 过旧
- 首个版本提交至 Maven
kavaref-extension
1.0.2 | 2025.12.13 过旧
- 新增
TypeRef功能，可用于在运行时保留泛型信息
1.0.1 | 2025.07.06 过旧
- 修复
VariousClass中loadOrNull返回类型是Class<*>?而不是Class<Any>?的问题
1.0.0 | 2025.06.25 过旧
- 首个版本提交至 Maven
