Gradle

每次打包 AAB 或 APK，Android Studio 預設都會產出像 app-release.aab 或 app-debug.apk 這類的檔案名稱。這種預設命名在使用 Firebase App Distribution 或 Google Play 內部測試流程時，雖然不太會造成困擾，但如果你需要將 APK 或 AAB 檔案直接提供給 PM、QA 或外部合作夥伴安裝測試，那麼能夠一眼看出檔案版本與類型，會讓流程更順暢也更不容易搞混。 本文將示範如何透過 Gradle 設定，讓你在打包時自動加上版本號、Build Type 等資訊，生成便於辨識的輸出檔名。 設定方式 你可以根據不同的產出檔案類型（AAB、APK、AAR），在 app module 或 library module 的 build.gradle 中加入以下設定。 AAB：變更 App Bundle 檔名 在 build.gradle（app module）中 android 區塊內加入以下設定： 1 2 3 4 android { // 其他設定省略... setProperty("archivesBaseName", "taiwanNo1") } BTW: setProperty(key, value) 在 groovy 與 kts 都是通用的。 🚨 注意： 這個設定只會影響輸出檔案名稱的前綴，並不會完整覆蓋檔名結構。例如： 1 2 原始檔名：app-release.aab 變更後：taiwanNo1-release.aab 💡 為什麼使用 archivesBaseName ？ 因為目前 Gradle 尚未提供官方 API 可以直接命名 AAB 檔。 archivesBaseName 是 Gradle 用來設定各類 archives 類檔案輸出名稱的共通屬性。 所謂的 archives 檔案包含： APK、AAR、JAR、ZIP 等。 ...

在開發 App 的過程中，常常需要產出不同版本的 APK，給團隊成員或測試人員驗證功能。 這時候，「快速辨識版本」就變成一件非常重要的事了。 最常見、也最直接的方法，就是利用 Gradle 的 versionNameSuffix，在 App 的版本名稱後面自動加上一些額外資訊。 以我們團隊的習慣來說，我們會直接加上Build 當下的時間作為版本流水號，這樣每個 APK 都能有獨一無二的識別。但如果每次出新版本，都還要手動去改 Gradle 設定，實在是有點麻煩。 下面就分享一個簡單的做法，讓 Gradle 在每次 Build 的時候，自動把「打包時間」加到版本名稱後面。 程式碼範例 Groovy 寫法 1 2 3 4 5 6 7 8 9 10 11 12 13 14 // 產生日期時間字串 def getDate() { def date = new Date() def formattedDate = date.format('yyyyMMddHHmmss') return formattedDate } // 在buildType中就可使用 debug { applicationIdSuffix '.debug' // 設定版本名稱後綴 versionNameSuffix '-dev' + ' (' + getDate() + ')' // 其他設定... } Kotlin DSL (KTS) 寫法 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 android { // 其他設定... buildTypes { // 略... debug { isMinifyEnabled = false applicationIdSuffix = ".dev" // 設定版本名稱後綴 versionNameSuffix = "-dev (${getDate()})" } } } /** * 取得目前的日期時間字串 * * @return */ fun getDate(): String { val date = Calendar.getInstance().time val formatter = SimpleDateFormat("yyyyMMdd-HHmm", Locale.getDefault()) return formatter.format(date) } 這樣設好之後，每次打包 Debug 版 APK，都會自動帶上像 -dev(20250428-1430) 這種字串， 讓相關人員清楚知道這份檔案是什麼時候打包的。 ...