在 Android 开发中,使用 Jetpack Navigation 组件可以方便地管理 Fragment 和 Activity 之间的导航。以下是如何使用 Jetpack Navigation 实现 Fragment 之间、Activity 之间以及 Activity 与 Fragment 之间跳转的实战示例。
1. 添加依赖
首先,在 build.gradle 文件中添加 Navigation 组件的依赖:
dependencies {
implementation "androidx.navigation:navigation-fragment-ktx:2.5.3"
implementation "androidx.navigation:navigation-ui-ktx:2.5.3"
}
2. 创建导航图
在 res/navigation 目录下创建一个导航图文件(例如 nav_graph.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"
app:startDestination="@id/fragmentA">
<!-- Fragment 之间的导航 -->
<fragment
android:id="@+id/fragmentA"
android:name="com.example.FragmentA"
tools:layout="@layout/fragment_a">
<action
android:id="@+id/action_fragmentA_to_fragmentB"
app:destination="@id/fragmentB" />
</fragment>
<fragment
android:id="@+id/fragmentB"
android:name="com.example.FragmentB"
tools:layout="@layout/fragment_b">
<action
android:id="@+id/action_fragmentB_to_fragmentA"
app:destination="@id/fragmentA" />
</fragment>
<!-- Activity 之间的导航 -->
<activity
android:id="@+id/activityB"
android:name="com.example.ActivityB"
tools:layout="@layout/activity_b" />
<!-- Activity 与 Fragment 之间的导航 -->
<fragment
android:id="@+id/fragmentC"
android:name="com.example.FragmentC"
tools:layout="@layout/fragment_c">
<action
android:id="@+id/action_fragmentC_to_activityB"
app:destination="@id/activityB" />
</fragment>
</navigation>
3. 在 Activity 中设置 NavController
在你的主 Activity 中,设置 NavController 并将其与 NavHostFragment 绑定:
class MainActivity : AppCompatActivity() {
private lateinit var navController: NavController
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_main)
val navHostFragment = supportFragmentManager.findFragmentById(R.id.nav_host_fragment) as NavHostFragment
navController = navHostFragment.navController
// 设置 NavigationUI 与 BottomNavigationView 或 NavigationView 的绑定(可选)
setupNavigationUI()
}
private fun setupNavigationUI() {
// 如果你有 BottomNavigationView 或 NavigationView,可以在这里绑定
val bottomNavigationView = findViewById<BottomNavigationView>(R.id.bottom_nav_view)
bottomNavigationView?.setupWithNavController(navController)
}
}
4. Fragment 之间的跳转
在 FragmentA 中,使用 NavController 跳转到 FragmentB:
class FragmentA : Fragment() {
override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View? {
val view = inflater.inflate(R.layout.fragment_a, container, false)
view.findViewById<Button>(R.id.button).setOnClickListener {
findNavController().navigate(R.id.action_fragmentA_to_fragmentB)
}
return view
}
}
5. Activity 之间的跳转
在 FragmentC 中,使用 NavController 跳转到 ActivityB:
class FragmentC : Fragment() {
override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View? {
val view = inflater.inflate(R.layout.fragment_c, container, false)
view.findViewById<Button>(R.id.button).setOnClickListener {
findNavController().navigate(R.id.action_fragmentC_to_activityB)
}
return view
}
}
在 ActivityB 中,你可以通过 Intent 启动其他 Activity 或返回上一个 Activity。
6. Activity 与 Fragment 之间的跳转
如果你想从 ActivityB 跳转回 FragmentC,可以在 ActivityB 中使用 NavController:
class ActivityB : AppCompatActivity() {
override fun onCreate(savedInstanceState: Bundle?) {
super.onCreate(savedInstanceState)
setContentView(R.layout.activity_b)
findViewById<Button>(R.id.button).setOnClickListener {
val navController = findNavController(R.id.nav_host_fragment)
navController.navigate(R.id.action_activityB_to_fragmentC)
}
}
}
7. 处理返回栈
在导航图中,你可以使用 popUpTo 和 popUpToInclusive 属性来控制返回栈的行为。例如:
<action
android:id="@+id/action_fragmentA_to_fragmentB"
app:destination="@id/fragmentB"
app:popUpTo="@id/fragmentA"
app:popUpToInclusive="true" />
这将在跳转到 FragmentB 时清除返回栈中的所有 FragmentA 实例。
8. 处理 Deep Links
你还可以使用 Navigation 组件处理 Deep Links。在导航图中为 Fragment 或 Activity 添加 deepLink:
<fragment
android:id="@+id/fragmentC"
android:name="com.example.FragmentC"
tools:layout="@layout/fragment_c">
<deepLink app:uri="example.com/fragmentC" />
</fragment>
然后在 AndroidManifest.xml 中为 Activity 添加 nav-graph:
<activity android:name=".MainActivity">
<nav-graph android:value="@navigation/nav_graph" />
</activity>
9.在导航图中定义参数:
在 Jetpack Navigation 中,传递参数非常简单。我们可以在导航图中定义参数,并在跳转时通过 Bundle 传递数据。以下是一个简单的实战示例,展示如何在 Fragment 之间传递参数。
在导航图中定义参数
在 nav_graph.xml 中,为目标 Fragment 定义参数。例如,为 FragmentB 定义一个 String 类型的参数 userName:
<fragment
android:id="@+id/fragmentB"
android:name="com.example.FragmentB"
tools:layout="@layout/fragment_b">
<!-- 定义参数 -->
<argument
android:name="userName"
app:argType="string" />
<action
android:id="@+id/action_fragmentA_to_fragmentB"
app:destination="@id/fragmentB" />
</fragment>
在 FragmentA 中传递参数
在 FragmentA 中,使用 NavController 跳转到 FragmentB 并传递参数:
class FragmentA : Fragment() {
override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View? {
val view = inflater.inflate(R.layout.fragment_a, container, false)
view.findViewById<Button>(R.id.button).setOnClickListener {
// 创建 Bundle 并传递参数
val bundle = Bundle()
bundle.putString("userName", "JohnDoe")
// 跳转到 FragmentB 并传递参数
findNavController().navigate(R.id.action_fragmentA_to_fragmentB, bundle)
}
return view
}
}
在 FragmentB 中接收参数
在 FragmentB 中,通过 arguments 获取传递过来的参数:
class FragmentB : Fragment() {
override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View? {
val view = inflater.inflate(R.layout.fragment_b, container, false)
// 获取传递的参数
val userName = arguments?.getString("userName")
if (userName != null) {
// 使用参数(例如显示在 TextView 中)
view.findViewById<TextView>(R.id.textView).text = "Hello, $userName!"
}
return view
}
}
使用 Safe Args 插件(推荐)
为了更安全地传递参数,可以使用 Navigation 的 Safe Args 插件。它会在编译时生成类型安全的代码,避免手动处理 Bundle。
添加 Safe Args 依赖
在 build.gradle 文件中添加 Safe Args 插件:
plugins {
id "androidx.navigation.safeargs.kotlin"
}
在导航图中定义参数(同上)
在 FragmentA 中使用 Safe Args 传递参数
view.findViewById<Button>(R.id.button).setOnClickListener {
// 使用 Safe Args 传递参数
val action = FragmentADirections.actionFragmentAToFragmentB("JohnDoe")
findNavController().navigate(action)
}
在 FragmentB 中使用 Safe Args 接收参数
class FragmentB : Fragment() {
override fun onCreateView(inflater: LayoutInflater, container: ViewGroup?, savedInstanceState: Bundle?): View? {
val view = inflater.inflate(R.layout.fragment_b, container, false)
// 使用 Safe Args 获取参数
val args by navArgs<FragmentBArgs>()
val userName = args.userName
// 使用参数
view.findViewById<TextView>(R.id.textView).text = "Hello, $userName!"
return view
}
}
总结
通过 Jetpack Navigation 组件,你可以轻松实现 Fragment 之间、Activity 之间以及 Activity 与 Fragment 之间的跳转。导航图提供了清晰的导航结构,并且可以方便地管理返回栈和 Deep Links。
通过以上步骤,你可以轻松地在 Fragment 之间传递参数:
普通方式:使用 Bundle 手动传递参数。
Safe Args:使用 Navigation 的 Safe Args 插件,实现类型安全的参数传递。
如果你需要传递复杂对象(如自定义类),可以结合 Parcelable 或 Serializable 来实现。希望这个补充内容对你有帮助!