多模块Compose项目导航方案咨询：兼顾模块化与内部导航

核心原则验证 #

你的核心原则完全符合模块化导航的最佳实践，无需修正：

• 跨模块顶级页面导航由MainNavGraph统一管理
• 单模块内部的屏幕跳转完全由模块自身管控
• 屏幕通过回调/密封类传递导航意图，避免直接持有NavController

问题解决方案 #

针对你提出的模块化隔离和内部导航实现问题，以下是具体落地方案：

1. 模块化隔离：隐藏内部导航细节 #

每个功能模块仅对外暴露跨模块导航入口，内部路由、导航方法全部用internal修饰（Kotlin），确保仅模块内可见：

修改HomeNavigation.kt

// 模块内部导航方法，仅模块内可见
internal fun NavController.navigateToMap() {
    navigate(route = NavigationRoute.Map)
}

internal fun NavController.navigateToItemDetail(id: Int = Int.MIN_VALUE) {
    navigate(NavigationRoute.ItemDetail(id))
}

// 对外暴露的导航图构建器，仅接收跨模块导航意图
fun NavGraphBuilder.homeNavGraph(
    onCrossModuleAction: (CrossModuleNavAction) -> Unit
) {
    navigation<NavigationGraphs.HomeGraph>(startDestination = NavigationRoute.Home) {
        composable<NavigationRoute.Home> {
            HomeSection(
                onItemClick = { id ->
                    // 模块内部跳转，直接在模块内处理
                    navController.navigateToItemDetail(id)
                },
                onOpenSettingsClick = {
                    // 跨模块跳转，通过回调传递给全局导航器
                    onCrossModuleAction(CrossModuleNavAction.OpenSettings)
                },
                onOpenMapClick = {
                    // 模块内部跳转，无需透传外部
                    navController.navigateToMap()
                }
            )
        }
        // 模块内部的其他屏幕，仅在模块内定义
        composable<NavigationRoute.Map> {
            MapScreen(
                onBackClick = { navController.popBackStack() }
            )
        }
        composable<NavigationRoute.ItemDetail> { backStackEntry ->
            val id = backStackEntry.arguments?.getInt("id") ?: 0
            ItemDetailScreen(
                itemId = id,
                onBackClick = { navController.popBackStack() }
            )
        }
    }
}

// 仅定义跨模块的导航意图，内部意图无需对外暴露
sealed class CrossModuleNavAction {
    object OpenSettings : CrossModuleNavAction()
}

2. 导航职责拆分：全局与模块导航解耦 #

避免直接给模块传递NavController，通过导航意图委托实现职责分离：

• 全局AppNavigator仅处理跨模块跳转
• 模块内部自行管控内部导航逻辑

实现全局AppNavigator

class AppNavigator(private val navController: NavHostController) {
    // 处理来自模块的跨模块导航请求
    fun handleCrossModuleAction(action: CrossModuleNavAction) {
        when (action) {
            CrossModuleNavAction.OpenSettings -> navigateToSettings()
        }
    }

    // 仅对外暴露跨模块导航方法
    fun navigateToSettings() {
        navController.navigate(NavigationRoute.Settings)
    }
}

// 在MainNavGraph中注入全局导航器
@Composable
fun MainNavGraph(
    appNavigator: AppNavigator = AppNavigator(rememberNavController())
) {
    Box(modifier = Modifier.fillMaxSize()) {
        NavHost(
            navController = appNavigator.navController,
            startDestination = NavigationGraphs.HomeGraph
        ) {
            homeNavGraph { action -> appNavigator.handleCrossModuleAction(action) }
            settingsGraph()
        }
    }
}

3. 跨平台兼容优化 #

若需支持跨平台，可将导航逻辑抽象为接口，模块依赖抽象而非Android专属的NavController：

共享模块定义导航抽象

// 平台无关的导航接口
interface HomeFeatureNavigator {
    fun navigateToItemDetail(id: Int)
    fun navigateToMap()
    fun popBackStack()
}

// Android平台实现
class AndroidHomeNavigator(private val navController: NavController) : HomeFeatureNavigator {
    override fun navigateToItemDetail(id: Int) {
        navController.navigate(NavigationRoute.ItemDetail(id))
    }

    override fun navigateToMap() {
        navController.navigate(NavigationRoute.Map)
    }

    override fun popBackStack() {
        navController.popBackStack()
    }
}

模块内的屏幕依赖HomeFeatureNavigator接口，其他平台可实现对应导航逻辑，完全解耦Android依赖。

方案优势 #

• 严格遵循模块化：内部导航逻辑、路由仅对模块可见，无全局暴露风险
• 职责清晰：全局导航器处理跨模块跳转，模块内部管控内部导航
• 跨平台友好：通过抽象接口隔离平台依赖，无需绑定Android的NavController

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