Jetpack navigation組件超詳細講解
導航是指支持用戶導航、進入和退出應用中不同內(nèi)容片段的交互。Android Jetpack 的導航組件可幫助您實現(xiàn)導航,無論是簡單的按鈕點擊,還是應用欄和抽屜式導航欄等更為復雜的模式,該組件均可應對。導航組件還通過遵循一套既定原則來確保一致且可預測的用戶體驗。
依賴項
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)建導航圖
導航發(fā)生在應用中的各個目的地之間。這些目的地是通過操作連接的,導航圖是一種資源文件,其中包含您的所有目的地和操作,該圖表會顯示應用的所有導航路徑。
點擊加號便可以創(chuàng)建目的地Fragment,連接操作由箭頭表示,該箭頭表示用戶可以如何從一個目的地導航到另一個目的地。
目的地是指應用中的不同內(nèi)容區(qū)域,操作是指目的地之間的邏輯連接,表示用戶可以采取的路徑。然后,我們來看下此時的導航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 元素是導航圖的根元素,當您向圖表添加目的地和連接操作時,就 action 和 app:destination
導航宿主
導航宿主是一個空容器,用戶在您的應用中導航時,目的地會在該容器中交換進出,導航宿主必須派生于 NavHost,Navigation 組件的默認 NavHost 實現(xiàn) (NavHostFragment) 負責處理 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 實現(xiàn)類的名稱
app:navGraph:將 NavHostFragment 與導航圖相關(guān)聯(lián)
app:defaultNavHost=“true”:確保 NavHostFragment 會攔截系統(tǒng)返回按鈕。
注意:只能有一個默認 NavHost,如果同一布局(例如,雙窗格布局)中有多個托管容器,請務必僅指定一個默認 NavHost
導航到目的地
跳轉(zhuǎn)建議使用 Safe Args 確保類型安全,在 Project 下的 build.gradle 添加。啟用 Safe Args 后,該插件會生成代碼,其中包含每個操作的類和方法。對于每個操作,Safe Args 還會為每個源頭生成一個類。生成的類的名稱由源類的名稱和“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'
}
點擊按鈕,進行跳轉(zhuǎn)
jump.setOnClickListener { val action = OneFragmentDirections.actionOneFragmentToTwoFragment() it.findNavController().navigate(action) }
傳遞參數(shù)
啟用 Safe Args 后,會創(chuàng)建一個類,該類的名稱是在目的地的名稱后面加上“Args”,例如 OneFragment,名稱為OneFragmentArgs,用于參數(shù)傳遞。
在 main_navigation.xml 加上參數(shù)標簽 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 中進行跳轉(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() 屬性委托來訪問參數(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)方法,可幫助您使用頂部應用欄、抽屜式導航欄和底部導航欄來管理導航。
這里簡單實現(xiàn)一個底部導航欄,先創(chuàng)建一個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="相機" /> <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)建三個Fragment,OneFragment,TwoFragment 和 ThreeFragment,作為三個頁面
然后 navigation 長這樣,需要注意的是menu各個item的id和fragment的id需要相對應
<?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)
多模塊導航
對于比較大型的項目,我們一般都會采用組件化開發(fā),每個功能模塊都專注于一項功能。每個功能模塊都是一個獨立的單元,擁有自己的導航圖和目的地,app 模塊依賴于每個功能模塊。
app 模塊負責提供應用的完整導航圖,以及將 NavHost 添加到界面中,可以使用 include 來引用庫圖。
<?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>
如下圖所示,這里主頁面一個MainFragment,用來做跳轉(zhuǎn),分別可跳轉(zhuǎn)到兩個不同的模塊
然后在 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()) }
那么,問題來了,如果是兩個單獨的功能模塊之間需要導航呢,而獨立的功能模塊彼此又看不到對方,怎么搞呢?
這時,可以使用深層鏈接直接導航到與隱式深層鏈接關(guān)聯(lián)的目的地
舉個例子,現(xiàn)在要從 Bikelibrary 里的 Fragment 跳轉(zhuǎn)到 Carlibrary 里的 Fragment
將 Carlibrary 中的導航添加深層鏈接
<?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>
當然,你也可以從xml編輯器的右側(cè)添加
然后在 bikelibrary 里的 fragment 中根據(jù)此鏈接進行導航,這里設置了一個按鈕的點擊事件
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) }
這樣,就完成了跨模塊導航,是不是很方便呢?不過,需要注意的是,Safe Args 不支持跨模塊導航,因為沒有針對目的地的直接操作。
到此這篇關(guān)于Jetpack navigation組件超詳細講解的文章就介紹到這了,更多相關(guān)Jetpack navigation內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
Android 6.0權(quán)限申請詳解及權(quán)限資料整理
這篇文章主要介紹了Android 6.0權(quán)限申請詳解及權(quán)限資料整理的相關(guān)資料,需要的朋友可以參考下2016-10-10Android實現(xiàn)垂直進度條VerticalSeekBar
這篇文章主要為大家詳細介紹了Android實現(xiàn)垂直進度條VerticalSeekBar的相關(guān)資料,具有一定的參考價值,感興趣的小伙伴們可以參考一下2018-07-07AndriodStudio利用ListView和數(shù)據(jù)庫實現(xiàn)簡單學生管理
這篇文章主要為大家詳細介紹了AndriodStudio利用ListView和數(shù)據(jù)庫實現(xiàn)簡單學生管理,文中示例代碼介紹的非常詳細,具有一定的參考價值,感興趣的小伙伴們可以參考一下2022-03-03Android實現(xiàn)圖片點擊預覽效果(zoom動畫)
本文主要介紹了Android實現(xiàn)圖片點擊預覽效果的方法步驟。具有很好的參考價值,下面跟著小編一起來看下吧2017-03-03Android EditText限制輸入字符的方法總結(jié)
這篇文章主要介紹了 Android EditText限制輸入字符的方法總結(jié)的相關(guān)資料,這里提供了五種方法來實現(xiàn)并進行比較,需要的朋友可以參考下2017-07-07基于Android studio3.6的JNI教程之helloworld思路詳解
這篇文章主要介紹了基于Android studio3.6的JNI教程之helloworld,本文通過圖文實例代碼給大家介紹的非常詳細,對大家的學習或工作具有一定的參考借鑒價值,需要的朋友可以參考下2020-03-03