Jetpack 是一套库、工具和指南,可帮助开发者更轻松地编写优质应用。这些组件可帮助您遵循最佳做法、让您摆脱编写样板代码的工作并简化复杂任务,以便您将精力集中放在所需的代码上。
开始根据Google官方提供的例子SunFloower来学习一下,打开demo的时候怀疑了,kotlin写的,我不会,有些尴尬,那索性一起学学了。
Navigation 导航
导航组件由以下三个关键部分组成:
- 导航图:在一个集中位置包含所有导航相关信息的 XML 资源。这包括应用内所有单个内容区域(称为"目标")以及用户可以通过应用获取的可能路径。
-
NavHost
:显示导航图中目标的空白容器。导航组件包含一个默认NavHost
实现 (NavHostFragment
),可显示 Fragment 目标。 -
NavController
:在NavHost
中管理应用导航的对象。当用户在整个应用中移动时,NavController
会安排NavHost
中目标内容的交换。
导航图,应该就是res下navigation目录下的这个nav_garden.xml文件了,效果长这样:
很直观的为我们展示了三个fragment之间的关联,源码无码,直接阅读,这里选取了中间这个fragment的相关
<fragment
android:id="@+id/plant_detail_fragment"
android:name="com.google.samples.apps.sunflower.PlantDetailFragment"
android:label="@string/plant_details_title"
tools:layout="@layout/fragment_plant_detail">
<action
android:id="@+id/action_plant_detail_fragment_to_gallery_fragment"
app:destination="@id/gallery_fragment"
app:enterAnim="@anim/slide_in_right"
app:exitAnim="@anim/slide_out_left"
app:popEnterAnim="@anim/slide_in_left"
app:popExitAnim="@anim/slide_out_right" />
<argument
android:name="plantId"
app:argType="string" />
</fragment>
id,name,label,layout都是见名知意的,指定内容,action 标签下destination指定了导航的目的,其余的Anim是用来配置转场动画。argument配置是navigation提供的参数传递方法,个人认为这个还是比较优秀的,以前传统的传递参数需要通过key-value形式,通过Intent或者是bundle,不管怎样我们在目标页面接收时候,都需要记住我们的key才可以取,很麻烦,这里就不用了,至于怎么用,继续往下看。
处理跳转,跳转通过 NavController 对象,它有三种获取方法:
NavHostFragment.findNavController(Fragment)
Navigation.findNavController(Activity, @IdRes int viewId)
Navigation.findNavController(View)
当然在这个demo中他封装的比较复杂,但是通过findNavController关键字搜索一下,也能大概看明白他是怎么做的,例如
private fun navigateToPlant(plantId: String, view: View) {
val direction = HomeViewPagerFragmentDirections.actionViewPagerFragmentToPlantDetailFragment(plantId)
view.findNavController().navigate(direction)
}
这是一个跳转没有传递参数的例子,再找一个,例如
@Before
fun jumpToPlantDetailFragment() {
activityTestRule.activity.apply {
runOnUiThread {
val bundle = Bundle().apply { putString("plantId", testPlant.plantId) }
findNavController(R.id.nav_host).navigate(R.id.plant_detail_fragment, bundle)
}
}
}
但这里还是使用了bundle去封装传递参数,navigation 提供了argument的方式,应该是这样用的
val action=PlantDetailFragmentDirections.actionPlantDetailFragmentToGalleryFragment()
action.setPlantId("xxxx")
Navigation.findNavController(getView()!!).navigate(action)
接收参数
GalleryFragmentArgs.fromBundle(argument)
这个demo里不这么写,因为他封装的太复杂,先写到这里,后面继续。