Skip to content

4.0.1(41)向前兼容补丁:HyperOS 5/6 不再被识别成「未提取到版本号」

Choose a tag to compare

@wumisc wumisc released this 10 Nov 14:42

4.0.1(41):向前兼容补丁

一句话:4.0 的 HyperOS 3 适配不影响 HyperOS 4,也不会因为 HyperOS 5 出现而复发。

这次修的是什么

你去问「会不会影响 HyperOS 4」的时候,我把识别层重新查了一遍,发现一个真实短板:

正则写死 [34],遇到 ro.mi.os.version.name = HyperOS 5.0 会一个版本号都匹配不到,
只能掉进 SDK_INT >= 36 → HOS4 的兜底。结果碰巧对,但日志会写成
「未从 prop 提取到 3/4」——排查的人会以为 prop 读坏了。

项 4.0 4.0.1
识别范围 [34] 写死 3 ~ 6,HyperOS 5/6 直接读出
major >= 4 只处理 == 4 统一并入 HOS4 分支(策略同构,不新增枚举)
用户文案 「HyperOS 4」 「HyperOS 4 及更新版本」
误读防护 有 (?![0-9]) 追加单测锁死 V816 / V35 / V9 / V12
单测 6 条 +8 条(HyperOsVersionParseTest),累计 112/112

为什么"不影响 HyperOS 4"不是口头保证

三个真正影响功能的策略(前台服务类型、手电、悬浮窗权限)全部与 ROM 版本无关:

fun foregroundServiceStrategy(os: Os): String = FGS_CHAIN   // "camera→specialUse→none"
fun torchOpenStrategy(os: Os): String = "inSession"
fun overlayPermissionStrategy(os: Os): String = "verifyBeforeShow"

os 参数一次都没被读。真正的决策在 WalkPreviewService.goForeground():
逐档 startForeground(),哪一档不抛异常就用哪一档。由系统当时的反应决定,不由版本号决定。

版本识别的结论只流向四处文案(首页摘要、能不能用的一句话、保活提示、root 注意事项)。
识别错了,最坏结果是首页写错一行字,功能一行代码都不会变。

关于 targetSdk 停在 35

这是刻意的。Android 16(HyperOS 4 基座)的破坏性变更——edge-to-edge 强制、
大屏忽略方向锁定、预测性返回默认开启、JobScheduler 配额——绝大多数是
targetSdk 36+ 才生效。停在 35,它们在 HyperOS 4 上不会作用到本应用。

compileSdk 是 37,所以编译期能看到最新 API,运行期仍按 35 的规则走。

完整的 Android 16 × SafeWalk 影响矩阵、以及"什么条件下才需要改代码":
docs/hos4-impact.md

已知边界

没有 HyperOS 4 真机,以上结论来自代码路径 + 清单 + 单测,不是实机跑出来的。
真遇到厂商额外拦截时,日志里会写清是哪一档被拒([FGS] 前缀)——这正是 4.0
把决策放在运行时、而不是放在版本号上的原因。

校验

  • versionCode 41 / versionName 4.0.1 / targetSdk 35(apkanalyzer 实测)
  • 单测 112/112,BUILD SUCCESSFUL
  • 功能零改动,只是识别层 + 文档

完整安装包: SafeWalk-v4.0.1.apk(43 MB,debug 签名,与 4.0 一致)