今天的取捨問題

三件事同時要解：

1. 多模組的設定重複。每個 Android library 模組都要設 compileSdk、minSdk、Java 版本、flavor、JUnit 5、Compose 依賴。十幾個模組手寫等於十幾份會漂移的複本。
2. Secrets 曾經進過 git。舊 repo 的建置腳本裡以字面值寫著雲端儲存的 access key／secret key（正式與測試各一組）、推播服務的 App ID；gradle.properties 裡有 keystore 密碼；四份 Firebase 設定檔與一張自簽 CA 憑證也在版本控制裡。這些不是「有人不小心」，而是建置流程本來就沒有給 secrets 一個不在 git 的家。
3. 工具鏈跳了一個大版本。舊 repo 停在 AGP 8.1 / Kotlin 2.0；新 repo 直接用 AGP 9.4 / Kotlin 2.4 / Gradle 9.7。AGP 9 把 Kotlin 編譯內建進去了，舊的寫法會直接報錯。

選項與代價

• build-logic/：比較像「施工規範」。每個模組的建置檔寫一行「照 A 規範施工」，就套用那套規範。它只在 build 的時候用到，不會打包進 APK。
• core:*：就是建築元件，會真的蓋進房子（APK）裡。
• 照這個比喻延伸：feature:* 是一個個房間，app 是整棟房子。

為什麼選 C 方案而不選 B ?
因為 Gradle 官方建議的做法 convention plugin，是要替補 subprojects {} 一個專案的建置邏輯能直接修改其他專案的邏輯。

secrets 為什麼不能再進 git ?

1. 會外洩出去。
2. 事後刪掉金鑰也還會在舊的 commits 裡存在。
3. Repo 是放程式碼的地方，不應該作為保管金鑰的倉庫。