Repository navigation
SafeWalk v4.0 稳定版 · 支持 HyperOS 3 / 4
4.0 稳定版 · HyperOS 3 / HyperOS 4 双版本适配
这是第一个真正按运行时结果适配的版本。之前的 3.3~3.5 里有一张很完整的兼容表
(HOS3 用 specialUse、HOS4 用 plain、手电 releasePreviewFirst、悬浮窗 strict),
但那些值只出现在日志里,startForeground 一直硬编码 CAMERA —— 等于展示了方案、没落地。
4.0 把它改成了真正执行的链路。
HyperOS 3:标准路径,无需绕行
| 系统基座 | targetSdk | 实际路径 | |
|---|---|---|---|
| HyperOS 3 | Android 15 | 35(与本机一致) | camera 前台服务 / 常显小窗 / 悬浮窗,一次降级都不会触发 |
| HyperOS 4 | Android 16 | 35(低一档) | 同上,但 camera 被拒时自动降级到 specialUse |
先给结论:HyperOS 3 是本项目最不需要特殊照顾的版本。本应用 targetSdk 35,
在 HOS3(Android 15)上 targetSdk 与系统版本一致,行为完全标准;HOS4(Android 16)
因为 targetSdk 低一档、加上厂商对 camera 型前台服务拦截更积极,才需要降级链。
降级链(不猜版本,只看结果)
startForeground(CAMERA) ← 后台能用相机的唯一合法类型
↓ 被拒(ForegroundServiceStartNotAllowedException)
startForeground(SPECIAL_USE) ← 不带相机语义,但保住进程与悬浮窗
↓ 仍被拒
startForeground(无 type)
判定依据只有「上一次调用有没有抛异常」。好处:HOS3 上第一档就过、不进降级分支;
HOS5 换了限制也不用改代码。降级时会弹一次通知说明「后台相机被限制,建议加电池白名单」。
其他 HyperOS 相关修复
- 悬浮窗权限复核:每次显示前真的查
Settings.canDrawOverlays()。HOS 在系统升级、
一键清理后会悄悄回收这个权限,以前的表现是「走起来没反应」——因为addView抛的
BadTokenException被外层吞掉了。现在会拦下并通知去重新授权。 - 补
FOREGROUND_SERVICE_SPECIAL_USE权限:lint 抓到的真缺陷。只声明
foregroundServiceType="specialUse"而不声明这条权限,运行时startForeground(..., SPECIAL_USE)直接抛SecurityException—— 降级链会在最需要它的那一刻断掉。 - 手电策略:明确为
inSession。3.2 起灯就开在预览会话内(FLASH_MODE_TORCH),
releasePreviewFirst描述的那一步已不存在。
导航栏:浅色毛边终于修对
3.5 只调了描边颜色,深色立刻变好、浅色几乎没变。因为根因判断错了:
毛边不是"圆角没设好",而是 AGSL 直接栅格化、圆角处不做覆盖率采样,边界上输出一条
宽 1~2dp 的半透明带。深色底上暗+暗看不见,浅色底上就是一圈灰箍。3.5 的白描边画在形状
内侧、且浅色下与背景同色,盖不住它。
4.0 改为 graphicsLayer(shape = TabsShape, clip = true):让 RenderNode 按同一个圆角做
硬件 outline 裁剪(自带抗锯齿),把那条半透明带连同外溢的模糊采样一起切掉。
配套:浅色 blur 8→6dp,描边降为白 0.55→0.10(只留边光,不成白框)。
已知代价:按住导航栏时的 +5% 膨胀会被裁掉,只剩高亮与透镜。
验证
assembleDebugBUILD SUCCESSFUL;单测 104/104(新增HyperOsCompatStrategyTest6 条
防回归:camera 必须排第一、HOS3/HOS4 必须共用同一条链、文案里不许出现内部代号、
不许写"完美支持")lintDebug0 error- 清单实测
foregroundServiceType=0x40000040(camera | specialUse) versionCode 40 / versionName 4.0
关于「HyperOS 3 到底能不能用」的边界
我没有 HyperOS 3 真机,上面的结论来自代码路径分析 + 清单校验 + 单元测试,不是真机跑通。
因此这份说明不写"完美支持 / 100% 兼容",只说清三件事:走的是标准路径;任何一次被系统
拒绝都会降级而不是崩溃;日志 [FGS] 会写明哪一档被拒、为什么。
如果你在 HOS3 上遇到问题,开行走模式走 10 步,把 diag.log 发到 issue 即可。