动态创建自定义视图时onRestoreInstanceState未被调用

作为从iOS转Android的新手，遇到视图状态恢复的问题太正常了——毕竟两个平台的状态管理逻辑差异不小。针对你用<merge>标签构建的自定义复合视图，动态创建时onRestoreInstanceState从未被调用的问题，我整理了几个关键排查点和解决方案：

1. 给自定义视图设置唯一ID #

Android的视图状态恢复是基于ID匹配的，如果你的自定义视图本身没有设置唯一ID，系统找不到对应的保存状态，自然不会触发onRestoreInstanceState。

动态创建视图时，一定要手动给它分配ID：

CustomSegmentedController customView = new CustomSegmentedController(context);
// 生成唯一ID（API 17+可用）
customView.setId(View.generateViewId());
// 或者用自己定义的ID资源
// customView.setId(R.id.custom_segmented_controller);
parentLayout.addView(customView);

2. 正确实现状态保存与恢复的方法 #

确保你在自定义视图中正确重写了onSaveInstanceState和onRestoreInstanceState，并且调用了父类的对应方法——这很容易被忽略，却直接影响状态流程。

示例代码如下：

public class CustomSegmentedController extends LinearLayout {
    private Button mSelectedButton;

    // 构造函数省略...

    @Override
    protected Parcelable onSaveInstanceState() {
        // 先保存父类的状态
        Parcelable superState = super.onSaveInstanceState();
        // 封装自定义状态
        SavedState savedState = new SavedState(superState);
        // 比如保存选中按钮的ID
        if (mSelectedButton != null) {
            savedState.selectedButtonId = mSelectedButton.getId();
        }
        return savedState;
    }

    @Override
    protected void onRestoreInstanceState(Parcelable state) {
        // 先判断状态是否是我们自定义的类型
        if (!(state instanceof SavedState)) {
            super.onRestoreInstanceState(state);
            return;
        }
        SavedState savedState = (SavedState) state;
        // 先恢复父类状态
        super.onRestoreInstanceState(savedState.getSuperState());
        // 恢复自定义状态
        mSelectedButton = findViewById(savedState.selectedButtonId);
        // 更新UI状态（比如切换按钮选中样式）
        updateButtonSelection(mSelectedButton);
    }

    // 自定义状态类，必须实现Parcelable
    static class SavedState extends BaseSavedState {
        int selectedButtonId;

        SavedState(Parcelable superState) {
            super(superState);
        }

        private SavedState(Parcel in) {
            super(in);
            selectedButtonId = in.readInt();
        }

        @Override
        public void writeToParcel(Parcel out, int flags) {
            super.writeToParcel(out, flags);
            out.writeInt(selectedButtonId);
        }

        public static final Creator<SavedState> CREATOR = new Creator<SavedState>() {
            @Override
            public SavedState createFromParcel(Parcel in) {
                return new SavedState(in);
            }

            @Override
            public SavedState[] newArray(int size) {
                return new SavedState[size];
            }
        };
    }

    // 自定义的UI更新方法
    private void updateButtonSelection(Button selectedButton) {
        // 这里实现按钮选中状态的切换逻辑
    }
}

3. 确保<merge>标签的Inflate方式正确 #

使用<merge>标签的自定义视图，在构造函数中Inflate布局时，第三个参数必须传true，这样才能把<merge>内的按钮正确添加到当前自定义视图的层级中，否则视图结构不完整会影响状态恢复。

正确的Inflate代码：

public CustomSegmentedController(Context context, AttributeSet attrs) {
    super(context, attrs);
    // 第三个参数true：将merge中的视图添加到当前视图（this）中
    LayoutInflater.from(context).inflate(R.layout.your_merge_layout, this, true);
    // 初始化按钮等逻辑...
}

4. 确认视图已被添加到视图树 #

动态创建的视图必须被添加到父布局中（比如parentLayout.addView(customView)），只有当视图**附着到窗口（attached to window）**后，系统才会触发状态恢复的流程。如果只是创建了视图但没添加到布局，onRestoreInstanceState肯定不会被调用。

5. 检查宿主组件的状态恢复流程 #

确保你的自定义视图所在的Activity/Fragment没有破坏状态恢复的流程：

• 不要在onSaveInstanceState中省略super.onSaveInstanceState(outState)；
• 如果设置了android:configChanges（比如orientation|screenSize），系统不会触发重建，自然也不会调用onRestoreInstanceState——这种情况你需要在onConfigurationChanged中手动处理状态。

按照上面的步骤逐一排查，应该就能解决onRestoreInstanceState不触发的问题了。

内容的提问来源于stack exchange，提问作者Scooter