HuaweiPods-ColorOS 1.8.1-coloros.1

HuaweiPods-ColorOS 1.8.1-coloros.1

HuaweiPods-ColorOS 1.8.1-coloros.1 是基于上游 HuaweiPods 1.8.1 的独立定制版本，采用独立应用包名（io.github.artifical0.huaweipods.coloros），专门针对 ColorOS（含 OnePlus / OPPO 平台）深度适配流体云胶囊（Live Alert）、通知交互及系统蓝牙页面集成，并完成了跨进程广播安全校验与状态机稳定性审计。

---

核心更新与亮点

1. 通知直达耳机详情页：纯状态机重构（彻底消除假连接）

• 状态与意图解耦：彻底消除原有点击通知无条件假定 connected 的伪造状态问题，引入全新的 EarphoneDetailNavigationPolicy 状态机。
• 真实蓝牙连接驱动：
  • Case A（正常直达）：已连接或收到蓝牙底层确认时安全平滑直达对应耳机详情页。
  • Case B（已断开旧通知）：点击已离线设备的旧通知时，绝不伪造已连接状态，自动降级至“耳机”Tab 并打开设备选择器。
  • Case C（多设备冲突防护）：通知中设备与当前底层实际连接设备不一致时，严格隔离，不误套状态与电量。
  • Case D（超时保护）：在等待底层蓝牙响应时设置 5 秒超时保护，超时后自动切换至“耳机”Tab 打开设备选择器，杜绝无限卡在假连接或加载中。
  • Case E（异常防御）：空 MAC、非法格式及重复 Intent 具备完善防御策略，保证状态机不崩溃且不污染当前连接。
• UI 交互修复：修复降级与超时路径未正确定位至“耳机”Tab 的问题，确保设备选择器界面可靠展示。

2. 加强跨进程广播来源校验（Action Domain & Fail-Closed）

• Action Domain 信任策略：建立 HuaweiPodsBroadcastTrustPolicy，划分为 APP_CONTROL、BLUETOOTH_STATE、SMART_AUDIO、INTERNAL、SYSTEM 多个安全域，对控制类、状态类与第三方桥接广播实施严格的发送方包名白名单校验。
• 严格 Fail-Closed：未分类或未知 Action 默认直接拒绝，彻底杜绝未授权广播穿透。
• 全链路入口校验：在 HeadsetStateDispatcher 与 HuaweiHfpController.receiver 入口处全面实施发送方校验，拦截恶意第三方应用仿冒控制广播触发的蓝牙连接与参数篡改。
• Android 14+ 身份共享：跨进程发送广播（含 ANC 切换、手势配置、低时延设置、FreeClip 2 音效等）统一使用 sendIdentitySharingBroadcast（通过 BroadcastOptions.setShareIdentityEnabled(true)），确保接收端能精准识别调用方来源。
• 权限安全封装：统一封装 BluetoothDevice.safeDisplayName()，集中消除潜在的 MissingPermission 运行时崩溃风险。

3. ColorOS 流体云与系统通知稳定性优化

• 流体云 Live Alert 优化：修复 ColorOsLiveAlertReceiver 的 PendingIntent 请求码覆盖问题，采用设备 MAC 哈希隔离，确保多设备或通知刷新时跳转意图互不干扰。
• 广播接收安全加固：ColorOS 接收端接入统一广播信任校验，确保只响应受信任的系统蓝牙进程和模块服务。

4. 同步上游 HuaweiPods 1.8.1 完整特性

• 包含上游 1.8.1 对 FreeBuds 系列、FreeClip 系列、SmartAudio 及降噪/均衡器协议的所有改进与新特性。
• 同步官方资源识别、音效预设控制、电量与状态解析逻辑。

5. 独立包名与调试脚本

• 保持独立 Application ID：io.github.artifical0.huaweipods.coloros，可与上游版本独立共存或单独作为定制模块运行。
• 更新一键调试安装脚本 tools/install-huaweipods-debug.ps1，修正 apkanalyzer manifest application-id 官方命令，增加包名不匹配时强制报错防御，完善 LSPosed 作用域配置引导。

---

安装与使用建议

1. 首次安装/覆盖安装：
   • 安装完成后，请进入 LSPosed 勾选并确保勾选了作用域（系统蓝牙 com.android.bluetooth、系统设置 com.android.settings、Android 系统等）。
   • 打开应用，点击“重启作用域”以使 Xposed Hook 生效。
2. ColorOS 流体云胶囊：
   • 请在系统设置中为 HuaweiPods 开启“允许自动启动”、“允许后台活动”，并确保“通知”中的“实时通知 / 流体云”处于开启状态。

1.6.0-coloros.1

HuaweiPods ColorOS 适配版首次公开发布。包名迁移至 io.github.artifical0.huaweipods.coloros，支持 ColorOS 快速设备连接弹窗、我的设备耳机详情入口及 Android 16 流体云电量卡片。