Todorant 原生 Android App 如何用四天登上 Google Play,並順手減掉 4.5 MB
Todorant 的 Android 重寫版歷經四個版本從測試版登上 Google Play:被刪除的 Google 登入用戶端、R8 導致的 QR 碼登入閃退,以及讓 APK 從 3.3 MB 暴增到 7.7 MB 的未授權字體。
本頁內容
Todorant 的原生 Android App 在四天內從測試建置一路走到 Google Play 正式上架(2026 年 10 月 13 日至 16 日),最後上架的版本是 3.26 MB,而不是 7.74 MB。這中間花了四個版本(2.2.0 到 2.2.3),每個版本都修掉一個只有在真正發布時才會冒出來的問題:一個被刪除的 Google Cloud 專案、一個由 R8 引起的閃退,以及一套重達 4.5 MB、我本來就無權發行的字體。以下是完整清單與對應的 commit。
2026 年 10 月之前的 Android 版 Todorant 是什麼樣子?
Todorant 是一款一次只顯示一個任務的待辦事項管理工具,而且在繼續之前,它會要求你把每個逾期的任務都重新規劃一遍。Google Play 上原本的 Android App 是舊的 React Native 版本。10 月我把它換成原生的 Kotlin 與 Jetpack Compose App,透過新的 /v2 後端以單一 WebSocket 同步資料。10 月 13 日的 2.0.0 版本是它的第一個建置,而且當時只是測試版:Android 不允許用不同簽署金鑰更新 App,所以從舊 Play 版本遷移的人得先打開舊版一次完成同步,解除安裝後,再安裝新的 APK。登入之後,所有資料都會從伺服器回來。
為什麼 2.2.1 之前 Google 登入會失敗?
2.1.0 版發布時帶有一個已知問題:Google 登入不能用。原因很無聊。背後負責登入用戶端的 Google Cloud 專案被刪掉了,所以每次嘗試都以 deleted_client 錯誤收場。10 月 14 日的 2.2.1 版修復方式,是建立新的 Google Cloud 專案,設定網頁用戶端(重新導向 https://todorant.com/google_login_result),以及同時對應上傳金鑰與 Play 簽署金鑰的 Android 用戶端。後半段很關鍵:Play 會重新簽署你的 App,所以登入設定必須同時知道兩組指紋,否則測試版裡一切正常,從商店安裝的每個使用者卻都會登入失敗。
同一個版本也移除了 Google Calendar 同步。它早就不能動了,原本承載它的「整合」畫面也跟著拿掉。
R8 在 2.2.2 版弄壞了什麼?
Google Play 的發布前測試報告在測試裝置上跑了 2.2.1 版,結果發現只要掃描 QR 碼,App 就會直接關閉。QR 碼登入是你掃描網頁版顯示的條碼、在新裝置上登入的方式,這並不是 App 裡冷門的角落。
原因是完整模式下的 R8。ML Kit 的條碼掃描器會透過反射建立 registrar 類別來找出內部元件,用的是它們的無參數建構函式。R8 沒看到任何程式碼呼叫這些建構函式,就把它們移除了。接著 ComponentDiscovery 無法建立這些 registrar,有一個共用偏好設定元件從未被註冊,GmsBarcodeScanning.getClient() 就拋出了 NullPointerException。10 月 15 日合併的 2.2.2 版修正,只是在 proguard-rules.pro 裡加上幾行來保留這些建構函式。這是除錯建置永遠不會暴露的錯誤,也是為什麼每次推上正式版前都該跑一次發布前測試報告,而不是只跑過一次就算了。
APK 是怎麼在 2.2.3 版少掉 4.5 MB 的?
Android App 之前沿用了 iOS App 的字體排版,也就是由六個字型檔組成的 Apple SF Pro。SF Pro 只授權給 Apple 平台使用,根本不該出現在 Android 建置裡。它也很肥大:移除它的那個 commit 記錄了它占掉 4.5 MB 的打包體積。我改成 Android 的系統字型,並保留原本的字型家族與字重設定,所以沒有任何呼叫端需要修改。
以下是 2026 年 11 月 2 日量測的 Forgejo 發行檔大小:
| 版本 | 日期 | APK 大小 |
|---|---|---|
| 2.2.0 | 10 月 14 日 | 7,739,907 位元組 |
| 2.2.2 | 10 月 16 日 | 7,738,839 位元組 |
| 2.2.3 | 10 月 16 日 | 3,256,419 位元組 |
| 2.2.4 F-Droid 版 | 10 月 16 日 | 2,754,408 位元組 |
從 2.2.2 到 2.2.3 一共少了 4,482,420 位元組。2.2.3 就是登上 Google Play 的版本,同一天 README 也停止要 Android 使用者手動下載 APK。
為什麼會有獨立的 F-Droid 建置?
2.2.4 版(10 月 16 日)把 App 拆成兩個建置變體。play 變體保留了 Google 登入與 Google 的條碼掃描器。fdroid 變體完全不含 Google 程式碼:它改用開源的 ZXing 函式庫掃描 QR 碼(需要相機權限),也沒有 Google 登入按鈕。你仍然可以用電子郵件與密碼、Apple、Telegram 或 QR 碼登入。F-Droid 也會拒收 Gradle 加進 APK 裡的相依資訊區塊,所以發行建置把它排除掉了;現在每次發布版本時,CI 都會用上傳金鑰建置這兩個變體並附上兩個檔案,讓 F-Droid 可以拿自己的建置和我們的做驗證。F-Droid 版 APK 比 Play 版再小約 490 KB。
那 28 個權限後來怎麼了?
10 月 17 日,2.2.6 版清掉了一整堆 Todorant 從沒用過的權限。負責啟動器圖示徽章的函式庫 ShortcutBadger,替它認識的每一家啟動器廠商都宣告了一個權限,而 Credential Manager 又為通行密鑰加了兩個生物辨識權限。資訊清單合併工具把它們通通塞進了 App 裡。看那次 commit 的 diff,我數出 22 行用來移除它們的 tools:node="remove",連 VIBRATE 也拿掉了,因為滑動回饋現在改用 Compose 觸覺回饋,不需要任何權限。commit 訊息統計 App 的權限從原本的 28 個降到 5 個:網路連線、網路狀態、開機廣播接收器,以及規劃提醒用的通知權限(只有當你設定提醒時間時才會要求),再加上僅限 F-Droid 版本的相機權限。發行說明寫得很直白:Todorant 現在只會要求它真正用到的權限。
我自己沒有重新建置來讀合併後的資訊清單,所以 28 和 5 是 commit 裡的數字,22 則是我自己數出來的移除行數。
第一批真實使用者發現了什麼?
兩件事,而且都是我造成的。10 月 16 日我修了大型帳號的初次登入問題。全新登入會把整個帳號拉下來,而 App 裡有四個地方各自啟動了一次完整下載,導致一個有 40,000 筆待辦事項的測試帳號同時被下載兩三次,直接把記憶體耗盡。伺服器的心跳回應排在下載後面,用戶端每 15 秒一次的 ping 就把 socket 關掉了,而 30 秒的同步逾時也把下載時間算了進去。這段期間,App 畫面上只顯示「設定」分頁。修正的方式是讓游標相同的拉取請求併入已經在跑的那一個,給同步 30 秒連線時間與 120 秒回應時間,並把 ping 間隔拉高到 60 秒。10 月 23 日的 2.2.7 版則還原了大家在舊 App 裡只存在裝置本機的任務——之前的更新不小心把它們藏起來了。
下次我還是會照樣做的事
- 每一個要推向正式環境的建置,都跑一遍 Play 的發布前測試報告。它抓到了唯一那個真正要命的閃退。
- 檢查從其他平台搬過來的每一份資產授權。一個比應有大小胖了一倍的 APK,本身就是查下去的好理由。
- 從第一天起,就替 Play 簽署金鑰準備好第二組 Google 登入用戶端。
- 把合併後資訊清單裡的每一個權限,都當成你必須解釋得出來由的東西。
Todorant 現已在 Google Play、App Store、F-Droid 與 todorant.com 上線。如果你想自己架設伺服器,自行架設指南只需要一個 compose 檔案。原始碼公開在 GitHub。
寫於 2026 年 11 月 2 日,取材自儲存庫 backmeupplz/todorant(v2.2.12 及更早標籤)、它在 Forgejo 上的發行檔,以及上文引用的各次 commit。