Navigation 组件旨在用于具有一个主 Activity 和多个 Fragment 目的地的应用。
添加Navigation的依赖(在app的build.gradle)
def nav_version = "2.3.3"
implementation "androidx.navigation:navigation-fragment-ktx:$nav_version"
implementation "androidx.navigation:navigation-ui-ktx:$nav_version"
Navigation 组件具有一个名为 Safe Args 的 Gradle 插件，该插件可以生成简单的 object 和 builder 类，以便以类型安全的方式浏览和访问任何关联的参数。我们强烈建议您将 Safe Args 用于导航和数据传递，因为它可以确保类型安全。
1、建立导航配置
a、在“Project”窗口中，右键点击 res 目录，然后依次选择 New > Android Resource File。此时系统会显示 New Resource File 对话框。
b、在 File name 字段中输入名称，例如“nav_graph”。
c、从 Resource type 下拉列表中选择 Navigation，然后点击 OK。
2、向Activity添加NavHost
主 Activity 与导航图相关联，且包含一个负责根据需要交换目的地的 NavHostFragment。在具有多个 Activity 目的地的应用中，每个 Activity 均拥有其自己的导航图。
使用xml添加导航
1、android:name 属性包含 NavHost 实现的类名称。
2、app:navGraph 属性将 NavHostFragment 与导航图相关联。导航图会在此 NavHostFragment 中指定用户可以导航到的所有目的地。
3、app:defaultNavHost="true" 属性确保您的 NavHostFragment 会拦截系统返回按钮。请注意，只能有一个默认 NavHost。如果同一布局（例如，双窗格布局）中有多个宿主，请务必仅指定一个默认 NavHost。
3、添加页面（fragment）和页面跳转
在nav_graph配置
跳转也很简单，获取到当前的NavController，直接调用navigate，填写
val navController = findNavController()
navController.navigate(R.id.action_onefragment_to_twofragment)
4、使用safeArgs传参
在项目的build.gradle添加
def nav_version = "2.3.4"
classpath "androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version"
在app的build.gradle里面添加
apply plugin: "androidx.navigation.safeargs.kotlin"
使用该插件，比如我当前页面为OneFragment，跳转到TwoFragment
配置好xml后，点击Build->Make Project会自动生成当前页面的Directions类，我当前页面是OneFragment，则生成OneFragmentDirections。
会在OneFragmentDirections类，并且生成一个方法，方法名字对应OneFragment的action标签里面的id，比如我的action的id叫action_onefragment_to_twofragment，会生成一个方法actionOnefragmentToTwofragment
然后在需要跳转到目的地TwoFragment的标签里面添加
TwoFragment的
跳转时
val navController = findNavController()
val amount = 123;
val action = OneFragmentDirections.actionOnefragmentToTwofragment(amount);
navController.navigate(action)
actionOnefragmentToTwofragment这个方法在自动生成的代码里实际上是：
public class OneFragmentDirections private constructor() {
private data class ActionOnefragmentToTwofragment(
public val amount: Int = 0
) : NavDirections {
public override fun getActionId(): Int = R.id.action_onefragment_to_twofragment
public override fun getArguments(): Bundle {
val result = Bundle()
result.putInt("amount", this.amount)
return result
}
}
public companion object {
public fun actionOnefragmentToTwofragment(amount: Int = 0): NavDirections =
ActionOnefragmentToTwofragment(amount)
}
}
5、在目的地TwoFragment取参
在跳转后的TwoFragment中，直接使用by navArgs()即可取到参数，在
class TwoFragment : Fragment() {
val args: TwoFragmentArgs by navArgs()
override fun onCreateView(
inflater: LayoutInflater,
container: ViewGroup?,
savedInstanceState: Bundle?
): View? {
val view = inflater.inflate(R.layout.fragment_two, container, false)
return view;
}
override fun onViewCreated(view: View, savedInstanceState: Bundle?) {
super.onViewCreated(view, savedInstanceState)
textview.text = args.amount.toString() ;
}
}
6、ProGuard 注意事项
-keepnames class com.path.to.your.ParcelableArg
-keepnames class com.path.to.your.SerializableArg
-keepnames class com.path.to.your.EnumArg