# Todorant 原生 Android App 如何用四天登上 Google Play，並順手減掉 4.5 MB

> Todorant 的 Android 重寫版歷經四個版本從測試版登上 Google Play：被刪除的 Google 登入用戶端、R8 導致的 QR 碼登入閃退，以及讓 APK 從 3.3 MB 暴增到 7.7 MB 的未授權字體。

Published 2026年11月2日 on Todorant 筆記: https://blog.todorant.com/zh-hant/todorant-android-google-play-four-days/

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 版本](https://github.com/backmeupplz/todorant/releases)是它的第一個建置，而且當時只是測試版：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 裡只存在裝置本機的任務——之前的更新不小心把它們藏起來了。

## 下次我還是會照樣做的事

1. 每一個要推向正式環境的建置，都跑一遍 Play 的發布前測試報告。它抓到了唯一那個真正要命的閃退。
2. 檢查從其他平台搬過來的每一份資產授權。一個比應有大小胖了一倍的 APK，本身就是查下去的好理由。
3. 從第一天起，就替 Play 簽署金鑰準備好第二組 Google 登入用戶端。
4. 把合併後資訊清單裡的每一個權限，都當成你必須解釋得出來由的東西。

Todorant 現已在 [Google Play](https://play.google.com/store/apps/details?id=com.todorant)、[App Store](https://apps.apple.com/app/todorant/id1482078243)、F-Droid 與 [todorant.com](https://todorant.com/zh-hant/) 上線。如果你想自己架設伺服器，[自行架設指南](https://github.com/backmeupplz/todorant/blob/main/docs/self-hosting.md)只需要一個 compose 檔案。原始碼公開在 [GitHub](https://github.com/backmeupplz/todorant)。

*寫於 2026 年 11 月 2 日，取材自儲存庫 `backmeupplz/todorant`（v2.2.12 及更早標籤）、它在 Forgejo 上的發行檔，以及上文引用的各次 commit。*

