Repository navigation
Releases
PodTide 0.4.2
⭐ 下载前请先点亮 Star
💡 下载说明：点击上方绿色按钮 → 授权验证你已为本仓库点亮右上角 ⭐ Star → 即可自动获取
PodTide-0.4.2.apk安装包（您也可以直接在下方 Assets 中下载PodTide-0.4.2.apk）。
0.4.2 版本更新说明
- 补齐 AirPods 5 / 4（含无线充电盒版）完整功能配置：为
AirPods (Gen 5)与AirPods (Gen 5 Wireless Case)补全单耳降噪开关、个性化音量、提示音音量、按压挂断/静音麦克风、麦克风模式、入耳检测开关、耳机柄按压自定义与睡眠检测等全部 H2 特性配置。 - 支持 AirPods Pro 2（Lightning 与 USB-C）及 AirPods 5/4 同系型号互通识别：将
AirPods Pro 2与AirPods Pro 2 USB-C纳入同系互通模型组，即使耳机尚未初始化 IRK 密钥、或用户在选型时选了同系列的另一充电盒版本，BLE 广播也能直接匹配并在建立 AAP 连接后自动修正具体子型号。 - 新增加密 L2CAP Socket 回退机制：当部分手机系统蓝牙栈拒绝未加密的
createInsecureL2capSocket连接时，自动回退尝试认证/加密 L2CAP 通道，提升 AAP 控制连接成功率。 - 优化耳机设置页自动化响应卡片展示：已绑定并选定配对设备后，耳机设置页始终展示入耳检测、对话感知、充电盒开盖响应等本地配置项，不再因 AAP 握手未就绪而隐藏整张卡片。
- 使用提示更新：建议全新或刚恢复出厂设置的 AirPods 先与 Apple 设备（iPhone / iPad / Mac）连接配对一次以激活初始化广播密钥（IRK / ENC），再配合 PodTide 使用可获得最完整的加密电量解析与自动型号校准体验。
SHA-256 (PodTide-0.4.2.apk): 66a6974d3081990332a0a74af7bd842924a9e762db6626ab335d2230cb1c4f9e
PodTide 0.4.1
📥 下载安装包
💡 下载说明：开源维护不易，安装包已启用 Star 解锁机制。请先在仓库主页右上角点亮 ⭐ Star，再点击上方绿色按钮进入下载页面即可自动下载 APK！
✨ 0.4.1 版本更新说明
- 荣耀（MagicOS）/ 华为系统深度兼容优化：开放 Android 12+ 位置权限声明并在荣耀／华为机型自动引导授权，解决系统底层将 Apple Continuity 广播视为信标拦截且设置中无法开启位置权限的问题（OPPO、小米、vivo 等其他 Android 12+ 机型仍仅需附近设备权限，不受影响）。
- 蓝牙已连接设备识别与扫描兼容增强：新增已绑定设备 MAC 地址白名单兜底，防止部分定制系统蓝牙栈未上报 Apple 私有特征 UUID 时漏识别已连接耳机；在荣耀／华为机型默认关闭 BLE 硬件卸载过滤与批处理以确保实时回调。
- L2CAP 隐藏 API 豁免容错增强：对
HiddenApiBypass预豁免阶段的Executable.artMethod反射校验增加安全兜底，提升严格 ROM 上的控制通道建连稳定性。 - 双耳续航预测优化：修复满电或高电量下左右耳预计可用时间偏差过大的问题，收紧单耳历史高功耗异常上限并加入高电量双耳协同收敛。
- 后台常驻通知静默开关：在「设置 → 常规」中新增「显示后台常驻通知」开关，关闭后常驻通知自动转入静默折叠状态，不在状态栏显示图标。
- 睡眠监测防误触：增加双耳佩戴校验与多阶段滑动时间窗口确认，避免静坐、看书时偶发误暂停音乐。
SHA-256 (PodTide-0.4.1.apk): a9e39e4780556921ee59f391d8cabb831d2a38cfe46ecb7712152aad651fa5e4
PodTide 0.4.0
📥 官方安装包下载（Star 解锁通道）
为支持开源持续维护，PodTide 安装包已统一启用 Star 解锁机制：
👉 【点击前往专属通道 · Star 免费下载 APK】
(使用 GitHub 登录并点亮 Star 即可立即解锁直链下载)
PodTide 0.4.0
头部姿态与手势优化
- 入口与后台监测修复：修复设备设置中“头部姿态与手势测试”入口图标对齐与导航跳转问题，恢复
MonitorService对头部手势流的后台订阅，并消除每帧 IPC 查询导致的姿态预览卡顿。 - 自动回中校准（消除陀螺仪漂移）：新增静止微稳状态下的自适应零点漂移补偿（Auto-Zeroing），无论在测试页还是后台运行，完成动作停顿后零点都会平滑回中。
- 单向习惯性点头判定：仅记录“从上到下低头再回抬”的点头动作（俯仰下压
>= 6.0°、回程>= 3.2°），忽略单纯从下往上仰头的动作。 - 双向完整摇头判定：摇头检测改为双向往复轨迹（中 → 一侧
>= 5.0°→ 反向跨越至另一侧>= 8.0°→ 回中>= 3.2°），避免单侧转头误触发。 - 连续两次手势音乐控制与提示音反馈：日常无通话状态下的音乐控制改为 3 秒内连续两次点头或摇头 触发；完成第 1 次动作时播放轻柔提示音，完成第 2 次动作时播放双音确认并执行媒体控制（修复
KEYCODE_MEDIA_NEXT抬起事件时间戳以确保切歌稳定）。
安装与升级
- 补齐
v1 (JAR META-INF) + v2 + v3全套签名，保持相同 debug 签名与applicationId（io.github.podbridge.companion），可直接覆盖安装旧版本。 - 最低 Android 8.0（minSdk 26），目标 Android 16（targetSdk 36）。
PodTide-0.4.0.apkSHA-256：d89e992e47584df79762fac8d92ad95944675779de8b68aad7dcad1b340c0d8b
PodTide 0.3.6
📥 官方安装包下载（Star 解锁通道）
为支持开源持续维护，PodTide 安装包已统一启用 Star 解锁机制：
👉 【点击前往专属通道 · Star 免费下载 APK】
(使用 GitHub 登录并点亮 Star 即可立即解锁直链下载)
PodTide 0.3.6
标准系列连接
- 修复“系统蓝牙连着听歌正常、PodTide 约 30 秒后失联”：BLE 扫描不再在系统音频连接后立即停止，只有 AAP 控制通道就绪（READY）才停扫；AAP 掉线会自动恢复扫描。
- AAP 重连退避改为 2 s → 5 s 循环（原 5/15/30/60 s），控制通道断流后更快恢复。
AirPods (Gen 5)与AirPods (Gen 5 Wireless Case)视为同一身份，避免“已配对卡片离线 + 底部陌生设备”的分裂。- 连接后先显示「耳机已连接 · 高级控制恢复中」，20 秒仍无数据才升级为故障排查卡。
设置与外观
- 修复「系统后台唤醒（实验）→ 关联」报
Must declare uses-feature android.software.companion_device_setup：已补该特性声明（required=false）。 - 设备设置页只保留一个均衡器卡片（移除 debug-only 的 PME 8 柱图，之前窄屏挤压成方块）。
- 「优化充电上限」说明显示
80%，不再出现80%%。 - 非 Pro 机型卡片不再把 24dp 线性图标拉伸成横幅，改为 52dp 紧凑图标（专属高清图仍缺素材）。
安装
- debug 签名，
applicationId未变，可覆盖安装 0.3.4 及更早版本 - 最低 Android 8.0（minSdk 26），目标 Android 16（targetSdk 36）
- SHA-256：
14cf1221ac469235dba90c9fbff335bee73b32e1be62e10b93f51f56389520f9
已知限制
- Gen 5 没有可信的硬件号段映射（不编造）；AAP 上报未映射号码时只记录日志。
- 8 频段可编辑均衡器未实现：AAP
0x63只有三段（低/中/高），0x53是助听器 PME 诊断数据。 - 本版未在真机验证；Gen 5 的 AAP 握手是否可用仍需日志确认。
PodTide 0.3.4
📥 官方安装包下载（Star 解锁通道）
为支持开源持续维护，PodTide 安装包已统一启用 Star 解锁机制：
👉 【点击前往专属通道 · Star 免费下载 APK】
(使用 GitHub 登录并点亮 Star 即可立即解锁直链下载)
PodTide 0.3.4
本次更新
- 修复合盖静置误弹窗：耳机长时间合盖放在充电盒里、保持断开时偶尔会突然弹出电量弹窗。原因是自动连接会对盒内偶发广播发起连接请求，部分蓝牙栈把它短暂上报为“已连接”，而连接弹窗信任陈旧数据。现在引入“密封盒”判定：盖合且两只耳机都在盒内时不弹窗，也不发起连接请求。
- 重连节奏去掉 15 秒档：自动连接重试间隔由 2 s → 5 s → 15 s 循环改为 2 s → 5 s 循环，仍在持续广播但尚未连上的耳机能在几秒内被重试。
自 0.3.0 起累计包含
- 耳机状态弹窗总开关、弹窗轮次去重与持久化、开盖唤醒扫描、后台监测开关
- CompanionDeviceManager 系统级唤醒（进程被杀后仍可被耳机出现唤醒；需 Android 13+ 并手动关联设备）
- 多型号兼容修复：身份匹配原因日志、IRK 去重、AAP 阶段区分、型号美术映射
- 弹窗判定日志：tag
CAP:Reaction:PopUp，便于反馈问题时定位
安装
- debug 签名，
applicationId未变，可直接覆盖安装旧版本 - 最低 Android 8.0（minSdk 26），目标 Android 16（targetSdk 36）
- SHA-256：
3698c8aa70b6184565026bbeaded9cd3eef2ae4b126223478e6bd0ab37bc5047
已知限制
- CDM 系统级唤醒未在真机验证，部分厂商 ROM 可能延迟或拦截
- Gen4 / Gen5 / Pro 3 等型号尚无专属美术，使用近似图
- AAP 长时间后台握手失败的协议根因未定位（握手超时仍为 10 s）
PodTide 0.3.0
📥 官方安装包下载（Star 解锁通道）
为支持开源持续维护，PodTide 安装包已统一启用 Star 解锁机制：
👉 【点击前往专属通道 · Star 免费下载 APK】
(使用 GitHub 登录并点亮 Star 即可立即解锁直链下载)
主要更新：心率监测
- 在耳机设置中进入 AirPods Pro 3 心率页面，查看实时读数、本机历史曲线、平均值和最高值。
- 进入页面时开始测量，离开页面或应用进入后台后停止请求。历史数据仅保存在本机。
- 调整连接弹窗策略并更新设备管理页面图案。
兼容性和使用说明
- 首台测试机 OPPO Find X9 / ColorOS 配合 AirPods Pro 3 已在 dev13 读到心率。曲线界面和本次构建尚未完成真机验收，心率准确性、长期稳定性及其他设备兼容性仍需验证。
- 请授予附近设备、蓝牙和通知等所需权限，并根据手机系统设置允许后台活动。
- 原生“查找”位置、盒子响铃、UWB 精确寻找及双设备同时连接尚未实现。
- 此 APK 为 debug 签名测试包，应用版本为 0.3.0；签名与此前测试包一致，可覆盖同包名、同签名的旧版本。
基于 CAPod，参考 LibrePods；以 GPL-3.0 发布，详见仓库许可证及第三方声明。
PodTide 0.2.0
📥 官方安装包下载（Star 解锁通道）
为支持开源持续维护，PodTide 安装包已统一启用 Star 解锁机制：
👉 【点击前往专属通道 · Star 免费下载 APK】
(使用 GitHub 登录并点亮 Star 即可立即解锁直链下载)
重要：后台运行设置
- 授予附近设备、通知及所需蓝牙权限，并允许 PodTide 在后台运行，检查电池优化限制。
- 如果系统提供最近任务锁定，请锁定 PodTide 的任务卡片，降低被系统清理的可能性。以 OPPO / ColorOS 为例，可在应用详情 → 耗电管理中选择“完全允许后台行为”。不同品牌路径和效果可能不同。
- 当前为测试版；首次测试设备为 OPPO Find X9 / ColorOS，其他设备的兼容性仍需验证。
0.2.0 版本更新说明
- 重新设计 PodTide 首页与设置页，加入独立的左右耳电量卡片和分组式设置入口。
- 更新图标：交叉耳机线条与潮汐波纹；调整弹窗耳机方向、充电标识和续航文字布局。
- 移除开源版的 Pro 升级提示，现有功能免费使用。
- 已连接配置的耳机时暂停蓝牙扫描，断开后恢复；电量实时通知仍为可选。
- 优化连接弹窗和入口动画；此前重连后降噪切换问题通过清理旧控制会话并重新建立通道处理。
已知问题与兼容性
- 已连接时仍可能偶发重复弹窗；部分设备开启顶部状态弹窗后可能影响连接，遇到问题请关闭该选项。
- 心率、头部姿态、原生定位和双设备同时连接尚未在本测试版中完成。
- 本应用按免 Root 方式实现，OPPO Find X9 已进行免 Root 测试；其他 Android 系统的兼容性需要进一步验证。没有经过验证的 Root 模式。
- 此发行版沿用此前的 dev12 APK，应用内部版本号仍显示 0.1.0-dev12；其与 dev11 签名一致，可覆盖安装。本版本尚未完成新一轮真机验证。
开源致谢
PodBridge v0.1.0
📥 官方安装包下载（Star 解锁通道）
为支持开源持续维护，PodTide 安装包已统一启用 Star 解锁机制：
👉 【点击前往专属通道 · Star 免费下载 APK】
(使用 GitHub 登录并点亮 Star 即可立即解锁直链下载)
PodBridge v0.1.0 — 首个公开版本
面向 Android 8.0 及以上设备的开源 AirPods 伴侣应用。首台测试设备为 OPPO Find X9 / ColorOS，耳机为 AirPods Pro 3；欢迎其他 Android 设备用户反馈兼容性。
请先检查后台活动权限： 在手机系统的应用详情和电池管理中允许 PodBridge 后台运行。各厂商路径不同；OPPO / ColorOS 示例为“系统应用详情 → 耗电管理 → 完全允许后台行为”。允许该项后，用户确认 dev7 在后台等待至少30秒后开盖可自动连接，弹窗动画也正常。
提供耳机电量与状态、自动连接条件、降噪／通透控制、底部与可选顶部弹窗、电量小组件及 Apple 官方查找网页入口。通知栏实时电量可选，默认关闭以减少通知刷新，后台监测服务仍会显示必要通知。
本版隐藏尚未完成的心率、头部姿态及手势入口，源码已保留。原生 Find My 和真正的双设备同时连接将继续研究。通透／降噪在首台测试机上经历普通连接和同一副耳机重连两轮测试均正常；本发布构建及其他设备仍欢迎实测反馈。
下载下方 APK，在手机上安装；从同签名 PodBridge 开发版升级时可覆盖安装。源码及第三方许可见仓库首页。
关键问题与处理
- 后台通知仍在但开盖不重连：首台测试机的系统限制会冻结后台执行，允许全部后台活动后恢复；其他品牌需检查相应的电池管理设置。
- 耳机重连后聆听模式切换失败：清理旧控制会话并在重连后重新初始化；同一副耳机重连后的切换已在 dev7 实测正常。
- 弹窗动画过快：调整入场和退场时序，dev7 已由用户确认表现正常。
开源参考
基于 CAPod，并参考 LibrePods 的协议与功能实现；版权及许可证详见仓库的第三方声明。
验证说明： 电量通知开关已完成实现，新增的完整自动化测试尚未跑完；此正式 APK 尚未在其他 Android 机型上完成实机验证。欢迎反馈问题。