1. Файл settings.gradle.kts
Находится в корневой директории проекта (на одном уровне с папкой .gradle, файлами build.gradle.kts и gradle.properties).
Изменения:
Добавьте или обновите секцию pluginManagement, чтобы подключить репозитории и плагин SafeArgs:
pluginManagement {
repositories {
google() // Репозиторий Google для плагина SafeArgs
mavenCentral() // Основной репозиторий для Kotlin и Android-зависимостей
}
plugins {
id("androidx.navigation.safeargs.kotlin") version "2.7.3" // Укажите актуальную версию
}
}
2. Файл build.gradle.kts модуля приложения
Находится в папке вашего модуля, обычно называется app/build.gradle.kts.
Это основной файл конфигурации для вашего приложения.
Изменения:
Подключите плагин SafeArgs в секции plugins:
plugins {
id("com.android.application") // Для модулей приложения
id("androidx.navigation.safeargs.kotlin") // Плагин SafeArgs
}
Если это библиотечный модуль, вместо com.android.application используйте com.android.library.
3. Добавление зависимостей для Navigation
В том же файле build.gradle.kts (модуль app или другой, где нужна навигация) добавьте зависимости в секцию dependencies:
dependencies {
implementation("androidx.navigation:navigation-fragment-ktx:2.7.3") // Для работы с фрагментами
implementation("androidx.navigation:navigation-ui-ktx:2.7.3") // Для поддержки навигации в UI-компонентах
}
4. Настройка XML-файла навигации
Файл навигации обычно находится в папке res/navigation. Если папки 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"
app:startDestination="@id/firstFragment">
<fragment
android:id="@+id/firstFragment"
android:name="com.example.FirstFragment"
android:label="First Fragment">
<action
android:id="@+id/action_firstFragment_to_secondFragment"
app:destination="@id/secondFragment" />
</fragment>
<fragment
android:id="@+id/secondFragment"
android:name="com.example.SecondFragment"
android:label="Second Fragment">
<argument
android:name="exampleArgument"
app:argType="string" />
</fragment>
</navigation>
5. Использование SafeArgs в коде
Теперь в вашем коде можно работать с автоматически сгенерированными классами для безопасных переходов:
Пример для FirstFragment:
val action = FirstFragmentDirections.actionFirstFragmentToSecondFragment("Пример аргумента")
findNavController().navigate(action)
Пример для получения аргумента в SecondFragment:
val args = SecondFragmentArgs.fromBundle(requireArguments())
val argument = args.exampleArgument
Проверка:
После внесения изменений выполните синхронизацию проекта в Android Studio:
File → Sync Project with Gradle Files
или
Нажмите на иконку "Синхронизация" в правом верхнем углу.
Теперь SafeArgs должен быть успешно настроен!
