使用AndroidViewBinding包裹NavHostFragment时exitAnim与popExitAnim失效问题

我们的App基于Jetpack Compose开发，为了复用现有大量XML导航图（迁移到Compose NavHost成本过高），采用AndroidViewBinding包裹NavHostFragment的方式沿用传统导航。目前核心代码能正常运行，但导航action中定义的exitAnim和popExitAnim完全没有效果，enterAnim和popEnterAnim却能正常触发。

核心实现代码如下：

Compose层代码 #

@Composable
private fun HfAppContent(
    state: MainViewState,
    eventHandler: (MainViewEvent) -> Unit
) {
    AndroidViewBinding(
        factory = FragmentNavHostBinding::inflate,
        modifier = Modifier.fillMaxSize(),
        onReset = {

        }
    ) {
        if (state.navController == null) {
            fragmentContainerView.getFragment<NavHostFragment>().navController.let {
                eventHandler(MainViewEvent.NavControllerInitialized(it))
            }
        }
    }
}

布局XML（FragmentNavHostBinding对应的布局） #

<?xml version="1.0" encoding="utf-8"?>
<FrameLayout
    xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/container"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <androidx.fragment.app.FragmentContainerView
        android:id="@+id/fragment_container_view"
        android:name="androidx.navigation.fragment.NavHostFragment"
        android:layout_width="match_parent"
        android:layout_height="match_parent" />

</FrameLayout>

导航action配置（问题所在） #

<navigation xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    android:id="@+id/navigation_login"
    app:startDestination="@+id/login">

    <fragment
        android:id="@+id/login"
        android:name="com.myapp.features.login.view.LoginFragment">       

        <action
            android:id="@+id/forgot_password_action"
            app:destination="@+id/forgotPasswordEmail"
            app:enterAnim="@anim/slide_in_from_right"
            app:exitAnim="@anim/slide_out_to_left"
            app:popEnterAnim="@anim/slide_in_from_left"
            app:popExitAnim="@anim/slide_out_to_right" />

    </fragment>

</navigation>

解决办法 #

1. 确保NavHostFragment是主导航Fragment #

在Compose环境中，若NavHostFragment未被设置为主导航Fragment，系统可能无法正确处理退出动画。修改Compose层的初始化逻辑，添加主导航Fragment的设置：

@Composable
private fun HfAppContent(
    state: MainViewState,
    eventHandler: (MainViewEvent) -> Unit,
    activity: FragmentActivity // 从上层传入Activity引用
) {
    AndroidViewBinding(
        factory = FragmentNavHostBinding::inflate,
        modifier = Modifier.fillMaxSize(),
        onReset = {

        }
    ) {
        if (state.navController == null) {
            val navHostFragment = fragmentContainerView.getFragment<NavHostFragment>()
            // 设置为主导航Fragment，确保动画系统正常工作
            activity.supportFragmentManager.beginTransaction()
                .setPrimaryNavigationFragment(navHostFragment)
                .commitNow()
            
            navHostFragment.navController.let {
                eventHandler(MainViewEvent.NavControllerInitialized(it))
            }
        }
    }
}

2. 检查动画资源的有效性 #

虽然enterAnim正常，但仍需确认退出动画的资源配置是否正确。以slide_out_to_left.xml为例，确保动画逻辑符合预期：

<?xml version="1.0" encoding="utf-8"?>
<translate xmlns:android="http://schemas.android.com/apk/res/android"
    android:duration="@android:integer/config_mediumAnimTime"
    android:fromXDelta="0%"
    android:toXDelta="-100%"
    android:interpolator="@android:anim/decelerate_interpolator"/>

避免给动画添加android:fillAfter="true"这类会导致视图状态异常的属性，确保动画结束后视图能被正确销毁。

3. 手动在导航时注入退出动画（临时 workaround） #

如果XML配置仍不生效，可以在调用导航action时，手动通过FragmentNavigator.Extras传入动画配置，覆盖XML的设置：

// 在LoginFragment中调用导航的地方
findNavController().navigate(R.id.forgot_password_action) {
    val extras = FragmentNavigator.Extras.Builder()
        .setExitAnim(R.anim.slide_out_to_left)
        .setPopExitAnim(R.anim.slide_out_to_right)
        .build()
    this.extras = extras
}

4. 升级Navigation组件版本 #

旧版本的Navigation组件与Compose的兼容性可能存在bug，导致退出动画失效。确保Navigation相关依赖使用同一版本（建议使用最新稳定版）：

// build.gradle.kts（Module级别）
dependencies {
    implementation("androidx.navigation:navigation-fragment-ktx:2.7.7")
    implementation("androidx.navigation:navigation-compose:2.7.7")
}

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