Android含CheckBox自定义View 屏幕旋转后多实例状态错乱如何解决
问题根因
Android框架默认的视图状态保存机制,是通过控件的android:id做索引来收集、存储、恢复状态的。当前实现里,自定义View内部的CheckBox固定复用@+id/check_box,页面上每放置一个CustomView实例,就会多一个id完全相同的CheckBox。
系统遍历视图树收集状态时,相同id对应的状态值会被反复覆盖,最终所有同id的CheckBox在恢复时,拿到的都是最后一次被写入的状态,就会出现全部选中、全部不选中的异常表现。
常见误区:很多开发者以为merge标签导入的子View的id只在自定义View内部生效,实际上Android的视图状态收集是全局遍历整个视图树的,不存在自定义View内部的id作用域隔离。
解决方法
方案一:动态分配内部子控件的唯一id(低改动成本)
直接在自定义View的初始化逻辑中,给内部需要保存状态的CheckBox动态生成系统级唯一id,从根源上避免id冲突:
class CustomView @JvmOverloads constructor( context: Context, attrs: AttributeSet? = null, defStyleAttr: Int = 0 ) : LinearLayout(context, attrs, defStyleAttr) { private val binding = ViewCustomBinding.inflate(LayoutInflater.from(context), this) init { orientation = HORIZONTAL // 给内部CheckBox生成全局唯一id,替换布局中写死的固定id binding.checkBox.id = View.generateViewId() } }
- 实现原理:每个
CustomView实例的CheckBox都会拿到一个不重复的id值,系统在全局收集视图状态时不会出现覆盖冲突,能正确保存每个CheckBox的独立状态 - 配套调整:原布局中CheckBox的
android:id="@+id/check_box"可以保留也可以删除,初始化时的动态id会直接覆盖固定id的值
方案二:自定义独立的状态保存逻辑(高扩展性)
如果后续自定义View需要维护更多内部状态字段,可以重写View的状态保存/恢复逻辑,把内部状态和全局id索引机制隔离开:
修改CustomView实现如下:
class CustomView @JvmOverloads constructor( context: Context, attrs: AttributeSet? = null, defStyleAttr: Int = 0 ) : LinearLayout(context, attrs, defStyleAttr) { private val binding = ViewCustomBinding.inflate(LayoutInflater.from(context), this) init { orientation = HORIZONTAL // 开启自身状态保存能力 isSaveEnabled = true } // 自定义状态容器,打包内部控件的独立状态 override fun onSaveInstanceState(): Parcelable { val superState = super.onSaveInstanceState() val savedState = SavedState(superState) // 把CheckBox的选中状态独立存入自定义状态对象 savedState.checkState = binding.checkBox.isChecked return savedState } override fun onRestoreInstanceState(state: Parcelable?) { if (state is SavedState) { super.onRestoreInstanceState(state.superState) // 恢复当前实例独立存储的CheckBox状态 binding.checkBox.isChecked = state.checkState } else { super.onRestoreInstanceState(state) } } // 实现Parcelable接口,支持状态的序列化和反序列化 class SavedState : BaseSavedState { var checkState: Boolean = false constructor(superState: Parcelable) : super(superState) constructor(source: Parcel) : super(source) { checkState = source.readInt() == 1 } override fun writeToParcel(out: Parcel, flags: Int) { super.writeToParcel(out, flags) out.writeInt(if (checkState) 1 else 0) } companion object { @JvmField val CREATOR = object : Parcelable.Creator<SavedState> { override fun createFromParcel(source: Parcel): SavedState = SavedState(source) override fun newArray(size: Int): Array<SavedState?> = arrayOfNulls(size) } } } }
- 实现原理:每个
CustomView实例会把自己内部的CheckBox状态打包成和自身绑定的Parcelable对象,不再参与全局按id的状态映射,完全避免了多实例之间的状态干扰
注意事项
- 两种方案不需要叠加使用,根据实际需求选择即可:短期临时修复优先选方案一,长期维护、需要扩展更多内部状态的场景优先选方案二
- 即使配置了
android:configChanges自行处理屏幕旋转,以上逻辑依然需要保留:因为系统在内存不足回收页面、APP切后台长时间运行后回收视图状态的场景,依然会触发状态保存恢复流程,不处理还是会出现状态丢失问题
内容的提问来源于stack exchange,提问作者Tomislav Turcic
相关产品推荐
相关产品推荐

