Conductor高级用法：子路由器、状态持久化和自定义ChangeHandler

Conductor是一个轻量级却功能全面的Android框架，专为构建基于View的应用程序设计。本文将深入探讨Conductor的三大高级特性：子路由器（Child Router）、状态持久化和自定义ChangeHandler，帮助开发者构建更灵活、高效的Android应用架构。

一、子路由器（Child Router）：构建复杂界面的核心

子路由器是Conductor实现复杂界面布局的关键组件，允许在单个Controller中嵌套多个子Controller，特别适合实现如Master/Detail这样的高级界面模式。

1.1 基本使用方法

通过getChildRouter()方法可以在Controller中获取子路由器实例，通常在onViewBound()生命周期方法中初始化：

val childRouter = getChildRouter(binding.detailContainer)
    .setPopRootControllerMode(PopRootControllerMode.POP_ROOT_CONTROLLER_BUT_NOT_VIEW)
childRouter.setRoot(RouterTransaction.with(DetailController()))

1.2 实际应用场景

在demo/src/main/java/com/bluelinelabs/conductor/demo/controllers/MultipleChildRouterController.kt中，展示了如何在一个Controller中管理多个子路由器，实现复杂的多面板布局。这种模式特别适合平板应用或需要同时展示多个内容区域的场景。

1.3 子路由器生命周期

子路由器的生命周期与其父Controller紧密关联。当父Controller的视图被销毁时，子路由器也会相应地销毁其管理的视图，但可以通过设置适当的保留策略来保持控制器实例。

二、状态持久化：确保数据不丢失

在Android应用开发中，状态持久化是确保用户体验的关键。Conductor提供了完善的状态保存与恢复机制，帮助开发者轻松处理配置变更等场景。

2.1 基本实现方式

Conductor的Controller类提供了onSaveInstanceState()和onRestoreInstanceState()方法，用于保存和恢复控制器状态：

override fun onSaveInstanceState(outState: Bundle) {
    super.onSaveInstanceState(outState)
    outState.putString(KEY_SELECTED_ITEM, selectedItem)
}

override fun onRestoreInstanceState(savedInstanceState: Bundle) {
    super.onRestoreInstanceState(savedInstanceState)
    selectedItem = savedInstanceState.getString(KEY_SELECTED_ITEM)
}

2.2 状态管理最佳实践

在demo/src/main/java/com/bluelinelabs/conductor/demo/controllers/TargetDisplayController.kt中，可以看到如何优雅地保存和恢复用户交互状态。建议将所有需要持久化的数据通过Bundle进行保存，并在恢复时进行验证，确保应用稳定性。

2.3 Controller生命周期与状态

了解Controller的完整生命周期对于实现正确的状态管理至关重要。下图展示了Conductor Controller的完整生命周期：


从图中可以看出，onSaveInstanceState()在Controller被推入后台或应用进程被终止前调用，而onRestoreInstanceState()则在Controller重建时被调用，这为状态持久化提供了明确的时机。

三、自定义ChangeHandler：打造流畅过渡动画

ChangeHandler负责Controller之间的过渡动画和视图切换逻辑，Conductor提供了灵活的扩展机制，允许开发者创建自定义的过渡效果。

3.1 基础ChangeHandler实现

自定义ChangeHandler通常继承自AnimatorChangeHandler或TransitionChangeHandler。以下是一个简单的淡入淡出效果实现：

public class FadeChangeHandler extends AnimatorChangeHandler {
    @Override
    protected Animator getAnimator(ViewGroup container, View from, View to, boolean isPush, boolean toAddedToContainer) {
        AnimatorSet set = new AnimatorSet();
        if (to != null) {
            to.setAlpha(0);
            set.play(ObjectAnimator.ofFloat(to, View.ALPHA, 0, 1));
        }
        if (from != null) {
            set.play(ObjectAnimator.ofFloat(from, View.ALPHA, 1, 0));
        }
        return set;
    }
}

3.2 高级过渡效果

在demo/src/main/java/com/bluelinelabs/conductor/demo/changehandler目录下，Conductor提供了多种高级过渡效果的实现，如：

• CircularRevealChangeHandler：实现圆形揭露效果
• FlipChangeHandler：实现翻转过渡效果
• ScaleFadeChangeHandler：实现缩放淡入淡出效果
• ArcFadeMoveChangeHandler：实现弧形移动过渡效果

这些实现展示了如何结合Android的动画API创建复杂而流畅的过渡效果。

3.3 在RouterTransaction中应用

创建自定义ChangeHandler后，可以在RouterTransaction中使用：

RouterTransaction.with(DetailController())
    .pushChangeHandler(ScaleFadeChangeHandler())
    .popChangeHandler(FlipChangeHandler())

四、综合应用：构建复杂交互界面

将上述三个高级特性结合使用，可以构建出功能强大且用户体验出色的复杂界面。例如，在demo/src/main/java/com/bluelinelabs/conductor/demo/controllers/MasterDetailListController.kt中，结合了子路由器和自定义ChangeHandler，实现了响应式的Master/Detail界面，同时通过状态持久化确保用户选择不丢失。

实现步骤概要：

1. 使用getChildRouter()创建子路由器管理详情面板
2. 实现onSaveInstanceState()保存选中的列表项
3. 在onRestoreInstanceState()中恢复选中状态并更新UI
4. 使用自定义ChangeHandler实现列表项到详情的平滑过渡

五、总结

Conductor的子路由器、状态持久化和自定义ChangeHandler三大高级特性，为Android开发者提供了构建复杂界面和流畅用户体验的强大工具。通过合理运用这些特性，可以显著提升应用的架构灵活性和用户体验。

要开始使用Conductor，只需克隆仓库并按照官方文档进行集成：

git clone https://gitcode.com/gh_mirrors/con/Conductor

探索demo目录中的示例代码，了解这些高级特性的实际应用，将帮助你更快掌握Conductor的强大功能。无论是构建简单的单屏应用还是复杂的多面板界面，Conductor都能提供简洁而强大的解决方案。