為何出現此錯誤訊息？Use the existing version catalog reference (libs.google.play.app.update) instead

 

📌 錯誤原因

你的 build.gradle.kts 檔案（Kotlin DSL）可能使用了 版本目錄（Version Catalogs），所以無法直接使用：

kotlin
implementation("com.google.android.play:app-update:2.1.0")
implementation("com.google.android.play:app-update-ktx:2.1.0")

🔹 Gradle 提示你應該使用 libs.google.play.app.update 這類的 版本目錄引用方式。

---

🛠 解決方案

🔹 方法 1：改用 libs 版本目錄

如果你的專案 已啟用 libs.versions.toml 來管理依賴，請改成：

kotlin
implementation(libs.google.play.app.update)
implementation(libs.google.play.app.update.ktx)

✅ 這樣可以確保依賴是從 gradle/libs.versions.toml 管理的。

---

🔹 方法 2：手動新增 libs.versions.toml 設定

如果你沒有 libs.versions.toml，但希望使用版本目錄，可以這樣做：

1. 打開 gradle/libs.versions.toml（如果沒有，請自行建立）。

2. 新增 Play Core Library 的依賴：

   toml
   [versions]
   google-play = "2.1.0"
   
   [libraries]
   google-play-app-update = { module = "com.google.android.play:app-update", version.ref = "google-play" }
   google-play-app-update-ktx = { module = "com.google.android.play:app-update-ktx", version.ref = "google-play" }
   

3. 然後在 build.gradle.kts 使用：

   kotlin
   implementation(libs.google.play.app.update)
   implementation(libs.google.play.app.update.ktx)
   

---

🔹 方法 3：關閉版本目錄，直接使用原本的 implementation

如果你不想使用 版本目錄，你可以手動關閉這個功能，在 settings.gradle.kts 移除：

kotlin
enableFeaturePreview("VERSION_CATALOGS")

然後就可以直接使用：

kotlin
implementation("com.google.android.play:app-update:2.1.0")
implementation("com.google.android.play:app-update-ktx:2.1.0")

⚠ 注意：這樣做可能不符合 Gradle 的推薦設定，長遠來看不建議這樣處理。

---

🔹 結論

✅ 最佳做法：如果你的專案已經啟用了 libs.versions.toml，應該使用 方法 1 或 2。
⚠ 如果你想繼續使用傳統 implementation("xxx")，則可以 使用方法 3 來關閉版本目錄功能。