Safe Args

在目的地之间导航的推荐方法是使用 Safe Args Gradle 插件。此插件生成对象和构建器类，这些类支持目的地之间类型安全的导航。使用 Safe Args 进行导航和在目的地之间传递数据。

启用 Safe Args

要将Safe Args添加到您的项目中，请在您的顶级build.gradle文件中包含以下classpath

buildscript {
    repositories {
        google()
    }
    dependencies {
        def nav_version = "2.8.4"
        classpath "androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version"
    }
}

buildscript {
    repositories {
        google()
    }
    dependencies {
        val nav_version = "2.8.4"
        classpath("androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version")
    }
}

您还必须应用两个可用插件之一。

要生成适合 Java 或混合 Java 和 Kotlin 模块的 Java 语言代码，请将此行添加到您的应用或模块的build.gradle文件中

plugins {
  id 'androidx.navigation.safeargs'
}

plugins {
    id("androidx.navigation.safeargs")
}

或者，要生成适合仅 Kotlin 模块的 Kotlin 代码，请添加

plugins {
  id 'androidx.navigation.safeargs.kotlin'
}

plugins {
    id("androidx.navigation.safeargs.kotlin")
}

您必须在gradle.properties文件中包含android.useAndroidX=true，如迁移到 AndroidX中所述。

生成的代码

启用 Safe Args 后，生成的代码包含您定义的每个操作的类和方法，以及与每个发送和接收目的地对应的类。

Safe Args 为每个操作源自的目的地生成一个类。生成的类名在源自的目的地类名中添加“Directions”。例如，如果源自的目的地名为SpecifyAmountFragment，则生成的类名为SpecifyAmountFragmentDirections。

生成的类包含源自的目的地中定义的每个操作的静态方法。此方法将任何定义的操作参数作为参数，并返回一个NavDirections对象，您可以将其直接传递给navigate()。

Safe Args 示例

例如，考虑一个导航图，其中包含一个连接两个目的地SpecifyAmountFragment和ConfirmationFragment的操作。该ConfirmationFragment采用一个float参数，您将其作为操作的一部分提供。

Safe Args 生成一个SpecifyAmountFragmentDirections类，其中包含一个方法actionSpecifyAmountFragmentToConfirmationFragment()，以及一个名为ActionSpecifyAmountFragmentToConfirmationFragment的内部类。内部类派生自NavDirections，并存储关联的操作 ID 和float参数。然后，返回的NavDirections对象可以直接传递给navigate()，如下例所示

override fun onClick(v: View) {
    val amount: Float = ...
    val action =
        SpecifyAmountFragmentDirections
            .actionSpecifyAmountFragmentToConfirmationFragment(amount)
    v.findNavController().navigate(action)
}

@Override
public void onClick(View view) {
    float amount = ...;
    action =
        SpecifyAmountFragmentDirections
            .actionSpecifyAmountFragmentToConfirmationFragment(amount);
    Navigation.findNavController(view).navigate(action);
}

有关使用 Safe Args 在目的地之间传递数据的更多信息，请参阅使用 Safe Args 以类型安全的方式传递数据。

通过使用 Safe Args 确保类型安全

使用 Safe Args Gradle 插件在目的地之间导航。此插件生成简单对象和构建器类，这些类支持目的地之间类型安全的导航和参数传递。

要将Safe Args添加到您的项目中，请在您的顶级build.gradle文件中包含以下classpath

buildscript {
    repositories {
        google()
    }
    dependencies {
        def nav_version = "2.8.4"
        classpath "androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version"
    }
}

buildscript {
    repositories {
        google()
    }
    dependencies {
        val nav_version = "2.8.4"
        classpath("androidx.navigation:navigation-safe-args-gradle-plugin:$nav_version")
    }
}

您还必须应用两个可用插件之一。

要生成适合 Java 或混合 Java 和 Kotlin 模块的 Java 语言代码，请将此行添加到您的应用或模块的build.gradle文件中

plugins {
  id 'androidx.navigation.safeargs'
}

plugins {
    id("androidx.navigation.safeargs")
}

或者，要生成适合仅 Kotlin 模块的 Kotlin 代码，请添加

plugins {
  id 'androidx.navigation.safeargs.kotlin'
}

plugins {
    id("androidx.navigation.safeargs.kotlin")
}

您必须在gradle.properties文件中包含android.useAndroidX=true，如迁移到 AndroidX中所述。

启用 Safe Args 后，插件会生成包含每个已定义操作的类和方法的代码。对于每个操作，Safe Args 还会为每个源头目的地生成一个类，该类是操作的来源目的地。生成的类名是源头目的地类名和单词“Directions”的组合。例如，如果目的地名为SpecifyAmountFragment，则生成的类名为SpecifyAmountFragmentDirections。生成的类包含源头目的地中定义的每个操作的静态方法。此方法将任何定义的操作参数作为参数，并返回一个NavDirections对象，您可以将其传递给navigate()。

例如，假设我们有一个导航图，其中包含一个连接源头目的地SpecifyAmountFragment和接收目的地ConfirmationFragment的单个操作。

Safe Args 生成一个SpecifyAmountFragmentDirections类，其中包含一个名为actionSpecifyAmountFragmentToConfirmationFragment()的方法，该方法返回一个NavDirections对象。然后，可以将此返回的NavDirections对象直接传递给navigate()，如下例所示

override fun onClick(view: View) {
    val action =
        SpecifyAmountFragmentDirections
            .actionSpecifyAmountFragmentToConfirmationFragment()
    view.findNavController().navigate(action)
}

@Override
public void onClick(View view) {
    NavDirections action =
        SpecifyAmountFragmentDirections
            .actionSpecifyAmountFragmentToConfirmationFragment();
    Navigation.findNavController(view).navigate(action);
}

有关使用 Safe Args 在目的地之间传递数据的更多信息，请参阅在目的地之间传递数据中的使用 Safe Args 以类型安全的方式传递数据。