Kotlin Android: unresolved reference databinding — как исправить ошибку?

Причина ошибки и полное решение

Ошибка "unresolved reference databinding" возникает, когда Android Studio не может сгенерировать классы Data Binding. Это происходит из-за одной из трёх причин: неправильная конфигурация Gradle, отсутствие плагина Kotlin Kapt или проблемы с синхронизацией проекта. Давайте разберём пошаговое исправление.

Шаг 1: Проверьте build.gradle на уровне проекта

Убедитесь, что в файле build.gradle.kts (или build.gradle) на уровне проекта подключён плагин Kotlin Kapt. Без него Data Binding не сможет обрабатывать аннотации.

// build.gradle.kts (Project)
plugins {
    id("com.android.application") version "7.4.0" apply false
    id("org.jetbrains.kotlin.android") version "1.7.0" apply false
    id("org.jetbrains.kotlin.kapt") version "1.7.0" apply false // обязательно!
}

Шаг 2: Настройте build.gradle модуля app

В файле build.gradle.kts (app) примените плагин Kapt и включите Data Binding через buildFeatures:

// build.gradle.kts (app)
plugins {
    id("com.android.application")
    id("org.jetbrains.kotlin.android")
    id("org.jetbrains.kotlin.kapt") // обязательно!
}

android {
    compileSdk = 33
    buildFeatures {
        dataBinding = true
    }
    // ... остальные настройки
}

dependencies {
    // Другие зависимости
}

Шаг 3: Синхронизируйте и пересоберите проект

После внесения изменений нажмите File → Sync Project with Gradle Files. Затем выполните Build → Clean Project и Build → Rebuild Project. Это гарантирует, что сгенерируются классы Data Binding.

Шаг 4: Проверьте структуру layout

Убедитесь, что ваш XML-файл начинается с тега <layout> и что у него нет синтаксических ошибок. Пример правильного файла activity_main.xml:

<?xml version="1.0" encoding="utf-8"?>
<layout xmlns:android="http://schemas.android.com/apk/res/android">
    <LinearLayout
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:orientation="vertical">
        
        <TextView
            android:id="@+id/textView"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="Hello Data Binding!" />
    </LinearLayout>
</layout>

Шаг 5: Импортируйте правильный класс

После сборки класс ActivityMainBinding будет автоматически сгенерирован. Импортируйте его из пакета databinding:

import com.example.app.databinding.ActivityMainBinding
import androidx.databinding.DataBindingUtil

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        val binding: ActivityMainBinding = DataBindingUtil.setContentView(this, R.layout.activity_main)
        binding.textView.text = "Привет из Data Binding!"
    }
}

Что делать, если ошибка осталась?

• Проверьте версии: Kotlin и Kapt должны совпадать (например, обе 1.7.0).
• Обновите Android Studio: Используйте версию 2022.1 или новее.
• Попробуйте View Binding: Если Data Binding не нужен, используйте viewBinding = true — он проще и не требует аннотаций.
• Удалите .gradle папку: Закройте студию, удалите ~/.gradle/caches и папку .gradle в проекте, затем откройте заново.

После выполнения этих шагов ошибка исчезнет. Data Binding — мощный инструмент, но требует правильной настройки Gradle.

android {
    buildFeatures {
        viewBinding = true
    }
}

import com.example.app.databinding.ActivityMainBinding

class MainActivity : AppCompatActivity() {
    private lateinit var binding: ActivityMainBinding

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        binding = ActivityMainBinding.inflate(layoutInflater)
        setContentView(binding.root)
        binding.textView.text = "Привет из View Binding!"
    }
}