Rayhunter项目在MacOS上的ADB多设备连接问题解决方案

问题背景

Rayhunter是一款用于移动路由器设备的调试工具，在MacOS系统上安装时可能会遇到ADB多设备连接的问题。当用户尝试在MacBook上安装Rayhunter v0.2.5版本时，安装脚本会检测到多个ADB设备，导致安装过程无法正常完成。

问题现象

安装过程中，脚本会不断输出"adb: more than one device/emulator"错误信息。通过adb devices命令检查，可以发现系统上同时存在一个物理设备和一个模拟器设备：

e1959bfc    device
emulator-5562   offline

问题分析

这种情况通常发生在以下场景：

1. 用户确实连接了多个Android设备
2. Android Studio或其他安卓开发工具在后台运行了模拟器
3. 系统环境存在残留的ADB进程或虚拟设备

在MacOS 15测试版系统中，这个问题可能更为常见，因为系统对虚拟设备的支持可能存在兼容性问题。

解决方案

要解决这个问题，可以通过修改安装脚本来指定特定的设备ID：

1. 在install-macos.sh脚本中添加设备选择逻辑：

DEVICE_ID=$(./platform-tools/adb devices | grep 'device$' | awk '{print $1}')
if [[ -z "$DEVICE_ID" ]]; then
    echo "No device found. Exiting."
    exit 1
fi
echo "Using device ID $DEVICE_ID"

adb_cmd() {
    "$ADB" -s "$DEVICE_ID" "$@"
}

2. 在install-common.sh脚本中替换ADB命令调用方式：

_adb_push() {
    adb_cmd push "$(dirname "$0")/$1" "$2"
}
    
_adb_shell() {
    adb_cmd shell "$1"
}

预防措施

为了避免类似问题，建议：

1. 安装前确保没有其他ADB设备连接
2. 关闭可能启动模拟器的开发工具
3. 检查系统进程，确保没有残留的ADB服务
4. 对于MacOS测试版用户，建议等待正式版发布或寻找特定版本的ADB工具

总结

Rayhunter在MacOS上的安装问题多源于ADB设备管理不当。通过修改脚本指定特定设备ID，可以有效解决多设备冲突问题。对于开发者而言，理解ADB设备管理机制有助于更好地处理类似问题。