Nav3 Router: Jetpack Navigation 3 இன் மேல் நன்மைப்படுத்துதல்

Jetpack Navigation 3 என்றால் என்ன? Jetpack Navigation 3 is a new Google navigation library that is fundamentally different from previous versions. ஒரு regular mutable list where each element represents a screen in your application.உங்கள் பயன்பாட்டில் ஒவ்வொரு அம்சமும் ஒரு screen ஆகும். NavBackStack இந்த மாதிரி think different type விளம்பரங்கள் தான் add industriesla இப்போ Hot... எப்போதும் Kotlin class. NavKey இதன் மூலம் நீங்கள் சுற்றுப்பயணத்தை முழுமையாக கட்டுப்படுத்தலாம், ஆனால் பொதுவான செயல்பாடுகளுக்கு நிறைய boilerplate குறியீடு எழுத வேண்டும். ஏன் NavBackStack இன் மூலம் நேரடியாக வேலை செய்வது கடினமானது எப்படி வேலை செய்கிறது என்பதை பார்ப்போம் : NavBackStack @Composable fun MyApp() { val backStack = rememberNavBackStack(Screen.Home) // Add a screen backStack.add(Screen.Details("123")) // Go back backStack.removeLastOrNull() // Replace current screen backStack.set(backStack.lastIndex, Screen.Success) } நீங்கள் ஒரு ViewModel இருந்து விலையை திறக்க வேண்டும் போது பிரச்சினைகள் தொடங்கும். ViewModel (நான் நினைக்கிறேன், ViewModel Compose-specific விஷயங்களை பற்றி அறிந்து கொள்ள கூடாது என்பதால், என் புரிதலில், ஆவண விதிகளை அழிக்கிறது) அல்லது ஒவ்வொரு நுழைவு நடவடிக்கைக்கு இடையூறு அழைப்புகளை உருவாக்குகிறது. NavBackStack கூடுதலாக, நேரடியாக பணிபுரியும் போது, எரிபொருள் பிரச்சினைகளை செயல்படுத்த நினைப்பது எளிதானது. எப்படி Nav3 ரோட்டர் வேலை எளிதானது Nav3 Router Navigation 3 இல் ஒரு அறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகுறிகு Important point: Nav3 router does not create its own stack. அது அதே சேவையுடன் வேலை செய்கிறது அதேபோல், Navigation 3 இல் வேலை செய்வது மிகவும் எளிதானது. , the library translates this into the corresponding operation with the original stack என்று கூறுகிறது. NavBackStack router.push(Screen.Details) முக்கியமான வெற்றிகள் : ViewModel மூலம் பயன்படுத்த முடியும் Navigation commands are buffered if UI is temporarily unavailable (for example, during screen rotation) All stack operations happen atomically - அனைத்து stack செயல்பாடுகள் atomically நடக்கிறது தெளிவான நெருப்பு Flexibility in modification and adding custom behavior - மாற்றங்கள் மற்றும் தனிப்பட்ட செயல்பாடுகளை சேர்க்க நிறுவல் Nav3 Router is available on Maven Central. உங்களுடைய கணினியில் அறுவை சிகிச்சை சேர்க்கவும் : build.gradle.kts // For shared module in KMP project kotlin { sourceSets { commonMain.dependencies { implementation("io.github.arttttt.nav3router:nav3router:1.0.0") } } } // For Android-only project dependencies { implementation("io.github.arttttt.nav3router:nav3router:1.0.0") } GitHub இல் உள்ள குறியீடுகள்: github.com/arttttt/Nav3Router இல் Nav3 Router எப்படி உருவாக்கப்படுகிறது Library மூன்று பிரிவுகளாகும், ஒவ்வொன்றும் தங்கள் வேலைகளை தீர்க்கும்: ரோட்டர் - Developer Interface Router போன்ற வழிகளை வழங்குகிறது , , நீங்கள் இந்த வழிமுறைகளை அழைக்கும் போது, ரோட்டர் ஒப்பிடும் கட்டளைகளை உருவாக்குகிறது மற்றும் அவற்றை சலுகை கீழே அனுப்பும். ரோட்டர் தனியாக எவ்வாறு விலையை செயல்படுத்தப்படும் பற்றி எதுவும் தெரியவில்லை - இது எங்கும் அதை பயன்படுத்த அனுமதிக்கிறது. push() pop() replace() CommandQueue - Commands மற்றும் Execution இடையே Buffer ஒரு முதியவன் பாதாளங்களைத் தாண்டும் தன் மந்திரக்கோலால் சாய்த்தபடியிருக்கிறான் நாட்சத்திரங்களை. .............................................................................................................................................................................. இது எத்தனையாவது [...] // Simplified queue logic class CommandQueue { private var navigator: Navigator ? = null private val pending = mutableListOf >() fun executeCommand(command: Command ) { if (navigator != null) { navigator.apply(command) // Navigator exists - execute immediately } else { pending.add(command) // No - save for later } } } Navigator - The One Who Works with the Stack - விமானப் பயணிகள் Navigator இல் இடுகையிடுவது மற்றும் இடுகையிடுவது ஒரு முதியவன் பாதாளங்களைத் தாண்டும் தன் மந்திரக்கோலால் சாய்த்தபடியிருக்கிறான் நாட்சத்திரங்களை. .............................................................................................................................................................................. இது எத்தனையாவது [...] NavBackStack // Simplified Navigator logic fun applyCommands(commands: Array ) { val stackCopy = backStack.toMutableList() // Work with a copy for (command in commands) { when (command) { is Push -> stackCopy.add(command.screen) is Pop -> stackCopy.removeLastOrNull() // ... other commands } } backStack.swap(stackCopy) // Atomically apply changes } Nav3 Router பயன்பாடு மிக எளிதான வழி - ரோட்டர் கையால் கூட உருவாக்க வேண்டாம். Nav3Host அதை உங்களுக்கு செய்வார்: @Composable fun App() { val backStack = rememberNavBackStack(Screen.Home) // Nav3Host will create Router automatically Nav3Host(backStack = backStack) { backStack, onBack, router -> NavDisplay( backStack = backStack, onBack = onBack, entryProvider = entryProvider { entry { HomeScreen( onOpenDetails = { router.push(Screen.Details) // Use router } ) } entry { DetailsScreen( onBack = { router.pop() } ) } } ) } } மேலும் கடினமான பயன்பாடுகள், DI மூலம் ஒரு ரோட்டர் உருவாக்க மற்றும் அதை ViewModel அனுப்புவது பொருத்தமானது: கண்காணிப்பு குறிப்புகள் @Serializable sealed interface Screen : NavKey { @Serializable data object Home : Screen @Serializable data class Product(val id: String) : Screen @Serializable data object Cart : Screen } Nav3Host க்கு router ஐ அனுப்பவும். @Composable fun App() { val backStack = rememberNavBackStack(Screen.Home) val router: Router = getSomehowUsingDI() // Pass Router to Nav3Host Nav3Host( backStack = backStack, router = router, ) { backStack, onBack, _ -> NavDisplay( backStack = backStack, onBack = onBack, entryProvider = entryProvider { entry { HomeScreen() } entry { DetailsScreen() } } ) } } ViewModel Constructor மூலம் Router பெறுகிறது. class ProductViewModel( private val router: Router , private val cartRepository: CartRepository ) : ViewModel() { fun addToCart(productId: String) { viewModelScope.launch { cartRepository.add(productId) router.push(Screen.Cart) // Navigation from ViewModel } } } ViewModel பயன்படுத்தி பார்க்கலாம். @Composable fun ProductScreen(viewModel: ProductViewModel = koinViewModel()) { Button(onClick = { viewModel.addToCart(productId) }) { Text("Add to Cart") } } typical scenarios குறிச்சொற்கள் எளிமையான Back-to-Follow Navigation // Navigate to a new screen router.push(Screen.Details(productId)) // Go back router.pop() // Navigate with replacement of current screen (can't go back) router.replaceCurrent(Screen.Success) Screen Chains மூலம் வேலை // Open multiple screens at once router.push( Screen.Category("electronics"), Screen.Product("laptop-123"), Screen.Reviews("laptop-123") ) // Return to a specific screen // Will remove all screens above Product from the stack router.popTo(Screen.Product("laptop-123")) Checkout ஆவணங்கள் @Composable fun CheckoutScreen(router: Router ) { Button( onClick = { // After checkout we need to: // 1. Show confirmation screen // 2. Prevent going back to cart router.replaceStack( Screen.Home, Screen.OrderSuccess(orderId) ) // Now only Home and OrderSuccess are in the stack } ) { Text("Place Order") } } வெளியீடு NESTED NAVIGATION // User is deep in settings: // Home -> Settings -> Account -> Privacy -> DataManagement // "Done" button should return to home Button( onClick = { // Will leave only root (Home) router.clearStack() } ) { Text("Done") } // Or if you need to close the app from anywhere Button( onClick = { // Will leave only current screen and trigger system back router.dropStack() } ) { Text("Exit") } Bonus: SceneStrategy மற்றும் Dialogs ஒரு முதியவன் பாதாளங்களைத் தாண்டும் தன் மந்திரக்கோலால் சாய்த்தபடியிருக்கிறான் நாட்சத்திரங்களை. .............................................................................................................................................................................. இது எத்தனையாவது [...] SceneStrategy என்றால் என்ன? இந்த மாதிரி think different type விளம்பரங்கள் தான் add industriesla இப்போ Hot... இந்த மாதிரி think different type விளம்பரங்கள் தான் add industriesla இப்போ Hot... SinglePaneSceneStrategy ஒரு முதியவன் பாதாளங்களைத் தாண்டும் தன் மந்திரக்கோலால் சாய்த்தபடியிருக்கிறான் நாட்சத்திரங்களை. .............................................................................................................................................................................. இது எத்தனையாவது [...] ModalBottomSheet க்கு ஒரு திட்டத்தை உருவாக்குதல் இந்த மாதிரி think different type விளம்பரங்கள் தான் add industriesla இப்போ Hot... @Serializable sealed interface Screen : NavKey { @Serializable data object Home : Screen @Serializable data class Product(val id: String) : Screen // This screen will be shown as bottom sheet @Serializable data object Filters : Screen } இப்போது, நாங்கள் தனியே திட்டத்தை உருவாக்குவோம்.இது இறுதி மின்னஞ்சல் மின்னஞ்சல் மின்னஞ்சல் கண்காணிப்பு மற்றும், அது ஒரு சிறப்பு மார்க் கண்டுபிடித்தால், அது ஒரு கீழே படியாக காட்டுகிறது: class BottomSheetSceneStrategy : SceneStrategy { companion object { // Metadata key by which we identify bottom sheet private const val BOTTOM_SHEET_KEY = "bottomsheet" // Helper function to create metadata fun bottomSheet(): Map { return mapOf(BOTTOM_SHEET_KEY to true) } } @Composable override fun calculateScene( entries: List >, onBack: (Int) -> Unit ): Scene ? { val lastEntry = entries.lastOrNull() ?: return null // Check if the last screen has bottom sheet marker val isBottomSheet = lastEntry.metadata[BOTTOM_SHEET_KEY] as? Boolean if (isBottomSheet == true) { // Return special Scene for bottom sheet return BottomSheetScene( entry = lastEntry, previousEntries = entries.dropLast(1), onBack = onBack ) } // This is not a bottom sheet, let another strategy handle it return null } } Multiple Strategies பல்வேறு திட்டங்கள் ஒரு உண்மையான பயன்பாட்டில், நீங்கள் கீழே அட்டவணைகள், பேச்சுவார்த்தைகள், மற்றும் சரியான அட்டவணைகள் தேவைப்படும்.For this, you can create a delegate strategy that will choose the right strategy for each screen: class DelegatedScreenStrategy ( private val strategyMap: Map >, private val fallbackStrategy: SceneStrategy ) : SceneStrategy { @Composable override fun calculateScene( entries: List >, onBack: (Int) -> Unit ): Scene ? { val lastEntry = entries.lastOrNull() ?: return null // Check all keys in metadata for (key in lastEntry.metadata.keys) { val strategy = strategyMap[key] if (strategy != null) { // Found suitable strategy return strategy.calculateScene(entries, onBack) } } // Use default strategy return fallbackStrategy.calculateScene(entries, onBack) } } Application பயன்பாடு இப்போது, அனைத்தையும் ஒப்பிடுவோம்.இது ஒரு உண்மையான பயன்பாட்டில் கீழ்க்கண்ட அட்டவணை பயன்படுத்தி எப்படி தெரிகிறது: @Composable fun ShoppingApp() { val backStack = rememberNavBackStack(Screen.Home) val router = rememberRouter () Nav3Host( backStack = backStack, router = router ) { backStack, onBack, router -> NavDisplay( backStack = backStack, onBack = onBack, // Use our combined strategy sceneStrategy = DelegatedScreenStrategy( strategyMap = mapOf( "bottomsheet" to BottomSheetSceneStrategy(), "dialog" to DialogSceneStrategy() // Navigation 3 already has this strategy ), fallbackStrategy = SinglePaneSceneStrategy() // Regular screens ), entryProvider = entryProvider { entry { HomeScreen( onOpenFilters = { // Open filters as bottom sheet router.push(Screen.Filters) } ) } entry { screen -> ProductScreen(productId = screen.id) } // Specify that Filters should be bottom sheet entry ( metadata = BottomSheetSceneStrategy.bottomSheet() ) { FiltersContent( onApply = { filters -> // Apply filters and close bottom sheet applyFilters(filters) router.pop() } ) } } ) } } இங்கு என்ன நடக்கிறது?நீங்கள் அழைத்தால் ஆங்கிலத்தில் இதை Single Orgasm, Multiple Orgasm என்றும் கூறுகிறார்கள். router.push(Screen.Filters) அழைத்தால் ஒரு முதியவன் பாதாளங்களைத் தாண்டும் தன் மந்திரக்கோலால் சாய்த்தபடியிருக்கிறான் நாட்சத்திரங்களை. .............................................................................................................................................................................. இது எத்தனையாவது [...] router.pop() Benefits of this Approach இந்த வழிமுறைகள் ஒரு முதியவன் பாதாளங்களைத் தாண்டும் தன் மந்திரக்கோலால் சாய்த்தபடியிருக்கிறான் நாட்சத்திரங்களை. .............................................................................................................................................................................. இது எத்தனையாவது [...] மற்றும் ஒரு முதியவன் பாதாளங்களைத் தாண்டும் தன் மந்திரக்கோலால் சாய்த்தபடியிருக்கிறான் நாட்சத்திரங்களை. .............................................................................................................................................................................. இது எத்தனையாவது [...] push pop ஒரு முதியவன் பாதாளங்களைத் தாண்டும் தன் மந்திரக்கோலால் சாய்த்தபடியிருக்கிறான் நாட்சத்திரங்களை. .............................................................................................................................................................................. இது எத்தனையாவது [...] ஏன் Nav3 ரோட்டர் பயன்படுத்த வேண்டும் Nav3 Router Navigation 3 மாற்ற முயற்சிக்கவில்லை அல்லது புதிய அம்சங்களை சேர்க்க. அதன் வேலை எளிதாக மற்றும் எதிர்பாராத வேலை செய்ய உள்ளது. நீங்கள் பயன்பாட்டை எந்த அளவு இருந்து பயன்படுத்த முடியும் ஒரு எளிய API கிடைக்கிறது, நேரடி பிரச்சினைகளை 자동 செயல்படுத்த, மற்றும் எளிதாக உலாவி விஞ்ஞானத்தை சோதிக்க முடியும். அதே நேரத்தில், ஹோட்டல் கீழ், வழக்கமான நுழைவு 3 இன்னும் அதன் அனைத்து திறன்களை வேலை செய்கிறது: நிலை சேமிப்பு, அனிமேஷன் ஆதரவு, மற்றும் அமைப்பு "புறம்" பிளாக் சரியான செயல்பாடு. நீங்கள் இப்போது Navigation 3 பயன்படுத்துகிறீர்களா அல்லது அதை மாற்ற திட்டமிடுகிறீர்களா, Nav3 Router இந்த அனுபவத்தை மிகவும் மகிழ்ச்சியாக செய்ய உதவுகிறது. வலது GitHub Repository: github.com/arttttt/Nav3Router இல் குறிச்சொற்கள்: sample folder in the repository