मॉड्यूलर नेविगेशन रेसिपी (Hilt)
इस रेसिपी में, नेविगेशन 3 और Dagger/Hilt का इस्तेमाल करके, मल्टी-मॉड्यूल ऐप्लिकेशन को स्ट्रक्चर करने का तरीका बताया गया है. इसमें डिपेंडेंसी इंजेक्शन के बारे में भी बताया गया है. इसका मकसद, एक ऐसा डीकपल्ड आर्किटेक्चर बनाना है जिसमें नेविगेशन को अलग-अलग फ़ीचर मॉड्यूल में तय और लागू किया जाता है.
यह कैसे काम करता है
ऐप्लिकेशन को कई मॉड्यूल में बांटा गया है:
-
appमॉड्यूल: यह मुख्य ऐप्लिकेशन मॉड्यूल होता है. यह एक सामान्यNavigatorको शुरू करता है और फ़ीचर मॉड्यूल सेEntryProviderInstallerका एक सेट इंजेक्ट करता है. इसके बाद, इन इंस्टॉलर का इस्तेमाल करके,NavDisplayके लिए फ़ाइनलentryProviderबनाया जाता है. -
commonमॉड्यूल: इस मॉड्यूल में मुख्य नेविगेशन लॉजिक शामिल होता है. जैसे:Navigatorक्लास, बैक स्टैक को मैनेज करती है.EntryProviderInstallerटाइप, जो एक ऐसा फ़ंक्शन है जिसका इस्तेमाल सुविधा वाले मॉड्यूल, ऐप्लिकेशन केentryProviderमें नेविगेशन एंट्री जोड़ने के लिए करते हैं.
-
फ़ीचर मॉड्यूल (जैसे,
conversation,profile): हर सुविधा को दो सब-मॉड्यूल में बांटा गया है:apiमॉड्यूल: यह सुविधा के लिए सार्वजनिक एपीआई तय करता है. इसमें नेविगेशन रूट भी शामिल हैं. इससे अन्य मॉड्यूल, इस सुविधा पर नेविगेट कर सकते हैं. इसके लिए, उन्हें इस सुविधा को लागू करने से जुड़ी जानकारी की ज़रूरत नहीं होती.implमॉड्यूल: इसमें सुविधा को लागू करने के बारे में जानकारी होती है. इसमें इसके कंपोज़ेबल और एकEntryProviderInstallerशामिल होता है, जो सुविधा के रास्तों को इसके कंपोज़ेबल से मैप करता है. इसके बाद, Dagger/Hilt का इस्तेमाल करके, इस इंस्टॉलर कोappमॉड्यूल को उपलब्ध कराया जाता है.
मॉड्यूलर अप्रोच से, कोड को अलग-अलग हिस्सों में बांटा जा सकता है. इससे कोड को ज़्यादा आसानी से बढ़ाया जा सकता है और उसका रखरखाव किया जा सकता है. हर सुविधा, नेविगेशन के अपने लॉजिक के लिए ज़िम्मेदार होती है. app मॉड्यूल सिर्फ़ इन हिस्सों को एक साथ जोड़ता है.
package com.example.nav3recipes.modular.hilt import androidx.compose.foundation.background import androidx.compose.foundation.layout.Arrangement import androidx.compose.foundation.layout.Column import androidx.compose.foundation.layout.fillMaxSize import androidx.compose.foundation.layout.padding import androidx.compose.material3.MaterialTheme import androidx.compose.material3.Text import androidx.compose.runtime.Composable import androidx.compose.ui.Alignment import androidx.compose.ui.Modifier import androidx.compose.ui.unit.dp import dagger.Module import dagger.Provides import dagger.hilt.InstallIn import dagger.hilt.android.components.ActivityRetainedComponent import dagger.multibindings.IntoSet // API object Profile // IMPLEMENTATION @Module @InstallIn(ActivityRetainedComponent::class) object ProfileModule { @IntoSet @Provides fun provideEntryProviderInstaller() : EntryProviderInstaller = { entry<Profile>{ ProfileScreen() } } } @Composable private fun ProfileScreen() { val profileColor = MaterialTheme.colorScheme.surfaceVariant Column( modifier = Modifier .fillMaxSize() .background(profileColor) .padding(16.dp), horizontalAlignment = Alignment.CenterHorizontally, verticalArrangement = Arrangement.Center ) { Text( text = "Profile Screen", style = MaterialTheme.typography.headlineMedium, color = MaterialTheme.colorScheme.onSurface ) } }
package com.example.nav3recipes.modular.hilt import android.os.Bundle import androidx.activity.ComponentActivity import androidx.activity.compose.setContent import androidx.compose.foundation.layout.padding import androidx.compose.material3.Scaffold import androidx.compose.ui.Modifier import androidx.navigation3.runtime.entryProvider import androidx.navigation3.ui.NavDisplay import com.example.nav3recipes.ui.setEdgeToEdgeConfig import dagger.hilt.android.AndroidEntryPoint import javax.inject.Inject @AndroidEntryPoint class HiltModularActivity : ComponentActivity() { @Inject lateinit var navigator: Navigator @Inject lateinit var entryProviderScopes: Set<@JvmSuppressWildcards EntryProviderInstaller> override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setEdgeToEdgeConfig() setContent { Scaffold { paddingValues -> NavDisplay( backStack = navigator.backStack, modifier = Modifier.padding(paddingValues), onBack = { navigator.goBack() }, entryProvider = entryProvider { entryProviderScopes.forEach { builder -> this.builder() } } ) } } } }
package com.example.nav3recipes.modular.hilt import androidx.compose.foundation.background import androidx.compose.foundation.clickable import androidx.compose.foundation.layout.Arrangement import androidx.compose.foundation.layout.Column import androidx.compose.foundation.layout.Spacer import androidx.compose.foundation.layout.fillMaxSize import androidx.compose.foundation.layout.fillMaxWidth import androidx.compose.foundation.layout.height import androidx.compose.foundation.layout.padding import androidx.compose.foundation.lazy.LazyColumn import androidx.compose.material3.Button import androidx.compose.material3.ListItem import androidx.compose.material3.ListItemDefaults import androidx.compose.material3.MaterialTheme import androidx.compose.material3.Text import androidx.compose.runtime.Composable import androidx.compose.ui.Alignment import androidx.compose.ui.Modifier import androidx.compose.ui.graphics.Color import androidx.compose.ui.unit.dp import androidx.lifecycle.compose.dropUnlessResumed import com.example.nav3recipes.ui.theme.colors import dagger.Module import dagger.Provides import dagger.hilt.InstallIn import dagger.hilt.android.components.ActivityRetainedComponent import dagger.multibindings.IntoSet // API object ConversationList data class ConversationDetail(val id: Int) { val color: Color get() = colors[id % colors.size] } // IMPL @Module @InstallIn(ActivityRetainedComponent::class) object ConversationModule { @IntoSet @Provides fun provideEntryProviderInstaller(navigator: Navigator): EntryProviderInstaller = { entry<ConversationList> { ConversationListScreen( onConversationClicked = { conversationDetail -> navigator.goTo(conversationDetail) } ) } entry<ConversationDetail> { key -> ConversationDetailScreen(key) { navigator.goTo(Profile) } } } } @Composable private fun ConversationListScreen( onConversationClicked: (ConversationDetail) -> Unit ) { LazyColumn( modifier = Modifier.fillMaxSize(), ) { items(10) { index -> val conversationId = index + 1 val conversationDetail = ConversationDetail(conversationId) val backgroundColor = conversationDetail.color ListItem( modifier = Modifier .fillMaxWidth() .clickable(onClick = dropUnlessResumed { onConversationClicked(conversationDetail) }), headlineContent = { Text( text = "Conversation $conversationId", style = MaterialTheme.typography.headlineSmall, color = MaterialTheme.colorScheme.onSurface ) }, colors = ListItemDefaults.colors( containerColor = backgroundColor // Set container color directly ) ) } } } @Composable private fun ConversationDetailScreen( conversationDetail: ConversationDetail, onProfileClicked: () -> Unit ) { Column( modifier = Modifier .fillMaxSize() .background(conversationDetail.color) .padding(16.dp), horizontalAlignment = Alignment.CenterHorizontally, verticalArrangement = Arrangement.Center ) { Text( text = "Conversation Detail Screen: ${conversationDetail.id}", style = MaterialTheme.typography.headlineMedium, color = MaterialTheme.colorScheme.onSurface ) Spacer(modifier = Modifier.height(16.dp)) Button(onClick = dropUnlessResumed(block = onProfileClicked)) { Text("View Profile") } } }
package com.example.nav3recipes.modular.hilt import androidx.compose.runtime.mutableStateListOf import androidx.compose.runtime.snapshots.SnapshotStateList import androidx.navigation3.runtime.EntryProviderScope import dagger.hilt.android.scopes.ActivityRetainedScoped typealias EntryProviderInstaller = EntryProviderScope<Any>.() -> Unit @ActivityRetainedScoped class Navigator(startDestination: Any) { val backStack : SnapshotStateList<Any> = mutableStateListOf(startDestination) fun goTo(destination: Any){ backStack.add(destination) } fun goBack(){ backStack.removeLastOrNull() } }
package com.example.nav3recipes.modular.hilt import dagger.Module import dagger.Provides import dagger.hilt.InstallIn import dagger.hilt.android.components.ActivityRetainedComponent import dagger.hilt.android.scopes.ActivityRetainedScoped @Module @InstallIn(ActivityRetainedComponent::class) object AppModule { @Provides @ActivityRetainedScoped fun provideNavigator() : Navigator = Navigator(startDestination = ConversationList) }