Перейдите на использование API-интерфейсов расширений Kotlin (KTX) в основных модулях.

Firebase усиливает свою приверженность Kotlin, и мы работаем над модернизацией нашей экосистемы Android, чтобы сделать Kotlin более доступным и простым в использовании с Firebase.

Для реализации этой модернизации мы вносим несколько изменений в наши Firebase SDK для Android. На этой странице представлена важная информация об этом изменении, в том числе:


Узнайте, как перенести ваше приложение

Что меняется?

API расширений Kotlin (KTX) добавлены в соответствующие основные модули. Например, все API из firebase-perf-ktx добавлены в firebase-perf в пакете com.google.firebase.perf .

Это изменение означает, что разработчики Kotlin теперь могут полагаться на основные модули вместо модулей KTX (при использовании Firebase BoM v32.5.0+ или версий основных модулей, перечисленных в BoM v32.5.0+).

В июле 2025 года мы прекратили выпуск новых версий модулей KTX и удалили библиотеки KTX из Firebase Android BoM (v34.0.0).

Почему мы вносим это изменение?

Firebase стремится создать экосистему для Android-разработчиков , ориентированную на Kotlin . Эта модернизация упаковки обеспечивает следующие преимущества:

  • Упрощенное управление зависимостями: теперь вам нужно зависеть только от одного модуля, что устраняет необходимость переключаться между основным модулем и расширениями Kotlin или зависеть от обоих.

  • Расширенная поддержка Kotlin: все наши Firebase SDK для Android теперь будут лучше поддерживать Kotlin. Мы включим все новые функции, совместимые с Kotlin, непосредственно в наши основные модули.

Важные даты для этого изменения

В октябре 2023 года

В октябре 2023 года API расширений Kotlin (KTX) были добавлены в соответствующие основные модули, что означает, что теперь вы можете использовать API KTX непосредственно из основных модулей при использовании Firebase BoM v32.5.0+ или версий основных модулей, перечисленных в BoM v32.5.0+.

Параллельно с этим, API расширения Kotlin (KTX) в модулях KTX были объявлены устаревшими (см. примечания к выпуску, описывающие это изменение). В течение периода устаревания устаревшие API в модулях KTX продолжат функционировать и поддерживаться.

В июле 2025 года

В июле 2025 года мы прекратили выпуск новых версий модулей KTX и удалили модули KTX из Firebase BoM (начиная с BoM v34.0.0 ).

Все ранее выпущенные версии модуля KTX или BoM продолжат работать, но теперь они находятся в состоянии окончания поддержки . Это означает, что мы не будем добавлять исправления ошибок, изменения для обеспечения обратной совместимости или новые функции в модули KTX. Вместо этого вся дальнейшая разработка Firebase на Android будет вестись только в основных модулях (как для Java, так и для Kotlin).

Как перейти на использование API KTX из основных модулей

Если вы используете API расширений Kotlin (KTX), внесите следующие обновления в свое приложение, чтобы начать использовать API из основных модулей вместо модулей KTX.

  1. Пересмотрите зависимости Gradle, чтобы они опирались на основной модуль, а не на модуль KTX. Например, если вы используете Firebase Android BoM (рекомендуется) :

    ДО

    dependencies {
  // ...

  // Import the Firebase BoM
  implementation(platform("com.google.firebase:firebase-bom:34.0.0"))

  // Using KTX libraries for Authentication and Cloud Firestore
  implementation("com.google.firebase:firebase-auth-ktx")
  implementation("com.google.firebase:firebase-firestore-ktx")
}

    ПОСЛЕ

    dependencies {
  // ...

  // Import the Firebase BoM as usual
  // Make sure to use Firebase BoM v32.5.0 or higher
  implementation(platform("com.google.firebase:firebase-bom:34.0.0"))

  // No need to use the KTX libraries; everything is now in the main module
  implementation("com.google.firebase:firebase-auth")
  implementation("com.google.firebase:firebase-firestore")
}


  2. Обновите код, заменив все вхождения API KTX перемещенными API в основном модуле в пакете com.google.firebase .

    ДО

    import com.google.firebase.auth.ktx.auth
import com.google.firebase.firestore.ktx.firestore
import com.google.firebase.firestore.ktx.toObject
import com.google.firebase.ktx.Firebase

    ПОСЛЕ

    import com.google.firebase.auth.auth
import com.google.firebase.firestore.firestore
import com.google.firebase.firestore.toObject
import com.google.firebase.Firebase