0Pricing
Android Academy · Урок

Передача аргументов

Передавайте данные в пункт назначения

«Передача аргументов» — бесплатный урок Android Academy на CoddyKit. Это урок 3 из 4. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения Android Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс Android Academy содержит 4 уроков всего.

Передача данных между экранами

Часто назначению нужны данные — например идентификатор отображаемого элемента. В Navigation Compose аргументы кодируются непосредственно в маршруте, подобно URL.

Маршрут с заполнителем

Объявите заполнитель в маршруте с помощью фигурных скобок. Здесь {id} — аргумент с именем id.

composable("details/{id}") { backStackEntry ->
    // read id here
}

Объявление типа аргумента

Укажите навигатору тип аргумента с помощью arguments и navArgument. Навигатор проверит и преобразует значение за Вас.

composable(
    "details/{id}",
    arguments = listOf(navArgument("id") { type = NavType.IntType })
) { /* ... */ }

NavType

NavType объявляет тип данных аргумента — IntType, StringType, BoolType и другие. Навигатор соответствующим образом разбирает значение маршрута.

Чтение аргумента

Лямбда-выражение назначения предоставляет объект backStackEntry. Читайте аргументы из backStackEntry.arguments.

composable(
    "details/{id}",
    arguments = listOf(navArgument("id") { type = NavType.IntType })
) { backStackEntry ->
    val id = backStackEntry.arguments?.getInt("id") ?: 0
    DetailsScreen(id = id)
}

Переход со значением

Чтобы открыть экран, сформируйте строку маршрута, подставив настоящее значение вместо заполнителя.

navController.navigate("details/42")

Безопасное построение маршрута

Используйте шаблоны строк для вставки значения. Сегмент пути должен в точности соответствовать объявленному маршруту.

val itemId = 42
navController.navigate("details/$itemId")

Необязательные аргументы

Необязательные аргументы используют формат строки запроса с ?name=value и defaultValue. Их можно не указывать при навигации.

composable(
    "search?query={query}",
    arguments = listOf(navArgument("query") {
        defaultValue = ""
    })
) { /* ... */ }

Строковые аргументы требуют осторожности

Строковые аргументы должны быть безопасны для URL. Не передавайте через маршруты длинный текст или косые черты; для таких данных лучше использовать общий ViewModel или репозиторий, связанный с идентификатором.

Передавайте идентификаторы, а не объекты

Рекомендуемый подход: передавайте через маршрут небольшой идентификатор, например идентификатор элемента, а затем загружайте полный объект на экране назначения. Не сериализуйте большие объекты в маршруты.

Соберём всё вместе

Список переходит к экрану сведений, передавая идентификатор выбранного элемента.

composable("list") {
    ListScreen(onItemClick = { id ->
        navController.navigate("details/$id")
    })
}
composable(
    "details/{id}",
    arguments = listOf(navArgument("id") { type = NavType.IntType })
) { entry ->
    val id = entry.arguments?.getInt("id") ?: 0
    DetailsScreen(id = id)
}

Быстрая проверка

Как объявить в маршруте обязательный целочисленный аргумент с именем id?

Повторение

Передача аргументов:

  • Добавьте в маршрут {placeholder}.
  • Объявите тип с помощью navArgument и NavType.
  • Прочитайте аргумент из backStackEntry.arguments.
  • Выполните навигацию, подставив значение; передавайте небольшие идентификаторы, а не большие объекты.

Часто задаваемые вопросы

Урок «Передача аргументов» бесплатный?

Да — полный текст урока «Передача аргументов» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс Android Academy, подпишись на CoddyKit PRO. Курс Android Academy содержит 4 уроков всего.

Чему я научусь в уроке «Передача аргументов»?

Передавайте данные в пункт назначения Ты практикуешь Android Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать Android Academy?

Предыдущий опыт не требуется. Android Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 3 из 4.

Сколько времени занимает урок «Передача аргументов»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке Android Academy?

Да. Каждый урок Android Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

  1. Настройка NavHost
  2. Переходы между экранами
  3. Передача аргументов
  4. Нижняя навигация
← Назад к Android Academy