Android Navigation Component中BottomSheet内Fragment B绑定监听器问题

现有代码 #

Fragment B 实现 #

class FragmentB : Fragment() {
    private var myListener: MyListener? = null
    
    ... // onCreate和其他方法
    ...

    fun setListener(listener: MyListener) {
        myListener = listener
    }
}

原有监听器绑定方式（非Navigation场景） #

val fragment = FragmentB.newInstance()

val myListener = object : MyListener {
    override fun someMethodA() {
        // action 1
    }
    override fun someMethodB() {
        // action 2
    }
}

fragment.setListener(myListener)
// 显示Fragment...

核心需求 #

实现基于Navigation Component + navGraph的BottomSheet：

• 打开BottomSheet后默认显示Fragment A
• 点击Fragment A的按钮跳转至Fragment B
  目前已完成Fragment切换，但无法稳定绑定Fragment B的监听器——当Navigation重建Fragment B时，监听器会重置为null。

已尝试方案 #

给NavController添加OnDestinationChangedListener，在跳转至Fragment B时绑定监听器：

NavController.OnDestinationChangedListener { _, destination, _ ->
    when (destination.id) {
         R.id.fragmentB -> {
             attachListenerToFragmentB(myListener)
         }
    }
}

private fun attachListenerToFragmentB(myListener: MyListener) {
   val fragment = fragmentManager?.fragments?.filterNotNull()?.find {
       it.javaClass.name == (navController?.currentDestination as FragmentNavigator.Destination).className 
       ?: return
   }

   if (fragment is FragmentB)
       fragment.setListener(myListener)
}

问题：仅能临时绑定监听器，Fragment B被Navigation重建后，监听器变为null。

跳转代码（Fragment A → Fragment B） #

val action = EntryPointFragmentDirections.navigateToFragmentB()
action.id = id  // 传递参数
findNavController().navigate(action)

以下方案同时兼容原有直接实例化绑定的方式，以及Navigation Component的场景：

方案1：共享ViewModel（推荐，稳定无泄漏） #

通过ViewModel在BottomSheet的宿主（Activity/父Fragment）和Fragment B之间共享回调，避免重建丢失：

1. 定义共享ViewModel：

class BottomSheetSharedViewModel : ViewModel() {
    // 用LiveData监听回调变化
    val myListener = MutableLiveData<MyListener?>()
}

2. 在宿主（Activity/父Fragment）中初始化并设置回调：

// 获取BottomSheet对应的NavController的ViewModelStoreOwner，确保共享范围正确
val sharedViewModel = ViewModelProvider(navController.viewModelStoreOwner)[BottomSheetSharedViewModel::class.java]
sharedViewModel.myListener.value = object : MyListener {
    override fun someMethodA() {
        // 执行操作1
    }
    override fun someMethodB() {
        // 执行操作2
    }
}

3. 修改Fragment B，绑定ViewModel的回调：

class FragmentB : Fragment() {
    private var myListener: MyListener? = null
    private lateinit var sharedViewModel: BottomSheetSharedViewModel

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        // 获取共享ViewModel
        sharedViewModel = ViewModelProvider(requireParentFragment().viewModelStoreOwner)[BottomSheetSharedViewModel::class.java]
        // 监听回调，Fragment重建时自动恢复
        sharedViewModel.myListener.observe(this) { listener ->
            myListener = listener
        }
    }

    // 保留原有setListener方法，兼容非Navigation场景
    fun setListener(listener: MyListener) {
        myListener = listener
        // 同步到ViewModel，防止重建丢失（可选）
        sharedViewModel.myListener.value = listener
    }
}

方案2：从宿主获取回调（简单直接） #

让宿主（Activity/父Fragment）实现MyListener接口，Fragment B在生命周期中主动获取：

1. 宿主实现MyListener：

class HostActivity : AppCompatActivity(), MyListener {
    override fun someMethodA() {
        // 执行操作1
    }
    override fun someMethodB() {
        // 执行操作2
    }
}

2. 修改Fragment B，在生命周期中获取回调：

class FragmentB : Fragment() {
    private var myListener: MyListener? = null

    override fun onAttach(context: Context) {
        super.onAttach(context)
        // 优先从宿主获取回调
        if (context is MyListener) {
            myListener = context
        }
    }

    override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
        super.onViewCreated(view, savedInstanceState)
        // 重建后再次尝试获取
        if (myListener == null && requireContext() is MyListener) {
            myListener = requireContext() as MyListener
        }
    }

    // 保留原有setListener方法，兼容旧方式（优先级高于宿主接口）
    fun setListener(listener: MyListener) {
        myListener = listener
    }
}

方案3：传递弱引用回调（仅临时场景） #

通过导航Extras传递弱引用包装的回调，缺点是重建后会丢失，仅适合临时需求：

1. Fragment A跳转时传递回调：

val action = EntryPointFragmentDirections.navigateToFragmentB()
action.id = id
// 用弱引用包装，避免内存泄漏
val weakListener = WeakReference(myListener)
// 通过arguments传递（注意Navigation安全参数不支持接口，需手动处理）
val bundle = Bundle().apply {
    putSerializable("listener_ref", weakListener)
}
action.setArguments(bundle)
findNavController().navigate(action)

2. Fragment B中获取：

override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
    super.onViewCreated(view, savedInstanceState)
    val weakListener = arguments?.getSerializable("listener_ref") as? WeakReference<MyListener>
    myListener = weakListener?.get()
}

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