fix deprecation message (#5409)

Author: VinayGuthal

appcheck/firebase-appcheck/src/main/java/com/google/firebase/appcheck/ktx/FirebaseAppCheck.kt

@@ -23,38 +23,30 @@ import com.google.firebase.ktx.Firebase
 import com.google.firebase.ktx.app
 
 /**
+ * Accessing this object for Kotlin apps has changed; see the
+ * [migration guide](https://firebase.google.com/docs/android/kotlin-migration).
+ *
  * Returns the [FirebaseAppCheck] instance of the default [FirebaseApp].
  * @deprecated **Deprecation Notice:** The Kotlin extensions (KTX) APIs have been added to their
  * respective main modules, and the Kotlin extension (KTX) APIs in
  * `com.google.firebase.firebase-appcheck-ktx` are now deprecated. As early as April 2024, we'll no
  * longer release KTX modules. For details, see the
  * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
-@Deprecated(
-  "Use `com.google.firebase.appcheck.Firebase.appCheck` from the main module instead.",
-  ReplaceWith(
-    expression = "com.google.firebase.Firebase.appCheck",
-    imports = ["com.google.firebase.Firebase", "com.google.firebase.appcheck.appCheck"]
-  )
-)
 val Firebase.appCheck: FirebaseAppCheck
   get() = FirebaseAppCheck.getInstance()
 
 /**
+ * Accessing this object for Kotlin apps has changed; see the
+ * [migration guide](https://firebase.google.com/docs/android/kotlin-migration).
+ *
  * Returns the [FirebaseAppCheck] instance of a given [FirebaseApp].
  * @deprecated **Deprecation Notice:** The Kotlin extensions (KTX) APIs have been added to their
  * respective main modules, and the Kotlin extension (KTX) APIs in
  * `com.google.firebase.firebase-appcheck-ktx` are now deprecated. As early as April 2024, we'll no
  * longer release KTX modules. For details, see the
  * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
-@Deprecated(
-  "Use `com.google.firebase.appcheck.Firebase.appCheck(app)` from the main module instead.",
-  ReplaceWith(
-    expression = "com.google.firebase.Firebase.appCheck(app)",
-    imports = ["com.google.firebase.Firebase", "com.google.firebase.appcheck.appCheck"]
-  )
-)
 fun Firebase.appCheck(app: FirebaseApp) = FirebaseAppCheck.getInstance(app)
 
 /**
@@ -68,8 +60,8 @@ fun Firebase.appCheck(app: FirebaseApp) = FirebaseAppCheck.getInstance(app)
  * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
-  "Use `com.google.firebase.appcheck.AppCheckToken.component1` from the main module instead.",
-  ReplaceWith(expression = "component1()", imports = ["com.google.firebase.appcheck.component1"])
+  "Migrate to use the KTX API from the main module: https://firebase.google.com/docs/android/kotlin-migration.",
+  ReplaceWith("")
 )
 operator fun AppCheckToken.component1() = token
 
@@ -84,8 +76,8 @@ operator fun AppCheckToken.component1() = token
  * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
-  "Use `com.google.firebase.appcheck.AppCheckToken.component2` from the main module instead.",
-  ReplaceWith(expression = "component2()", imports = ["com.google.firebase.appcheck.component2"])
+  "Migrate to use the KTX API from the main module: https://firebase.google.com/docs/android/kotlin-migration.",
+  ReplaceWith("")
 )
 operator fun AppCheckToken.component2() = expireTimeMillis
 
@@ -98,12 +90,8 @@ operator fun AppCheckToken.component2() = expireTimeMillis
  * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
-  "Use `com.google.firebase.appcheck.FirebaseAppCheckKtxRegistrar` from the main module instead.",
-  ReplaceWith(
-    expression = "FirebaseAppCheckKtxRegistrar",
-    imports =
-      ["com.google.firebase.Firebase", "com.google.firebase.appcheck.FirebaseAppCheckKtxRegistrar"]
-  )
+  "Migrate to use the KTX API from the main module: https://firebase.google.com/docs/android/kotlin-migration.",
+  ReplaceWith("")
 )
 class FirebaseAppCheckKtxRegistrar : ComponentRegistrar {
   override fun getComponents(): List<Component<*>> = listOf()

firebase-appdistribution-api/src/main/java/com/google/firebase/appdistribution/ktx/FirebaseAppDistribution.kt

@@ -24,21 +24,16 @@ import com.google.firebase.components.ComponentRegistrar
 import com.google.firebase.ktx.Firebase
 
 /**
+ * Accessing this object for Kotlin apps has changed; see the
+ * [migration guide](https://firebase.google.com/docs/android/kotlin-migration).
+ *
  * Returns the [FirebaseAppDistribution] instance of the default [FirebaseApp].
  * @deprecated **Deprecation Notice:** The Kotlin extensions (KTX) APIs have been added to their
  * respective main modules, and the Kotlin extension (KTX) APIs in
  * `com.google.firebase:firebase-appdistribution-api-ktx` are now deprecated. As early as April
  * 2024, we'll no longer release KTX modules. For details, see the
  * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
-@Deprecated(
-  "Use `com.google.firebase.Firebase.appDistribution` from the main module instead.",
-  ReplaceWith(
-    expression = "com.google.firebase.Firebase.appDistribution",
-    imports =
-      ["com.google.firebase.Firebase", "com.google.firebase.appdistribution.appDistribution"]
-  )
-)
 val Firebase.appDistribution: FirebaseAppDistribution
   get() = FirebaseAppDistribution.getInstance()
 
@@ -53,11 +48,8 @@ val Firebase.appDistribution: FirebaseAppDistribution
  * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
-  "Use `com.google.firebase.appdistribution.AppDistributionRelease.component1()` from the main module instead.",
-  ReplaceWith(
-    expression = "component1()",
-    imports = ["com.google.firebase.Firebase", "com.google.firebase.appdistribution.component1"]
-  )
+  "Migrate to use the KTX API from the main module: https://firebase.google.com/docs/android/kotlin-migration.",
+  ReplaceWith("")
 )
 operator fun AppDistributionRelease.component1() = binaryType
 
@@ -72,11 +64,8 @@ operator fun AppDistributionRelease.component1() = binaryType
  * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
-  "Use `com.google.firebase.appdistribution.AppDistributionRelease.component2()` from the main module instead.",
-  ReplaceWith(
-    expression = "component2()",
-    imports = ["com.google.firebase.Firebase", "com.google.firebase.appdistribution.component2"]
-  )
+  "Migrate to use the KTX API from the main module: https://firebase.google.com/docs/android/kotlin-migration.",
+  ReplaceWith("")
 )
 operator fun AppDistributionRelease.component2() = displayVersion
 
@@ -91,11 +80,8 @@ operator fun AppDistributionRelease.component2() = displayVersion
  * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
-  "Use `com.google.firebase.appdistribution.AppDistributionRelease.component3()` from the main module instead.",
-  ReplaceWith(
-    expression = "component3()",
-    imports = ["com.google.firebase.Firebase", "com.google.firebase.appdistribution.component3"]
-  )
+  "Migrate to use the KTX API from the main module: https://firebase.google.com/docs/android/kotlin-migration.",
+  ReplaceWith("")
 )
 operator fun AppDistributionRelease.component3() = versionCode
 
@@ -110,11 +96,8 @@ operator fun AppDistributionRelease.component3() = versionCode
  * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
-  "Use `com.google.firebase.appdistribution.AppDistributionRelease.component4()` from the main module instead.",
-  ReplaceWith(
-    expression = "component4()",
-    imports = ["com.google.firebase.Firebase", "com.google.firebase.appdistribution.component4"]
-  )
+  "Migrate to use the KTX API from the main module: https://firebase.google.com/docs/android/kotlin-migration.",
+  ReplaceWith("")
 )
 operator fun AppDistributionRelease.component4() = releaseNotes
 
@@ -129,11 +112,8 @@ operator fun AppDistributionRelease.component4() = releaseNotes
  * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
-  "Use `com.google.firebase.appdistribution.UpdateProgress.component1()` from the main module instead.",
-  ReplaceWith(
-    expression = "component1()",
-    imports = ["com.google.firebase.Firebase", "com.google.firebase.appdistribution.component1"]
-  )
+  "Migrate to use the KTX API from the main module: https://firebase.google.com/docs/android/kotlin-migration.",
+  ReplaceWith("")
 )
 operator fun UpdateProgress.component1() = apkBytesDownloaded
 
@@ -148,11 +128,8 @@ operator fun UpdateProgress.component1() = apkBytesDownloaded
  * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
-  "Use `com.google.firebase.appdistribution.UpdateProgress.component2()` from the main module instead.",
-  ReplaceWith(
-    expression = "component2()",
-    imports = ["com.google.firebase.Firebase", "com.google.firebase.appdistribution.component2"]
-  )
+  "Migrate to use the KTX API from the main module: https://firebase.google.com/docs/android/kotlin-migration.",
+  ReplaceWith("")
 )
 operator fun UpdateProgress.component2() = apkFileTotalBytes
 
@@ -167,11 +144,8 @@ operator fun UpdateProgress.component2() = apkFileTotalBytes
  * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
-  "Use `com.google.firebase.appdistribution.UpdateProgress.component3()` from the main module instead.",
-  ReplaceWith(
-    expression = "component3()",
-    imports = ["com.google.firebase.Firebase", "com.google.firebase.appdistribution.component3"]
-  )
+  "Migrate to use the KTX API from the main module: https://firebase.google.com/docs/android/kotlin-migration.",
+  ReplaceWith("")
 )
 operator fun UpdateProgress.component3() = updateStatus
 
@@ -184,15 +158,8 @@ operator fun UpdateProgress.component3() = updateStatus
  * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
-  "Use `com.google.firebase.appdistribution.FirebaseAppDistributionKtxRegistrar` from the main module instead.",
-  ReplaceWith(
-    expression = "FirebaseAppDistributionKtxRegistrar",
-    imports =
-      [
-        "com.google.firebase.Firebase",
-        "com.google.firebase.appdistribution.FirebaseAppDistributionKtxRegistrar"
-      ]
-  )
+  "Migrate to use the KTX API from the main module: https://firebase.google.com/docs/android/kotlin-migration.",
+  ReplaceWith("")
 )
 @Keep
 class FirebaseAppDistributionKtxRegistrar : ComponentRegistrar {

firebase-common/src/main/java/com/google/firebase/ktx/Firebase.kt

@@ -44,38 +44,30 @@ import kotlinx.coroutines.asCoroutineDispatcher
 object Firebase
 
 /**
+ * Accessing this object for Kotlin apps has changed; see the migration guide:
+ * https://firebase.google.com/docs/android/kotlin-migration.
+ *
  * Returns the default firebase app instance.
  * @deprecated **Deprecation Notice:** The Kotlin extensions (KTX) APIs have been added to their
  * respective main modules, and the Kotlin extension (KTX) APIs in
  * `com.google.firebase.firebase-common-ktx` are now deprecated. As early as April 2024, we'll no
  * longer release KTX modules. For details, see the
  * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration).
  */
-@Deprecated(
-  "Use `com.google.firebase.Firebase.app` from the main module instead.",
-  ReplaceWith(
-    expression = "com.google.firebase.Firebase.app",
-    imports = ["com.google.firebase.Firebase", "com.google.firebase.app"],
-  )
-)
 val Firebase.app: FirebaseApp
   get() = FirebaseApp.getInstance()
 
 /**
+ * Accessing this object for Kotlin apps has changed; see the migration guide:
+ * https://firebase.google.com/docs/android/kotlin-migration.
+ *
  * Returns a named firebase app instance.
  * @deprecated **Deprecation Notice:** The Kotlin extensions (KTX) APIs have been added to their
  * respective main modules, and the Kotlin extension (KTX) APIs in
  * `com.google.firebase.firebase-common-ktx` are now deprecated. As early as April 2024, we'll no
  * longer release KTX modules. For details, see the
  * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration).
  */
-@Deprecated(
-  "Use `com.google.firebase.Firebase.app(name)` from the main module instead.",
-  ReplaceWith(
-    expression = "com.google.firebase.Firebase.app(name)",
-    imports = ["com.google.firebase.Firebase", "com.google.firebase.app"]
-  )
-)
 fun Firebase.app(name: String): FirebaseApp = FirebaseApp.getInstance(name)
 
 /**
@@ -87,11 +79,8 @@ fun Firebase.app(name: String): FirebaseApp = FirebaseApp.getInstance(name)
  * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
-  "Use `com.google.firebase.Firebase.initialize(context)` from the main module instead.",
-  ReplaceWith(
-    expression = "com.google.firebase.Firebase.initialize(context)",
-    imports = ["com.google.firebase.Firebase", "com.google.firebase.initialize"]
-  )
+  "Migrate to use the KTX API from the main module: https://firebase.google.com/docs/android/kotlin-migration.",
+  ReplaceWith("")
 )
 fun Firebase.initialize(context: Context): FirebaseApp? = FirebaseApp.initializeApp(context)
 
@@ -104,11 +93,8 @@ fun Firebase.initialize(context: Context): FirebaseApp? = FirebaseApp.initialize
  * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
-  "Use `com.google.firebase.Firebase.initialize(context, options)` from the main module instead.",
-  ReplaceWith(
-    expression = "com.google.firebase.Firebase.initialize(context, options)",
-    imports = ["com.google.firebase.Firebase", "com.google.firebase.initialize"]
-  )
+  "Migrate to use the KTX API from the main module: https://firebase.google.com/docs/android/kotlin-migration.",
+  ReplaceWith("")
 )
 fun Firebase.initialize(context: Context, options: FirebaseOptions): FirebaseApp =
   FirebaseApp.initializeApp(context, options)
@@ -122,16 +108,16 @@ fun Firebase.initialize(context: Context, options: FirebaseOptions): FirebaseApp
  * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
-  "Use `com.google.firebase.Firebase.initialize(context, options, name)` from the main module instead.",
-  ReplaceWith(
-    expression = "com.google.firebase.Firebase.initialize(context, options, name)",
-    imports = ["com.google.firebase.Firebase", "com.google.firebase.initialize"]
-  )
+  "Migrate to use the KTX API from the main module: https://firebase.google.com/docs/android/kotlin-migration.",
+  ReplaceWith("")
 )
 fun Firebase.initialize(context: Context, options: FirebaseOptions, name: String): FirebaseApp =
   FirebaseApp.initializeApp(context, options, name)
 
 /**
+ * Accessing this object for Kotlin apps has changed; see the migration guide:
+ * https://firebase.google.com/docs/android/kotlin-migration.
+ *
  * Returns options of default FirebaseApp
  * @deprecated **Deprecation Notice:** The Kotlin extensions (KTX) APIs have been added to their
  * respective main modules, and the Kotlin extension (KTX) APIs in
@@ -140,22 +126,16 @@ fun Firebase.initialize(context: Context, options: FirebaseOptions, name: String
  * [FAQ about this initiative.](https://firebase.google.com/docs/android/kotlin-migration)
  */
 @Deprecated(
-  "Use `com.google.firebase.Firebase.options` from the main module instead.",
-  ReplaceWith(
-    expression = "com.google.firebase.Firebase.options",
-    imports = ["com.google.firebase.Firebase", "com.google.firebase.options"]
-  )
+  "Migrate to use the KTX API from the main module: https://firebase.google.com/docs/android/kotlin-migration.",
+  ReplaceWith("")
 )
 val Firebase.options: FirebaseOptions
   get() = Firebase.app.options
 
 /** @suppress */
 @Deprecated(
-  "Use `com.google.firebase.FirebaseCommonKtxRegistrar` from the main module instead.",
-  ReplaceWith(
-    expression = "FirebaseCommonKtxRegistrar",
-    imports = ["com.google.firebase.Firebase", "com.google.firebase.FirebaseCommonKtxRegistrar"]
-  )
+  "Migrate to use the KTX API from the main module: https://firebase.google.com/docs/android/kotlin-migration.",
+  ReplaceWith("")
 )
 @Keep
 class FirebaseCommonKtxRegistrar : ComponentRegistrar {