Jetpack navigation組件超詳細(xì)講解
導(dǎo)航是指支持用戶導(dǎo)航、進(jìn)入和退出應(yīng)用中不同內(nèi)容片段的交互。Android Jetpack 的導(dǎo)航組件可幫助您實(shí)現(xiàn)導(dǎo)航,無(wú)論是簡(jiǎn)單的按鈕點(diǎn)擊,還是應(yīng)用欄和抽屜式導(dǎo)航欄等更為復(fù)雜的模式,該組件均可應(yīng)對(duì)。導(dǎo)航組件還通過(guò)遵循一套既定原則來(lái)確保一致且可預(yù)測(cè)的用戶體驗(yàn)。
依賴項(xiàng)
def nav_version = "2.5.2"
implementation "androidx.navigation:navigation-fragment-ktx:$nav_version"
implementation "androidx.navigation:navigation-ui-ktx:$nav_version"
implementation "androidx.navigation:navigation-dynamic-features-fragment:$nav_version"
創(chuàng)建導(dǎo)航圖
導(dǎo)航發(fā)生在應(yīng)用中的各個(gè)目的地之間。這些目的地是通過(guò)操作連接的,導(dǎo)航圖是一種資源文件,其中包含您的所有目的地和操作,該圖表會(huì)顯示應(yīng)用的所有導(dǎo)航路徑。
點(diǎn)擊加號(hào)便可以創(chuàng)建目的地Fragment,連接操作由箭頭表示,該箭頭表示用戶可以如何從一個(gè)目的地導(dǎo)航到另一個(gè)目的地。


目的地是指應(yīng)用中的不同內(nèi)容區(qū)域,操作是指目的地之間的邏輯連接,表示用戶可以采取的路徑。然后,我們來(lái)看下此時(shí)的導(dǎo)航xml代碼::main_navigation.xml
<?xml version="1.0" encoding="utf-8"?>
<navigation xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/main_navigation"
app:startDestination="@id/oneFragment">
<fragment
android:id="@+id/oneFragment"
android:name="com.example.myapplication.OneFragment"
android:label="fragment_one"
tools:layout="@layout/fragment_one" >
<action
android:id="@+id/action_oneFragment_to_twoFragment"
app:destination="@id/twoFragment" />
</fragment>
<fragment
android:id="@+id/twoFragment"
android:name="com.example.myapplication.TwoFragment"
android:label="fragment_two"
tools:layout="@layout/fragment_two" >
<action
android:id="@+id/action_twoFragment_to_threeFragment"
app:destination="@id/threeFragment" />
</fragment>
<fragment
android:id="@+id/threeFragment"
android:name="com.example.myapplication.ThreeFragment"
android:label="fragment_three"
tools:layout="@layout/fragment_three" />
</navigation>
其中,navigation 元素是導(dǎo)航圖的根元素,當(dāng)您向圖表添加目的地和連接操作時(shí),就 action 和 app:destination
導(dǎo)航宿主
導(dǎo)航宿主是一個(gè)空容器,用戶在您的應(yīng)用中導(dǎo)航時(shí),目的地會(huì)在該容器中交換進(jìn)出,導(dǎo)航宿主必須派生于 NavHost,Navigation 組件的默認(rèn) NavHost 實(shí)現(xiàn) (NavHostFragment) 負(fù)責(zé)處理 Fragment 目的地的交換。
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
tools:context=".MainActivity">
<androidx.fragment.app.FragmentContainerView
android:id="@+id/container"
android:name="androidx.navigation.fragment.NavHostFragment"
android:layout_width="match_parent"
android:layout_height="match_parent"
app:defaultNavHost="true"
app:navGraph="@navigation/main_navigation" />
</LinearLayout>
android:name:NavHost 實(shí)現(xiàn)類的名稱
app:navGraph:將 NavHostFragment 與導(dǎo)航圖相關(guān)聯(lián)
app:defaultNavHost=“true”:確保 NavHostFragment 會(huì)攔截系統(tǒng)返回按鈕。
注意:只能有一個(gè)默認(rèn) NavHost,如果同一布局(例如,雙窗格布局)中有多個(gè)托管容器,請(qǐng)務(wù)必僅指定一個(gè)默認(rèn) NavHost
導(dǎo)航到目的地
跳轉(zhuǎn)建議使用 Safe Args 確保類型安全,在 Project 下的 build.gradle 添加。啟用 Safe Args 后,該插件會(huì)生成代碼,其中包含每個(gè)操作的類和方法。對(duì)于每個(gè)操作,Safe Args 還會(huì)為每個(gè)源頭生成一個(gè)類。生成的類的名稱由源類的名稱和“Directions”一詞組成,例如OneFragment,生成的就是OneFragmentDirections
buildscript {
repositories {
google()
}
dependencies {
def nav_version = "2.5.2"
classpath "androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version"
}
}
在APP模塊的 build.gradle 添加
plugins {
id 'androidx.navigation.safeargs'
}
點(diǎn)擊按鈕,進(jìn)行跳轉(zhuǎn)
jump.setOnClickListener {
val action = OneFragmentDirections.actionOneFragmentToTwoFragment()
it.findNavController().navigate(action)
}
傳遞參數(shù)
啟用 Safe Args 后,會(huì)創(chuàng)建一個(gè)類,該類的名稱是在目的地的名稱后面加上“Args”,例如 OneFragment,名稱為OneFragmentArgs,用于參數(shù)傳遞。
在 main_navigation.xml 加上參數(shù)標(biāo)簽 argument
<fragment
android:id="@+id/oneFragment"
android:name="com.example.myapplication.OneFragment"
android:label="fragment_one"
tools:layout="@layout/fragment_one">
<argument
android:name="name"
android:defaultValue="1"
app:argType="string" />
<action
android:id="@+id/action_oneFragment_to_twoFragment"
app:destination="@id/twoFragment" />
</fragment>
在 OneFragment 中進(jìn)行跳轉(zhuǎn),參數(shù)傳遞
jump.setOnClickListener {
val param = OneFragmentArgs.Builder().setName(nameStr).build().toBundle()
it.findNavController().navigate(R.id.action_oneFragment_to_twoFragment, param)
}
TwoFragment接收參數(shù),建議使用 ktx,就可以使用 by navArgs() 屬性委托來(lái)訪問(wèn)參數(shù)
class TwoFragment : Fragment() {
private val args: OneFragmentArgs by navArgs()
override fun onCreateView(
inflater: LayoutInflater, container: ViewGroup?,
savedInstanceState: Bundle?
): View? {
val nameStr = args.name //接收的值
return inflater.inflate(R.layout.fragment_two, container, false)
}
}
NavigationUI
此類包含多種靜態(tài)方法,可幫助您使用頂部應(yīng)用欄、抽屜式導(dǎo)航欄和底部導(dǎo)航欄來(lái)管理導(dǎo)航。
這里簡(jiǎn)單實(shí)現(xiàn)一個(gè)底部導(dǎo)航欄,先創(chuàng)建一個(gè)menu
<?xml version="1.0" encoding="utf-8"?>
<menu xmlns:android="http://schemas.android.com/apk/res/android">
<item
android:id="@+id/oneFragment"
android:icon="@android:drawable/ic_menu_camera"
android:title="相機(jī)" />
<item
android:id="@+id/twoFragment"
android:icon="@android:drawable/ic_dialog_email"
android:title="郵件" />
<item
android:id="@+id/threeFragment"
android:icon="@android:drawable/ic_menu_call"
android:title="電話" />
</menu>創(chuàng)建三個(gè)Fragment,OneFragment,TwoFragment 和 ThreeFragment,作為三個(gè)頁(yè)面
然后 navigation 長(zhǎng)這樣,需要注意的是menu各個(gè)item的id和fragment的id需要相對(duì)應(yīng)
<?xml version="1.0" encoding="utf-8"?>
<navigation xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/main_navigation"
app:startDestination="@id/oneFragment">
<fragment
android:id="@+id/oneFragment"
android:name="com.example.myapplication.OneFragment"
android:label="fragment_one"
tools:layout="@layout/fragment_one" />
<fragment
android:id="@+id/twoFragment"
android:name="com.example.myapplication.TwoFragment"
android:label="fragment_two"
tools:layout="@layout/fragment_two" />
<fragment
android:id="@+id/threeFragment"
android:name="com.example.myapplication.ThreeFragment"
android:label="fragment_three"
tools:layout="@layout/fragment_three" />
</navigation>
宿主的布局如下
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical"
tools:context=".MainActivity">
<androidx.fragment.app.FragmentContainerView
android:id="@+id/container"
android:name="androidx.navigation.fragment.NavHostFragment"
android:layout_width="match_parent"
android:layout_height="0dp"
android:layout_weight="1"
app:defaultNavHost="true"
app:navGraph="@navigation/main_navigation" />
<com.google.android.material.bottomnavigation.BottomNavigationView
android:id="@+id/bottom"
android:layout_width="match_parent"
android:layout_height="wrap_content"
app:menu="@menu/main_item" />
</LinearLayout>
然后在宿主Activity中執(zhí)行如下就行啦
val navHostFragment =
supportFragmentManager.findFragmentById(R.id.container) as NavHostFragment
val bottomNavigationView = findViewById<BottomNavigationView>(R.id.bottom)
NavigationUI.setupWithNavController(bottomNavigationView, navHostFragment.navController)

多模塊導(dǎo)航
對(duì)于比較大型的項(xiàng)目,我們一般都會(huì)采用組件化開發(fā),每個(gè)功能模塊都專注于一項(xiàng)功能。每個(gè)功能模塊都是一個(gè)獨(dú)立的單元,擁有自己的導(dǎo)航圖和目的地,app 模塊依賴于每個(gè)功能模塊。
app 模塊負(fù)責(zé)提供應(yīng)用的完整導(dǎo)航圖,以及將 NavHost 添加到界面中,可以使用 include 來(lái)引用庫(kù)圖。
<?xml version="1.0" encoding="utf-8"?>
<navigation xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/main_navigation"
app:startDestination="@id/mainFragment">
<include app:graph="@navigation/bike_nav" />
<include app:graph="@navigation/car_nav" />
<fragment
android:id="@+id/mainFragment"
android:name="com.example.myapplication.MainFragment"
android:label="fragment_main"
tools:layout="@layout/fragment_main">
<action
android:id="@+id/action_mainFragment_to_car_nav"
app:destination="@id/car_nav" />
<action
android:id="@+id/action_mainFragment_to_bike_nav"
app:destination="@id/bike_nav" />
</fragment>
</navigation>
如下圖所示,這里主頁(yè)面一個(gè)MainFragment,用來(lái)做跳轉(zhuǎn),分別可跳轉(zhuǎn)到兩個(gè)不同的模塊

然后在 MainFragment 里執(zhí)行跳轉(zhuǎn)邏輯
findViewById<TextView>(R.id.red).setOnClickListener {
it.findNavController().navigate(MainFragmentDirections.actionMainFragmentToCarNav())
}
findViewById<TextView>(R.id.purple).setOnClickListener {
it.findNavController()
.navigate(MainFragmentDirections.actionMainFragmentToBikeNav())
}
那么,問(wèn)題來(lái)了,如果是兩個(gè)單獨(dú)的功能模塊之間需要導(dǎo)航呢,而獨(dú)立的功能模塊彼此又看不到對(duì)方,怎么搞呢?
這時(shí),可以使用深層鏈接直接導(dǎo)航到與隱式深層鏈接關(guān)聯(lián)的目的地
舉個(gè)例子,現(xiàn)在要從 Bikelibrary 里的 Fragment 跳轉(zhuǎn)到 Carlibrary 里的 Fragment

將 Carlibrary 中的導(dǎo)航添加深層鏈接
<?xml version="1.0" encoding="utf-8"?>
<navigation xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
xmlns:tools="http://schemas.android.com/tools"
android:id="@+id/car_nav"
app:startDestination="@id/carFragment">
<fragment
android:id="@+id/carFragment"
android:name="com.example.carlibrary.CarFragment"
android:label="fragment_car"
tools:layout="@layout/fragment_car">
<deepLink
android:id="@+id/deepLink"
app:uri="android-app://com.example.carlibrary/carFragment" />
</fragment>
</navigation>當(dāng)然,你也可以從xml編輯器的右側(cè)添加

然后在 bikelibrary 里的 fragment 中根據(jù)此鏈接進(jìn)行導(dǎo)航,這里設(shè)置了一個(gè)按鈕的點(diǎn)擊事件
findViewById<Button>(R.id.bike_to_car).setOnClickListener {
val request =
NavDeepLinkRequest.Builder.fromUri("android-app://com.example.carlibrary/carFragment".toUri())
.build()
it.findNavController().navigate(request)
}這樣,就完成了跨模塊導(dǎo)航,是不是很方便呢?不過(guò),需要注意的是,Safe Args 不支持跨模塊導(dǎo)航,因?yàn)闆](méi)有針對(duì)目的地的直接操作。
到此這篇關(guān)于Jetpack navigation組件超詳細(xì)講解的文章就介紹到這了,更多相關(guān)Jetpack navigation內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
Android 6.0權(quán)限申請(qǐng)?jiān)斀饧皺?quán)限資料整理
這篇文章主要介紹了Android 6.0權(quán)限申請(qǐng)?jiān)斀饧皺?quán)限資料整理的相關(guān)資料,需要的朋友可以參考下2016-10-10
Android實(shí)現(xiàn)垂直進(jìn)度條VerticalSeekBar
這篇文章主要為大家詳細(xì)介紹了Android實(shí)現(xiàn)垂直進(jìn)度條VerticalSeekBar的相關(guān)資料,具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2018-07-07
AndriodStudio利用ListView和數(shù)據(jù)庫(kù)實(shí)現(xiàn)簡(jiǎn)單學(xué)生管理
這篇文章主要為大家詳細(xì)介紹了AndriodStudio利用ListView和數(shù)據(jù)庫(kù)實(shí)現(xiàn)簡(jiǎn)單學(xué)生管理,文中示例代碼介紹的非常詳細(xì),具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2022-03-03
Android實(shí)現(xiàn)圖片點(diǎn)擊預(yù)覽效果(zoom動(dòng)畫)
本文主要介紹了Android實(shí)現(xiàn)圖片點(diǎn)擊預(yù)覽效果的方法步驟。具有很好的參考價(jià)值,下面跟著小編一起來(lái)看下吧2017-03-03
Android EditText限制輸入字符的方法總結(jié)
這篇文章主要介紹了 Android EditText限制輸入字符的方法總結(jié)的相關(guān)資料,這里提供了五種方法來(lái)實(shí)現(xiàn)并進(jìn)行比較,需要的朋友可以參考下2017-07-07
android加載系統(tǒng)相冊(cè)圖片并顯示詳解
大家好,本篇文章主要講的是android加載系統(tǒng)相冊(cè)圖片并顯示詳解,感興趣的同學(xué)趕快來(lái)看一看吧,對(duì)你有幫助的話記得收藏一下,方便下次瀏覽2021-12-12
基于Android studio3.6的JNI教程之helloworld思路詳解
這篇文章主要介紹了基于Android studio3.6的JNI教程之helloworld,本文通過(guò)圖文實(shí)例代碼給大家介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2020-03-03
Android實(shí)現(xiàn)app開機(jī)自啟動(dòng)功能
這篇文章主要為大家詳細(xì)介紹了Android實(shí)現(xiàn)app開機(jī)自啟動(dòng)功能,文中示例代碼介紹的非常詳細(xì),具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2022-05-05

