Navigation3 기반 앱 네비게이션 시스템 구축 및 Scaffold 기본 구조 구현

Prezel/app/build.gradle.kts

@@ -1,6 +1,7 @@
 plugins {
     alias(libs.plugins.prezel.android.application.compose)
     alias(libs.plugins.prezel.hilt)
+    alias(libs.plugins.kotlinx.serialization)
 }
 
 android {
@@ -14,9 +15,17 @@ android {
 dependencies {
     implementation(projects.coreData)
     implementation(projects.coreDesignsystem)
+    implementation(projects.coreNavigation)
+    implementation(projects.featureHomeApi)
+    implementation(projects.featureHomeImpl)
+    implementation(projects.featureHistoryApi)
+    implementation(projects.featureHistoryImpl)
+    implementation(projects.featureProfileApi)
+    implementation(projects.featureProfileImpl)
 
-    implementation(libs.androidx.activity.ktx)
     implementation(libs.androidx.core.ktx)
     implementation(libs.androidx.lifecycle.runtime.ktx)
+    implementation(libs.androidx.navigation3.ui)
     implementation(libs.timber)
+    implementation(libs.kotlinx.collections.immutable)
 }

Prezel/app/src/main/java/com/team/prezel/MainActivity.kt

@@ -4,47 +4,38 @@ import android.os.Bundle
 import androidx.activity.ComponentActivity
 import androidx.activity.compose.setContent
 import androidx.activity.enableEdgeToEdge
-import androidx.compose.foundation.layout.fillMaxSize
-import androidx.compose.foundation.layout.padding
-import androidx.compose.material3.Scaffold
-import androidx.compose.material3.Text
-import androidx.compose.runtime.Composable
-import androidx.compose.ui.Modifier
-import androidx.compose.ui.tooling.preview.Preview
+import androidx.navigation3.runtime.EntryProviderScope
+import androidx.navigation3.runtime.NavKey
+import com.team.prezel.core.data.NetworkMonitor
 import com.team.prezel.core.designsystem.theme.PrezelTheme
+import com.team.prezel.ui.PrezelApp
+import com.team.prezel.ui.rememberPrezelAppState
+import dagger.hilt.android.AndroidEntryPoint
+import javax.inject.Inject
 
+@AndroidEntryPoint
 class MainActivity : ComponentActivity() {
+    @Inject
+    lateinit var networkMonitor: NetworkMonitor
+
+    @Inject
+    lateinit var entryBuilders: Set<@JvmSuppressWildcards EntryProviderScope<NavKey>.() -> Unit>
+
     override fun onCreate(savedInstanceState: Bundle?) {
         super.onCreate(savedInstanceState)
         enableEdgeToEdge()
+
         setContent {
             PrezelTheme {
-                Scaffold(modifier = Modifier.fillMaxSize()) { innerPadding ->
-                    Greeting(
-                        name = "Android",
-                        modifier = Modifier.padding(innerPadding),
-                    )
-                }
+                val appState = rememberPrezelAppState(
+                    networkMonitor = networkMonitor,
+                )
+
+                PrezelApp(
+                    appState = appState,
+                    entryBuilders = entryBuilders,
+                )
             }
         }
     }
 }
-
-@Composable
-fun Greeting(
-    name: String,
-    modifier: Modifier = Modifier,
-) {
-    Text(
-        text = "Hello $name!",
-        modifier = modifier,
-    )
-}
-
-@Preview(showBackground = true)
-@Composable
-fun GreetingPreview() {
-    PrezelTheme {
-        Greeting("Android")
-    }
-}

Prezel/app/src/main/java/com/team/prezel/navigation/TopLevelNavItem.kt

@@ -0,0 +1,40 @@
+package com.team.prezel.navigation
+
+import androidx.annotation.DrawableRes
+import androidx.annotation.StringRes
+import androidx.navigation3.runtime.NavKey
+import com.team.prezel.R
+import com.team.prezel.core.designsystem.icon.PrezelIcons
+import com.team.prezel.feature.history.api.HistoryNavKey
+import com.team.prezel.feature.home.api.HomeNavKey
+import com.team.prezel.feature.profile.api.ProfileNavKey
+import kotlinx.collections.immutable.ImmutableSet
+import kotlinx.collections.immutable.persistentMapOf
+
+data class TopLevelNavItem(
+    @param:DrawableRes val iconRes: Int,
+    @param:StringRes val titleTextId: Int,
+)
+
+val HOME = TopLevelNavItem(
+    iconRes = PrezelIcons.Home,
+    titleTextId = R.string.bottom_nav_home,
+)
+
+val HISTORY = TopLevelNavItem(
+    iconRes = PrezelIcons.Storage,
+    titleTextId = R.string.bottom_nav_history,
+)
+
+val PROFILE = TopLevelNavItem(
+    iconRes = PrezelIcons.Profile,
+    titleTextId = R.string.bottom_nav_profile,
+)
+
+val TOP_LEVEL_NAV_ITEMS = persistentMapOf(
+    HomeNavKey to HOME,
+    HistoryNavKey to HISTORY,
+    ProfileNavKey to PROFILE,
+)
+
+val TOP_LEVEL_KEYS: ImmutableSet<NavKey> = TOP_LEVEL_NAV_ITEMS.keys

Prezel/app/src/main/java/com/team/prezel/ui/PrezelApp.kt

@@ -0,0 +1,87 @@
+package com.team.prezel.ui
+
+import androidx.compose.animation.core.tween
+import androidx.compose.animation.fadeIn
+import androidx.compose.animation.fadeOut
+import androidx.compose.animation.togetherWith
+import androidx.compose.foundation.layout.padding
+import androidx.compose.material3.SnackbarHostState
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.CompositionLocalProvider
+import androidx.compose.runtime.remember
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.res.stringResource
+import androidx.navigation3.runtime.EntryProviderScope
+import androidx.navigation3.runtime.NavKey
+import androidx.navigation3.runtime.entryProvider
+import androidx.navigation3.ui.NavDisplay
+import com.team.prezel.core.designsystem.component.PrezelNavigationScaffold
+import com.team.prezel.core.designsystem.icon.DrawableIcon
+import com.team.prezel.core.navigation.LocalNavigator
+import com.team.prezel.core.navigation.LocalSnackbarHostState
+import com.team.prezel.core.navigation.Navigator
+import com.team.prezel.core.navigation.toEntries
+import com.team.prezel.navigation.TOP_LEVEL_NAV_ITEMS
+
+@Composable
+fun PrezelApp(
+    appState: PrezelAppState,
+    entryBuilders: Set<EntryProviderScope<NavKey>.() -> Unit>,
+) {
+    val navigator = remember(appState.navigationState) { Navigator(appState.navigationState) }
+    val snackbarHostState = remember { SnackbarHostState() }
+
+    CompositionLocalProvider(
+        LocalNavigator provides navigator,
+        LocalSnackbarHostState provides snackbarHostState,
+    ) {
+        PrezelAppContent(
+            appState = appState,
+            entryBuilders = entryBuilders,
+        )
+    }
+}
+
+@Composable
+private fun PrezelAppContent(
+    appState: PrezelAppState,
+    entryBuilders: Set<EntryProviderScope<NavKey>.() -> Unit>,
+) {
+    val navigator = LocalNavigator.current
+    val snackbarHostState = LocalSnackbarHostState.current
+
+    val provider = remember(entryBuilders) {
+        entryProvider {
+            entryBuilders.forEach { builder -> this.builder() }
+        }
+    }
+
+    PrezelNavigationScaffold(
+        showNavigationBar = appState.shouldShowNavigationBar,
+        snackbarHostState = snackbarHostState,
+        navigationItems = {
+            TOP_LEVEL_NAV_ITEMS.forEach { (key, item) ->
+                item(
+                    selected = key == appState.navigationState.currentTopLevelKey,
+                    onClick = { navigator.navigate(key) },
+                    label = stringResource(item.titleTextId),
+                    icon = DrawableIcon(item.iconRes),
+                )
+            }
+        },
+    ) { padding ->
+        NavDisplay(
+            entries = appState.navigationState.toEntries(provider),
+            onBack = navigator::goBack,
+            modifier = Modifier.padding(padding),
+            transitionSpec = {
+                fadeIn(animationSpec = tween(durationMillis = 100)) togetherWith
+                    fadeOut(animationSpec = tween(durationMillis = 100))
+            },
+            popTransitionSpec = {
+                fadeIn(animationSpec = tween(durationMillis = 100)) togetherWith
+                    fadeOut(animationSpec = tween(durationMillis = 100))
+            },
+        )
+    }
+}

Prezel/app/src/main/java/com/team/prezel/ui/PrezelAppState.kt

@@ -0,0 +1,59 @@
+package com.team.prezel.ui
+
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.Stable
+import androidx.compose.runtime.remember
+import androidx.compose.runtime.rememberCoroutineScope
+import com.team.prezel.core.data.NetworkMonitor
+import com.team.prezel.core.navigation.NavigationState
+import com.team.prezel.core.navigation.rememberNavigationState
+import com.team.prezel.feature.home.api.HomeNavKey
+import com.team.prezel.navigation.TOP_LEVEL_KEYS
+import com.team.prezel.navigation.TOP_LEVEL_NAV_ITEMS
+import kotlinx.coroutines.CoroutineScope
+import kotlinx.coroutines.flow.SharingStarted
+import kotlinx.coroutines.flow.StateFlow
+import kotlinx.coroutines.flow.map
+import kotlinx.coroutines.flow.stateIn
+
+@Composable
+fun rememberPrezelAppState(
+    networkMonitor: NetworkMonitor,
+    coroutineScope: CoroutineScope = rememberCoroutineScope(),
+): PrezelAppState {
+    val navigationState = rememberNavigationState(
+        startKey = HomeNavKey,
+        topLevelKeys = TOP_LEVEL_NAV_ITEMS.keys,
+    )
+
+    return remember(
+        navigationState,
+        coroutineScope,
+        networkMonitor,
+    ) {
+        PrezelAppState(
+            navigationState = navigationState,
+            coroutineScope = coroutineScope,
+            networkMonitor = networkMonitor,
+        )
+    }
+}
+
+@Stable
+class PrezelAppState(
+    val navigationState: NavigationState,
+    coroutineScope: CoroutineScope,
+    networkMonitor: NetworkMonitor,
+) {
+    val shouldShowNavigationBar
+        get() = navigationState.currentKey in TOP_LEVEL_KEYS
+
+    val isOffline: StateFlow<Boolean> =
+        networkMonitor.isOnline
+            .map(Boolean::not)
+            .stateIn(
+                scope = coroutineScope,
+                started = SharingStarted.WhileSubscribed(5_000),
+                initialValue = false,
+            )
+}

Prezel/app/src/main/res/values/strings.xml

@@ -1,3 +1,7 @@
 <resources>
     <string name="app_name">Prezel</string>
+
+    <string name="bottom_nav_home">홈</string>
+    <string name="bottom_nav_history">히스토리</string>
+    <string name="bottom_nav_profile">프로필</string>
 </resources>

Prezel/build-logic/convention/src/main/java/com/team/prezel/buildlogic/convention/internal/AndroidCompose.kt

@@ -18,6 +18,7 @@ internal fun Project.configureAndroidCompose(commonExtension: CommonExtension<*,
             "implementation"(platform(bom))
             "implementation"(libs.findBundle("android-compose").get())
             "androidTestImplementation"(platform(bom))
+            "androidTestImplementation"(libs.findLibrary("androidx.lifecycle.runtimeTesting").get())
             "implementation"(libs.findLibrary("androidx-compose-ui-tooling-preview").get())
             "debugImplementation"(libs.findLibrary("androidx-compose-ui-tooling").get())
         }

Prezel/build-logic/convention/src/main/java/com/team/prezel/buildlogic/convention/plugin/AndroidFeatureApiConventionPlugin.kt

@@ -1,5 +1,6 @@
 package com.team.prezel.buildlogic.convention.plugin
 
+import com.team.prezel.buildlogic.convention.internal.libs
 import org.gradle.api.Plugin
 import org.gradle.api.Project
 import org.gradle.kotlin.dsl.apply
@@ -12,7 +13,7 @@ class AndroidFeatureApiConventionPlugin : Plugin<Project> {
             apply(plugin = "org.jetbrains.kotlin.plugin.serialization")
 
             dependencies {
-//                "api"(project(":core:navigation"))
+                "implementation"(libs.findLibrary("androidx.navigation3.runtime").get())
             }
         }
     }

Prezel/build-logic/convention/src/main/java/com/team/prezel/buildlogic/convention/plugin/AndroidFeatureImplConventionPlugin.kt

@@ -11,7 +11,7 @@ import org.gradle.kotlin.dsl.dependencies
 class AndroidFeatureImplConventionPlugin : Plugin<Project> {
     override fun apply(target: Project) {
         with(target) {
-            apply(plugin = "prezel.android.library")
+            apply(plugin = "prezel.android.library.compose")
             apply(plugin = "prezel.hilt")
 
             extensions.configure<LibraryExtension> {
@@ -20,14 +20,9 @@ class AndroidFeatureImplConventionPlugin : Plugin<Project> {
 
             dependencies {
 //                "implementation"(project(":core:ui"))
-                "implementation"(project(":core:designsystem"))
-
-                "implementation"(libs.findLibrary("androidx.lifecycle.runtimeCompose").get())
-                "implementation"(libs.findLibrary("androidx.lifecycle.viewModelCompose").get())
-
-                "androidTestImplementation"(
-                    libs.findLibrary("androidx.lifecycle.runtimeTesting").get(),
-                )
+                "implementation"(project(":core-designsystem"))
+                "implementation"(project(":core-navigation"))
+                "implementation"(libs.findLibrary("androidx.navigation3.ui").get())
             }
         }
     }

Prezel/core/data/build.gradle.kts

@@ -10,5 +10,6 @@ android {
 
 dependencies {
     implementation(projects.coreNetwork)
+
     implementation(libs.kotlinx.coroutines.core)
 }

Prezel/core/data/src/main/AndroidManifest.xml

@@ -1,4 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<manifest>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
 
+    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
 </manifest>