DiPlay 需要 ADB 吗？基础 CarPlay 与可选 BYD 功能
逐项确认权限
| 功能 | ADB 要求 | 范围 |
|---|---|---|
| 基础 USB／无线 CarPlay | 不要求 | 普通应用权限，以及兼容的车机硬件 |
| 已验证抬头显示 HUD | 不要求运行时启动脚本 | 准确原厂固件／接收服务及地图元数据 |
| 基础仪表地图 | 是否需要取决于具体设置 | 应用可见投影显示及受支持固件 |
| DiLink 5.1 自动主题／卡片跟随 | 受影响固件须一次性 Usage Access 授权 | 使用当前安装包显示的命令 |
| DiLink 5.0 地图流暂停／电池 | 可选车机 ADB | 受支持厂商属性及 Check ADB access |
| 0.2.8 轮速／停车视频 | 可选车机 ADB | 默认关闭；隧道未验证；视频仅 P 挡 |
| 仪表歌曲／歌手／播放状态 | 网络 ADB | 受支持的 BYD 属性；通过 Check ADB access 授权 |
| 中控悬浮地图 | 显示在其他应用上层 | 可通过设置或 ADB 授权；须开启仪表地图 |
| 卡片只在桌面显示 | Usage Access | 缺少时可能覆盖其他应用 |
先完成什么
先连接基础 CarPlay，再开启车辆集成。如果固件要求通过 ADB 才能安装 APK，这是安装限制，而不是 DiPlay 运行要求。
自动地图引导会显示当前安装包的命令。HUD Test 包命令不能直接视为公开版本命令。
公开包命令：adb shell appops set com.shihab.diplay SYSTEM_ALERT_WINDOW allow；adb shell appops set com.shihab.diplay GET_USAGE_STATS allow。测试包使用 com.shihab.diplay.hudtest，执行前核对实际安装包名。
高级功能的限制
可选车机 ADB 使用本机 5555 端口 adbd，需从 Check ADB access 明确触发密钥许可，不支持 TLS 无线调试配对。停车后按需启用。
电池功能需要在识别阶段有数据；连接后数据才就绪时，使用 Check ADB access／Apply and reconnect。轮速数据可发送不代表隧道定位已验证。停车视频需要有效挡位读取，离开 P 挡即关闭。
网络 ADB 电池读取按车辆协议选择 CAN／CANFD。新增保存的桌面地图镜像显示／隐藏开关，不关闭仪表地图（PR #123／#133）。
0.2.10 的变化与复查
可选视频增加进度跳转及前后十秒按钮。需网络 ADB 和有效 P 挡读数；离开 P 挡或读数失效即关闭播放，仍不支持 FairPlay 视频（PR #129）。
上游报告 Linux 529 项测试通过，无失败或跳过；本地运行 528 项测试，有一项 macOS 绑定测试跳过。签名发布构建及 lint 通过，仍有 lint 警告。签名与 0.2.9 一致；本次没有新增实车验证。
0.2.11 的变化与待验证项
位置设置中的“高级车辆数据”保留 DiLink 5.0 默认模式，新增明确选择的旧车机检测。有界只读探测需已授权网络 ADB；仅接受的字段启用对应电池、轮速和驻车视频控件（PR #158／#173）。
可选的车机自带热点自动启动默认关闭。在支持的 BYD 固件上核实 DiPlay 自身包的权限，并保留热点名称和密码（PR #164／#173）。
可选驻车视频仍需有效 P 挡，离开 P 挡或读数失效即关闭。无线车辆／位置数据改由 Wi-Fi iAP2 链路承担；不能证明隧道导航采用轮速（PR #157）。
精确位置权限获准前不报告位置；更改该设置会重连当前会话。车辆控件统一位于位置 → 高级车辆数据，独立 BYD ADB 卡片控制热点启动。旧车机保存字段需接受后才能成为运行读数。
0.2.12 的变化与待验证项
热点启动检查实际 AP 接口，并在 AirPlay 未连接时有限重试。可选热点自动启动仍默认关闭；回退需固件支持的命令、已授权本地 ADB 和实际就绪状态，不能仅以命令执行成功判断（PR #229／#235）。
修正 Apple 设备的 USB 接入匹配。可选无障碍辅助仅确认 DiPlay 自身的系统 USB 授权弹窗，排除其他应用和弹窗；仍需正常 USB 授权（PR #170／#224）。
符合条件的 Android 10 热点／Wi-Fi Direct 会话可选用已授权本地 ADB 暂停客户端扫描。同一局域网模式除外；暂停时无法自动加入已保存网络。恢复标记和重试会恢复扫描，重新打开应用也会恢复；不是普遍的卡顿修复（PR #225）。
虚拟 16:9 地图支持无实体仪表的兼容桌面。实验性 DiLink 3／4 路径加入限定的仪表处理和可重试原厂状态恢复，DiLink 5／5.1 仍优先。未宣称 DiLink 3 风挡 HUD 或已验证的 DiLink 4 HUD 配置（PR #171／#182／#187／#213）。
需复测修复后的 DiLink 3／4 仪表路径、扫描恢复、方向盘模式和固件相关热点启动。普遍卡顿、通话／Siri／麦克风、iOS 15 启动及颜色／主题问题仍需当前设备新证据。
0.2.13 的变化与验证范围
无线优先使用可用 IPv4，以限定接口的 IPv6 回退；自动信道不保证频段或消除卡顿。接口 mDNS 不再依赖未使用的 NSD 服务；握手回退必须已有视频帧。实验性热点加入修复要求 Android 13+、用户配置的纯 5 GHz 热点、受支持 API、已授权本机 ADB，并在断开会话后明确确认（PR #251/#258/#283/#309/#313）。
改进 DiLink 4 原生仪表投屏和画面控制；贡献者确认仅覆盖 2022 海豹／DiLink 4／Android 10。DiLink 3 投屏核对回复并保护恢复；转向卡仍两分钟过期，新增 125% 地图比例及限定电池／方向盘服务恢复。DiLink 3 通话按键和仪表通话卡独立且默认关闭，恢复使用原厂空闲值，并非先前状态快照（PR #243/#260/#265/#285/#296/#297/#304/#306）。
需在目标固件复测 Android 9 P2P、车型专属仪表恢复、热点修复及通话／音频。音乐缓冲仍需实机暂停、跳转、导航、通话和 Siri 检查；贡献者配置不能证明完整签名版已验证。
本页依据公开项目文档及参考社区指南整理，保留实测边界与原始证据。资料快照不代表最新修复状态。