kotlin-tooling-agp9-migration

此技能作為開發人員將 Kotlin Multiplatform (KMP) 專案過渡至 Android Gradle Plugin (AGP) 9.0 及更高版本的專業遷移助手。AGP 9.0 引入了重大變更，特別是舊版 Android 外掛程式與 KMP 之間的不相容性，需要轉移至新的 com.android.kotlin.multiplatform.library 外掛程式。該技能提供了一種系統化的方法來審核相依性、現代化建置指令碼，並實施新的建議專案結構（即 KMP 模組與 Android 應用程式模組分離）。它專為在重大工具鏈升級期間遇到建置失敗或結構性障礙的 Android 與 KMP 開發人員而設計。

• 使用內含的指令碼執行完整的專案分析，以識別外掛程式設定、版本目錄使用情況以及潛在的原始碼集衝突。

• 指導從頂層 android {} 區塊過渡到封裝的 kotlin { android {} } 設定模型。

• 自動化原始目錄結構（如 src/androidMain、src/androidHostTest）的遷移，以符合 KMP 約定。

• 提供專家級說明，用於將 kapt 遷移至 KSP 或 com.android.legacy-kapt，以及在多平台環境中管理資源/測試的啟用。

• 透過為簡單的函式庫更新與複雜的應用程式模組拆分提供清晰的路徑（路徑 A、B 或 C），支援架構決策。

• 首先執行內建的專案分析指令碼，以產生模組類型與當前外掛程式狀態的摘要。

• 遵循逐步檢查清單，確保命名空間設定、消費者 ProGuard 規則與建置變體解析皆得到正確處理。

• 當遇到與 AGP 9.0、多平台外掛程式不相容相關的錯誤，或需要將單體式專案重構為新的 JetBrains 標準結構時，請使用此技能。

• 請注意，KMP 函式庫中已移除 BuildConfig 支援，該技能提供使用 expected/actual 模式進行組態管理的解決方案。

• 在執行 build.gradle.kts 檔案的手動修改之前，請務必驗證版本目錄 (libs.versions.toml) 的一致性。