Решение ошибки Kotlin-Android: нераспознанная ссылка Databinding

Быстрый ответ

Если столкнулись с ошибкой «неразрешенная ссылка databinding» и классы DataBinding не определяются, следуйте этим шагам:

1. Активируйте DataBinding в файле build.gradle (app):

android {
    ...
    buildFeatures {
        dataBinding true // Активация DataBinding
    }
}

2. Оберните ваши XML-представления в тег <layout> для корректного функционирования DataBinding:

<layout ...>
    <data>
        <!-- Объявление переменных и типов данных здесь -->
    </data>
    <TextView ... /> <!-- И TextView будет работать корректно -->
</layout>

3. Пересоздайте классы DataBinding:

./gradlew clean build // Пересобираем проект!

Готово! Теперь классы DataBinding должны определяться без ошибок. 🎉

Понимание конфигурации Gradle

Теперь подробно рассмотрим, как настроить DataBinding в вашем проекте на Kotlin-Android:

Корректная настройка build.gradle

Для успешной сборки проекта требуются соответствующие инструменты:

• Подключите плагин kotlin-kapt:

apply plugin: 'kotlin-kapt' // Активируем kotlin-kapt

• Убедитесь, что версии Kotlin и Android Gradle Plugin совместимы с DataBinding. Проверьте и укажите их в build.gradle (project):

buildscript {
    ext.kotlin_version = '1.6.10' // Обновляем версию Kotlin
    dependencies {
        classpath 'com.android.tools.build:gradle:7.0.3' // Указываем версию Gradle
        classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version"
    }
}

• Добавьте зависимость kapt для компилятора DataBinding и включите generateStubs, если это необходимо:

dependencies {
    ...
    kapt 'com.android.databinding:compiler:3.5.4' // Определяем компилятор Data Binding
}

kapt {
    generateStubs = true // Включаем генерацию заглушек
}

Помните, что все изменения должны быть сделаны в секции android файла build.gradle (app).

Подробнее об этом расскажет наш спикер на видео

Проверка XML файлов

DataBinding не будет функционировать без обертки XML-разметки в теги <layout>:

// Без <layout> всё пойдёт наперекосяк!

Внимание к синтаксису

Ошибки в синтаксисе файлов Gradle или XML могут помешать правильной работе DataBinding. Внимательно следите за деталями и версиями!

Обновите инструменты

Убедитесь, что ваша Android Studio, Gradle и плагины обновлены до последних версий и совместимы друг с другом.

Визуализация

**DataBinding** служит связующим звеном между вашим кодом на Kotlin и XML-разметкой:

1. Включите **DataBinding** в `build.gradle (app)`.
2. Оформите XML-разметку с тегами **<layout>**.
3. И наслаждайтесь идеальной синхронизацией данных!

// Kotlin до включения DataBinding:
val binding: MyLayoutBinding? = null  // "Эй, есть кто-нибудь здесь?" – binding

// Kotlin после включения DataBinding:
val binding: MyLayoutBinding = DataBindingUtil.inflate()  // "Мир рад приветствовать тебя!" – binding

Без DataBinding: Ваше приложение подобно пазлу с недостающими деталями 😕

С DataBinding: Всё на своих местах, работа идёт гладко! ✨

Изучение DataBinding

Хотите более глубокого понимания DataBinding? Рекомендуем прочитать следующее:

Настройка dataBinding и viewBinding одновременно

С версии Android Studio Arctic Fox 2020.3.1 вы можете использовать DataBinding вместе с ViewBinding:

android {
    ...
    buildFeatures {
        dataBinding true
        viewBinding true
    }
}

Синхронность версий и обновления

Следите за актуальными версиями компилятора Data Binding на репозитории Maven. Несоответствие версий различных компонентов может вызвать нежелательные ошибки.

Обучение за счёт примеров

Изучайте репозитории на GitHub с примерами использования DataBinding. Это подобно кулинарным мастер-классам, но для программистов!

Полезные материалы

1. Библиотека Data Binding | Разработчики Android — официальное руководство по Data Binding.
2. Архитектура приложений: UI слой – Первые шаги — инструкция по настройке data binding.
3. Миграция с Kotlin synthetics на View Binding | Разработчики Android — руководство по переходу с Kotlin synthetics на View Binding.
4. Почему использовать executePendingBindings в RecyclerView — советы от сообщества Stack Overflow о применении data binding.
5. Изучение Data Binding в Kotlin – Medium — подробная статья о Data Binding в Kotlin.
6. Заметки о релизе Android Gradle Plugin версии 8.2 — информация о изменениях в плагине, важных для Data Binding.
7. Применение Data Binding в Kotlin – Пример GitHub Gist — пример от Jake Wharton о использовании Data Binding в Kotlin-Android.