Posts

前言 在 Android 開發中，專案預設會有 debug 和 release 這兩種 build type，用來區分開發環境與正式環境。根據專案規模與開發流程，有些團隊甚至會進一步細分為 alpha、beta 等不同的 build variant，用以區隔開發的不同階段。 對開發者或測試人員來說，在測試機上同時安裝好幾個版本的 App 是稀鬆平常的事。但問題來了──怎麼快速分辨桌面上哪個 App 是哪個版本？ 這時候就有兩個選項可以幫上忙：改 App 名稱 或是 換 Icon。 改名稱其實很簡單，只要在對應 variant 的 strings.xml 裡覆寫 app_name 就搞定了。 至於換 App Icon，雖然理論上可以透過資源目錄的變體（例如 mipmap-debug）手動準備不同版本的 Icon，但這樣不僅麻煩，還得準備好幾套圖示，光想就頭痛。 easylauncher-gradle-plugin 就是專門為這種情境設計的工具。 easylauncher-gradle-plugin 介紹 usefulness/easylauncher-gradle-plugin 是一款可以自動幫你的 App Icon 加上標記（Ribbon）的 Gradle Plugin，能依據不同的 build type 或 variant 自動套用樣式。 你可以自由設定 ribbon 的文字、顏色、位置與樣式，也支援使用圖片當作覆蓋圖層，功能非常齊全。最棒的是──完全自動化，不需要額外準備 Icon！ 快速上手 以下是快速設定的方式，如果你想要深入客製化，推薦直接參考官方的 GitHub 文件。 使用 Kotlin DSL（KTS）搭配 libs.versions.toml libs.versions.toml 1 2 3 4 5 6 7 8 [versions] easylauncher = "6.4.1" # 略... [plugins] # 開發版 Icon easylauncher = { id = "com.starter.easylauncher", version.ref = "easylauncher" } build.gradle.kts (module-level) 1 2 3 4 5 6 7 8 9 10 11 12 13 14 plugins { // ... alias(libs.plugins.easylauncher) } // ... easylauncher { buildTypes { create("debug") { setFilters(chromeLike("dev")) } } } 📢 如果沒有特別設定 ribbon 樣式，預設會加上一個淡綠色的 ribbon，文字會是目前的 build type 或 variant 名稱。 ...

每次打包 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) 這種字串， 讓相關人員清楚知道這份檔案是什麼時候打包的。 ...

今天來分享一個跟軟體開發上無關的小故事。 Kobo 的閱讀器也買了好幾年了，最近雖然不像剛買的時候那麼頻繁地使用，但也是想到就會拿來看一下書。 但就在今年 1 月時，臨時想開機看書，卻發現底部的電源鍵整個脆化，只要輕輕一戳，塑膠按鍵的碎片就會被推入到機殼內。從碎裂的塑膠細縫中，隱約還能看到內部主機板。 上網查了一下過保後的維修服務，都只有看到跟 iFixit 合作的自行維修，而且 Kobo Clara HD 沒有在清單上… 搜尋了一輪，網路上的論壇只有提到用 3D 列印的方式，列印一個新的按鈕。甚至還有好心的網友，將 3D 列印的檔案分享出來，讓大家自行下載製作。 但…對於手邊沒有 3D 列印機的我來說，為了一顆閱讀器的小小電源鍵而買一台列印機，似乎成本有點太高… 因此，在拆機將脆化的按鍵拿出後，我開始尋找手邊是否有尺寸大小與電源鍵類似的小東西，也許可以作為替代品使用。 然後，我就發現犀牛盾出的 iPhone 電源鍵，大小非常地適合！ 一開始我嘗試由內向外將按鍵卡入機殼的電源孔，但因為內部主機板與外殼的空間過小，再加上孔洞大小很剛好，所以一直無法將按鈕裝上。 正當我覺得要再找其他的替代物品時，赫然發現將按鈕由外向內裝入，可以完美塞入，而且保有按鍵按壓的回饋感，不會因為按鈕過長導致一直抵著主機板上的開機鍵。 最後我的閱讀器就變成下面這個樣子。 復活啦！！ 以上方法，分享給同樣遇到電源鍵脆化的朋友XD

前言 工作上負責開發維護的一款 App，最近被提了一個新的需求。 客戶希望原有的 開啟 Google Maps 導航 這項功能，能夠除了起訖點外，還能在起訖點間加上停靠點。 原本以為這是件加個經緯度之類的參數，就能完成的事情。閱讀官方文件才發現，目前使用的 Google Maps Intents for Android 並不支援停靠點。 如果要有停靠點，就只能改用支援跨平台的 Maps URLs，且只有路徑規劃，沒有導航。 💡 路徑規劃跟導航差在哪裡？ 路徑規劃只會顯示起訖點與各停靠點間的路線。 導航則是會以目前定位直接開啟到目的地的路線指引。 也就是說，路徑規劃比較像是 App 內執行導航的前一個步驟，使用者必須自己按下開始導航。 什麼是 Maps URLs Maps URLs 是用來開啟 Google Maps App/Web 的跨平台 URL。這裡的跨平台包含 Android、 iOS 、 Web ，三大平台都可以支援。 目前已支援開啟的 App 功能有： Search 搜尋 Directions 路徑規劃 Display a Map 顯示地圖 Display a Street View panorama 街景服務 今天這篇文章只會提到第二個的路徑規劃，其他三種功能我之後會再另開文章補上~ 路徑規劃 顧名思義，就是開啟 Google Maps 的路徑規劃功能。 呼叫之後會在 Google Maps 上開啟點到點之間的路徑，並顯示距離和時間。 路徑規劃示意圖 路徑規劃示意圖 (使用定位作為起點) 導航示意圖 以上面三張圖來說，左側與中間的圖是路徑規劃，右側的圖是導航功能。 ...