Todorant 原生 Android 应用如何用四天上架 Google Play,并顺带瘦身 4.5 MB
Todorant 的 Android 重写版历经四个版本从测试版上架 Google Play:被删的 Google 登录客户端、R8 导致的扫码登录崩溃,以及把 APK 从 3.3 MB 撑到 7.7 MB 的未授权字体。
本页内容
Todorant 的原生 Android 应用只用四天就从测试构建走到了 Google Play 正式上线(2026 年 10 月 13 日至 16 日),最终发布的安装包是 3.26 MB,而不是 7.74 MB。这一步一共发了四个版本(2.2.0 到 2.2.3),每个版本修掉的都是只有真正打包发布时才会冒出来的问题:一个被删掉的 Google Cloud 项目、一个由 R8 引发的崩溃,以及一套重达 4.5 MB、我本来就无权分发的字体。下面是完整经过和对应的提交记录。
2026 年 10 月之前的 Android 版 Todorant 是怎样的?
Todorant 是一款一次只显示一个任务的待办管理工具,而且在继续之前,它会要求你把所有过期任务重新安排一遍。Google Play 上原先那个 Android 应用是旧的 React Native 版本。10 月我把它换成了一个原生的 Kotlin 与 Jetpack Compose 应用,通过全新的 /v2 后端和单条 WebSocket 同步数据。10 月 13 日的 2.0.0 版本是它的首个构建,当时还只是测试版:Android 拒绝用不同签名密钥覆盖安装更新,所以从旧 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 会重新给你的应用签名,因此登录配置必须同时知道两套指纹,否则测试包里一切正常,从商店安装的每一个用户却都会失败。
同一个版本还移除了 Google Calendar 同步。它早就失效了,原先放这个开关的“集成”界面也一并撤掉了。
R8 在 2.2.2 里弄坏了什么?
Google Play 的发布前测试报告在测试设备上跑了一遍 2.2.1,结果发现一扫描二维码应用就会直接闪退。扫码登录是你扫描网页版上的二维码在新设备上登录的方式,这可不是什么冷门角落。
祸首是完整模式下的 R8。ML Kit 的条码扫描器通过反射实例化若干 registrar 类来查找内部组件,用的是它们的无参构造函数。R8 看到代码里没有任何地方直接调用这些构造函数,就把它们删掉了。随后 ComponentDiscovery 无法创建这些 registrar,其中一个共享偏好设置组件从未被注册,GmsBarcodeScanning.getClient() 于是抛出了 NullPointerException。10 月 15 日合入的 2.2.2 修复,只是在 proguard-rules.pro 里加了几行规则,把这些构造函数保留下来。这种 bug 在 debug 构建里永远看不到,这也是为什么每次推向正式版之前都应该跑一遍发布前测试报告,而不是只跑一次。
APK 是如何在 2.2.3 瘦身 4.5 MB 的?
Android 应用之前复用了 iOS 应用的排版字体,也就是六个文件组成的 Apple SF Pro。SF Pro 的许可仅限于 Apple 平台,本来就不该出现在 Android 构建里。它体积也很大:删除它的那次提交记录显示它占了安装包 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 日)把应用拆成了两个构建变体。play 变体保留了 Google 登录和 Google 的扫码器。fdroid 变体完全不含任何 Google 代码:它用开源的 ZXing 库扫描二维码(需要相机权限),并且没有 Google 登录按钮。你仍然可以通过邮箱加密码、Apple、Telegram 或二维码登录。F-Droid 还会拒绝 Gradle 往 APK 里写入的依赖信息块,所以发布构建把它去掉了;现在每次发布新版本时,CI 都会用上传密钥同时构建两个变体并附上两个文件,方便 F-Droid 将自己的构建与我们的进行校验。F-Droid 版 APK 比 Play 版还要小大约 490 KB。
那 28 项权限后来怎么了?
10 月 17 日,2.2.6 版本清掉了一大堆 Todorant 从没用过的权限。一个用来显示启动器角标的库 ShortcutBadger,为它知道的每一家桌面厂商都声明了一项权限;Credential Manager 又为通行密钥加了两项生物识别权限。清单合并器把它们一股脑全塞进了应用里。我翻看那次提交的 diff,数出其中有 22 行用来移除这些权限的 tools:node="remove",连 VIBRATE 也一并删掉了,因为滑动反馈现在改用 Compose 的触感反馈,不需要任何权限。提交说明里记录应用权限从之前的 28 项降到了 5 项:网络访问、网络状态、开机广播接收器、用于计划提醒的通知权限(只有当你设定提醒时间时才会申请),以及仅限 F-Droid 版本的相机权限。发布说明写得很直白:Todorant 现在只申请它真正用到的权限。
我没有自己重新构建去读合并后的清单,所以 28 和 5 是提交记录里的数字,22 则是我自己对着 diff 数出来的移除行数。
第一批真实用户发现了什么?
两件事,而且都是我的锅。10 月 16 日我修了大账号首次登录的问题。全新登录会拉取整个账号,而应用里四个地方各自发起了一次完整下载,于是包含 40,000 条待办的测试账号被同时拉了两三遍,直接内存溢出。服务器的心跳响应排在那次下载后面,客户端 15 秒一次的 ping 把连接断开了,30 秒的同步超时也把下载耗时算了进去。在此期间,应用界面上只显示一个“设置”标签页。修复方式是让游标相同的拉取请求合并到正在进行的请求里,给同步 30 秒连接时间和 120 秒响应时间,并把 ping 间隔拉长到 60 秒。10 月 23 日的 2.2.7 版本又找回了大家在旧应用里仅保存在本机的任务——之前的更新曾把它们隐藏起来了。
下一次我依然会这么做的几件事
- 每一个准备推向正式环境的构建,都跑一遍 Play 的发布前测试报告。它帮我抓住了唯一一个真正要命的崩溃。
- 从其他平台搬过来的每一样资源,都检查一遍许可协议。一个比应有体积大出一倍的 APK,本身就是足够充分的排查理由。
- 从第一天起就为 Play 签名密钥备好第二个 Google 登录客户端。
- 把合并后的清单里出现的每一项权限,都当成你必须能解释清楚的东西来对待。
Todorant 现已上架 Google Play、App Store、F-Droid 以及 todorant.com。如果你更愿意运行自己的服务器,跟着自行部署指南只需一个 compose 文件即可搞定。源代码托管在 GitHub。
写于 2026 年 11 月 2 日,依据仓库 backmeupplz/todorant(v2.2.12 及更早标签)、其在 Forgejo 上的发布文件以及上文引用的各次提交。