기본 모듈에서 Kotlin 확장 프로그램(KTX) API를 사용하도록 이전

Firebase는 Kotlin에 대한 노력을 늘리고 있으며, Firebase에서 Kotlin의 접근성과 사용 편의성을 높이기 위해 Android 생태계를 현대화하기 위해 노력하고 있습니다.

이러한 현대화를 위해 Android용 Firebase SDK를 일부 변경합니다. 이 페이지에서는 이 변경사항에 관한 다음과 같은 중요한 정보를 설명합니다.

• 변경사항
• 변경하는 이유
• 이 변경사항과 관련된 중요 날짜
• 기본 모듈에서 KTX API를 사용하도록 마이그레이션하는 방법

앱을 마이그레이션하는 방법 알아보기

참고: 이 변경사항의 최초 계획일은 2024년 4월이었습니다. 2024년 9월 이후에 이 변경사항이 적용됩니다.

변경되는 사항

Kotlin 확장 프로그램(KTX) API가 각각의 기본 모듈에 추가되었습니다. 예를 들어 firebase-perf-ktx의 모든 API는 com.google.firebase.perf 패키지 아래 firebase-perf에 추가되었습니다.

이 변경사항으로 인해 Kotlin 개발자는 이제 KTX 모듈 대신 기본 모듈을 사용할 수 있습니다(Firebase BoM v32.5.0 이상 또는 BoM v32.5.0 이상에 나열된 기본 모듈 버전을 사용하는 경우).

이러한 변경사항의 일환으로 모든 KTX 모듈의 Kotlin 확장 프로그램(KTX) API가 지원 중단됩니다. 빠르면 2024년 9월부터 KTX 모듈이 더 이상 출시되지 않습니다. 이때 Firebase Android BoM에서 KTX 라이브러리도 삭제됩니다.

참고: 현재 또는 이전에 출시된 KTX 모듈 또는 BoM 버전은 계속 작동합니다.
하지만 계속해서 문제를 해결하고 KTX 모듈이 더 이상 출시되지 않더라도 변경사항과 새로운 기능을 활용할 수 있도록 앱을 마이그레이션하여 기본 모듈에서 KTX API를 사용하는 것이 좋습니다.

변경하는 이유가 무엇인가요?

Firebase는 Android 개발자를 위해 Kotlin 중심 생태계를 조성하기 위해 최선을 다하고 있습니다. 이 패키징 현대화는 다음과 같은 이점을 제공합니다.

• 간소화된 종속 항목 관리: 이제 단일 모듈에만 의존하면 되므로 기본 모듈과 Kotlin 확장 프로그램 간에 전환하거나 둘 다에 의존할 필요가 없습니다.

• 향상된 Kotlin 지원: 이제 모든 Android용 Firebase SDK에서 Kotlin에 대한 더 나은 지원을 제공합니다. Kotlin 친화적인 모든 새로운 기능을 기본 모듈에 직접 포함할 예정입니다.

이 변경사항과 관련된 중요 날짜

계속해서 문제를 해결하고 KTX 모듈이 더 이상 출시되지 않더라도 변경사항과 새로운 기능을 활용할 수 있도록 2024년 9월 이전에 기본 모듈에서 KTX API를 사용하도록 앱을 마이그레이션하는 것이 좋습니다.

2023년 10월

Kotlin 확장 프로그램(KTX) API가 각각의 기본 모듈에 추가되었으므로 이제 Firebase BoM v32.5.0 이상 또는 BoM v32.5.0 이상에 나열된 기본 모듈 버전을 사용할 때 기본 모듈에서 직접 KTX API를 사용할 수 있습니다.

이와 동시에 KTX 모듈의 Kotlin 확장 프로그램(KTX) API가 지원 중단되었습니다(이 변경사항을 설명하는 출시 노트 참고). 지원 중단 단계 동안 KTX 모듈의 지원 중단된 API가 계속 작동하고 유지됩니다.

빠르면 2024년 9월부터

KTX 모듈의 새 버전이 출시되지 않고 Firebase BoM에서 KTX 모듈이 삭제됩니다.

이전에 출시된 모든 KTX 모듈 버전이나 BoM은 계속 작동하지만 유지보수 종료로 전환됩니다. 즉, 더 이상 KTX 모듈에 버그 수정, 이전 버전과 호환되는 변경사항, 새로운 기능이 추가되지 않습니다. 대신 Android에서 Firebase를 위한 모든 향후 개발은 기본 모듈(Java 및 Kotlin 모두)에서 이루어집니다.

기본 모듈에서 KTX API를 사용하도록 마이그레이션하는 방법

Kotlin 확장 프로그램(KTX) API를 사용하는 경우 앱에서 다음과 같이 업데이트하여 KTX 모듈 대신 기본 모듈의 API를 사용하기 시작합니다.

1. KTX 모듈이 아닌 기본 모듈을 사용하도록 Gradle 종속 항목을 수정합니다. 예를 들면 Firebase Android BoM를 사용하는 경우입니다(권장).

   BEFORE

   dependencies {
     // ...
   
     // Import the Firebase BoM
     implementation(platform("com.google.firebase:firebase-bom:33.6.0"))
   
     // Using KTX libraries for Authentication and Cloud Firestore
     implementation("com.google.firebase:firebase-auth-ktx")
     implementation("com.google.firebase:firebase-firestore-ktx")
   }

   AFTER

   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:33.6.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")
   }

   Firebase Android BoM을 사용하지 않는 경우

   BEFORE

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

   AFTER

   dependencies {
     // ...
   
     // No need to use the KTX libraries, everything is now in the main module
     // Make sure to use a version listed in Firebase BoM v32.5.0 or higher
     implementation("com.google.firebase:firebase-auth:23.1.0")
     implementation("com.google.firebase:firebase-firestore:25.1.1")
   }

   
   

2. 코드를 업데이트하여 KTX API의 모든 일치하는 항목을 com.google.firebase 패키지 아래 기본 모듈에 있는 재배치된 API로 바꿉니다.

   BEFORE

   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

   AFTER

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