Decompose项目中组件配置类equals/hashCode实现的重要性

在基于Decompose框架开发多平台应用时，组件配置类的正确实现对于保持实例状态至关重要。近期有开发者反馈在版本升级后遇到了InstanceKeeper被意外销毁的问题，经过深入分析发现这与配置类的equals/hashCode实现方式有直接关系。

问题现象

当使用非数据类(non-data class)作为组件配置时，框架在组件重建过程中无法正确识别配置是否相同，导致每次都会创建新的InstanceKeeper实例。而在使用data class或data object时，由于它们自动实现了正确的equals/hashCode方法，框架能够准确判断配置是否变更，从而保持原有的实例状态。

技术原理

Decompose框架通过比较前后配置对象的相等性来决定是否重用组件实例。这一机制依赖于配置类正确实现的equals和hashCode方法：

1. 数据类(data class)：自动生成基于所有属性的equals/hashCode实现
2. 数据对象(data object)：作为单例保证唯一性，天然具有稳定的相等性
3. 普通类：需要手动实现equals/hashCode，否则使用默认的引用相等比较

最佳实践

1. 优先使用data class：对于需要携带参数的配置

@Parcelize
data class UserConfig(val userId: String) : Config

2. 使用data object表示单例配置：

@Parcelize
data object SettingsConfig : Config

3. 避免使用未实现equals/hashCode的普通类：这会导致意外的实例重建

版本兼容性说明

虽然这个问题在最新版本(3.0.0+)中表现更为稳定，但本质上这是框架设计的行为而非bug。开发者应当始终确保配置类具有正确的相等性判断逻辑，这是框架的明确要求。

实际影响

不正确的配置类实现会导致：

• 组件状态丢失
• 不必要的实例重建
• 潜在的内存泄漏(旧实例未被正确清理)

通过遵循这些实践原则，开发者可以确保Decompose应用中的组件状态管理行为符合预期，提供流畅的用户体验。记住，框架的配置类不仅是简单的数据容器，更是决定组件生命周期的重要元数据。