Repository navigation
4.0.1(41)向前兼容补丁:HyperOS 5/6 不再被识别成「未提取到版本号」
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 一致)