Skip to content

v1.0.0 (22) — 修复首启闪退(release 包被静默压缩)

Choose a tag to compare

@kjlintong kjlintong released this 09 Oct 01:00
· 54 commits to main since this release

修复:首次打开闪退(release 包被静默压缩导致)

这是优先级最高的一条修复——上一个版本的安装包(build 21)在冷启动时会崩溃。

症状

打开应用直接闪退,第二次打开才正常。曾以为是需要重开一次的小毛病,
实际是 release 包存在致命缺陷,每一个新装用户都会遇到。

根因

release 构建实际处于开启代码压缩的状态,尽管构建脚本里从未写过
minifyEnabled true。R8 把 Gson 的 TypeToken 改名,连同匿名子类的
泛型签名一起吃掉,于是 flutter_local_notifications 在收到
「重启 / 覆盖安装」广播、解析已排期通知时抛出:

IllegalStateException: TypeToken must be created with a type argument:
new TypeToken<...>() {}; When using code shrinkers (ProGuard, R8, ...) make
sure that generic signatures are preserved.
    at FlutterLocalNotificationsPlugin.loadScheduledNotifications
    at ScheduledNotificationBootReceiver.onReceive

该调用发生在 Android 组件入口(BroadcastReceiver),不是 Dart 异常,
因此直接升级为 FATAL EXCEPTION 并 SIG:9 杀掉整个进程——
Flutter 的第一帧都还没画出来。
之所以「第二次打开就好」,是因为触发它的广播是一次性的。

修复

  • build.gradle 中显式钉住 minifyEnabled false,不再依赖工具链默认值
  • proguard-rules.pro 补齐 Gson 泛型签名的 keep 规则
    (即使当前未开启压缩,这组规则也必须留着,防止将来重新踩坑)

验证

真机连环冷启动零崩溃,并取得关键日志:

Displayed  io.github.ltong9463.readnest/.MainActivity: +159ms
Fully drawn io.github.ltong9463.readnest/.MainActivity: +159ms

修复前这两行根本不存在(进程在之前就已被杀)。


同时修掉的另外三处崩溃隐患

  • 数据库迁移重复加列:旧版本(库版本 ≤ 3)直接升级到最新时,
    _onUpgrade 会对同一列 ALTER 两次,SQLite 抛 duplicate column name,
    整段迁移连同版本号一起回滚,结果是覆盖安装后再也打不开应用,
    且版本号没写上、重装也没用。改为先查 PRAGMA table_info 再决定是否加列。
    已补 3 条回归测试,并反向验证过:改回旧写法这条测试确实会变红。
  • 从相册返回后崩溃:选封面时相册是全屏 Activity,旋转屏幕或切后台被回收后
    页面已销毁,await 回来直接 setState 会抛 “setState() called after dispose”。
  • 导入入口缺生命周期保护:add_book_sheet 是六条导入路径的公共入口,
    入口处的 setState 没有检查挂载状态,已统一在入口补上守卫。

其它

  • README 里「AI 报告不发送书名」的说法与实际行为不符,已改为与隐私政策一致
    (确实会发送周期内的书名、作者、分类、状态、评分;笔记正文与划线内容从不发送)。

测试:589 例全部通过(上一版 586 例 + 3 条新增迁移回归测试)。