В чем разница между APT и KAPT?

Разница между APT и KAPT: эволюция обработки аннотаций в Android/Kotlin

Сущность APT (Annotation Processing Tool)

APT — это стандартный инструмент для обработки аннотаций в Java, работающий на этапе компиляции. Он является частью javac и позволяет генерировать код, ресурсы или проводить анализ на основе аннотаций в исходных файлах.

Ключевые характеристики APT:

• Работает только с Java-кодом — не поддерживает исходники Kotlin.
• Процессоры аннотаций — это Java-библиотеки, реализующие интерфейс javax.annotation.processing.Processor.
• Интегрирован в javac — запускается автоматически во время компиляции.
• Генерирует код до компиляции — созданные файлы затем компилируются вместе с основными.

Пример простого процессора APT:

@SupportedAnnotationTypes("com.example.MyAnnotation")
@SupportedSourceVersion(SourceVersion.RELEASE_8)
public class MyProcessor extends AbstractProcessor {
    @Override
    public boolean process(Set<? extends TypeElement> annotations, 
                          RoundEnvironment roundEnv) {
        // Обработка аннотаций и генерация кода
        return true;
    }
}

KAPT (Kotlin Annotation Processing Tool)

KAPT — это плагин компилятора Kotlin, который обеспечивает поддержку обработки аннотаций в Kotlin-коде, используя существующие Java-процессоры (APT). Это мост между Kotlin и Java APT.

Как работает KAPT:

1. Генерация заглушек (stubs) — KAPT сначала компилирует Kotlin-файлы в Java-заглушки (упрощенные Java-файлы).
2. Запуск Java-процессоров — стандартные APT процессоры обрабатывают эти заглушки.
3. Компиляция Kotlin — после обработки аннотаций, компилируется полный Kotlin-код с учетом сгенерированных файлов.

Ключевые особенности KAPT:

• Поддержка Kotlin-аннотаций — позволяет использовать @Annotation на Kotlin-коде.
• Совместимость с Java-процессорами — можно использовать библиотеки вроде Dagger 2, ButterKnife, Room без их модификации.
• Два режима работы:
  • Обычный режим — с генерацией заглушек (медленнее).
  • Режим KAPT без заглушек (KAPT incremental) — улучшенная производительность в новых версиях.

Настройка KAPT в Gradle:

plugins {
    kotlin("kapt") version "1.9.0"
}

dependencies {
    implementation("com.google.dagger:dagger:2.48")
    kapt("com.google.dagger:dagger-compiler:2.48")
}

Сравнительная таблица

Эволюция: KSP (Kotlin Symbol Processing)

Важное дополнение — сегодня существует более современная альтернатива: KSP (Kotlin Symbol Processing) от Google. В отличие от KAPT, KSP:

• Нативно работает с Kotlin — без генерации Java-заглушек.
• В 2-4 раза быстрее KAPT.
• Имеет доступ к Kotlin-специфичным конструкциям (extension-функции, object-декларации и др.).
• Используется в Room, Moshi и других современных библиотеках.

// Пример миграции с KAPT на KSP в build.gradle.kts
plugins {
    id("com.google.devtools.ksp") version "1.9.0-1.0.13"
}

dependencies {
    implementation("androidx.room:room-runtime:2.6.0")
    ksp("androidx.room:room-compiler:2.6.0") // Было kapt
}

Практические рекомендации

1. Для новых проектов на Kotlin предпочитайте KSP, если ваши библиотеки его поддерживают.
2. KAPT необходим, если:
   • Вы используете библиотеки, которые еще не поддерживают KSP (например, Dagger 2).
   • У вас смешанный Java/Kotlin проект с существующими Java-процессорами.
3. APT остается актуален для чистых Java-проектов или библиотек, ориентированных только на Java.

Производительность — главный недостаток KAPT, особенно в крупных проектах. Если вы столкнулись с длительным временем сборки из-за KAPT, рассмотрите:

• Включение инкрементальной обработки: kapt.incremental.apt = true
• Переход на KSP, где это возможно
• Оптимизацию количества аннотаций и процессоров

Таким образом, KAPT — это адаптер, который позволяет Kotlin-коду использовать богатую экосистему Java-процессоров аннотаций, тогда как APT — это нативный Java-инструмент. Выбор между ними определяется языком проекта и требованиями к производительности сборки.