Roam（漫游）是一款 macOS 原生的 Android 真机定位模拟工具。在 Mac 上画路线、选运动模式，通过 USB + ADB 将连续变化的 GPS 坐标注入 Android 真机。
系统要求是什么？
macOS 15+（Apple Silicon），屏幕分辨率 ≥ 1280×800。Android 真机需要 Android 10–16 并开启 USB 调试。Mac 上需要安装 adb 工具（brew install android-platform-tools）。
如何安装？
打开下载的安装包，将 Roam 拖入「应用程序」文件夹。首次打开时若出现安全提示，在「系统设置 → 隐私与安全性」中允许即可。
手机连不上怎么办？
- 确认 USB 数据线支持数据传输（非仅充电线）
- 确认手机「开发者选项」中「USB 调试」已开启
- 重新插拔 USB 线，在手机上勾选「始终允许」后确认
- 在终端运行
adb devices确认设备状态为device - 打开「诊断」面板（⌘D）查看 ADB 和 USB 的健康状态
Companion 安装失败？
检查手机上是否已安装旧版 Companion 且签名冲突。先在手机上卸载旧版 Companion，再通过 Roam 重新安装。如果仍有问题，确认手机「开发者选项」中「通过 USB 安装应用」已开启。
位置模拟不生效？
- 确认手机「开发者选项」→「选择模拟位置信息应用」已设为 Roam Companion
- 确认没有其他应用同时占用 Mock Location Provider
- 打开诊断面板（⌘D）查看「Mock Location」检查项状态
- 确认 Playback 检查项为绿色（可启动）
USB 断连后手机位置会怎样？
手机端心跳超时（默认 5 秒）后会自动清除 Mock Location Provider，恢复手机真实 GPS。Mac 端 PlaybackBar 会变黄提示。你可以在「设置 → 断连宽限时间」中调整超时（1–15 秒）。
地图搜索没结果？
Roam 使用 Apple MapKit 进行地图搜索，需要 Mac 有网络连接（仅地图功能需要）。确认 Mac 已联网且地图服务未被系统限制。
路线规划不是沿着道路？
Roam 会优先尝试道路规划（Apple MKDirections）。如果道路规划失败（如两个点之间没有可驾车道路），会自动回退为直线连接。你可以在途经点之间增加中间点来帮助路线规划。
模拟速度和实际播放速度不一致？
模拟速度受手机端 Companion 的处理能力影响。低端设备在高频率更新时可能出现延迟。系统负载较高时，1 Hz 播放间隙可能略微延长。这是手机端的性能限制，不是 Roam 的缺陷。
被测 App 知道我在模拟位置吗？
是的。Roam 走 Android 官方 Mock Location API，Location 对象的 isMock 标记为 true。如果被测应用检测此标记并拒绝服务，这是被测应用的预期行为。
支持哪些 Android 机型？
支持 Android 10 及以上、支持 Google Mock Location API 的机型。部分国产 ROM（如鸿蒙）可能在 Mock Location 实现上有差异，需逐机型实测。
会出 Windows 版吗？
目前 Roam 仅支持 macOS。Windows 版本在远期规划中，暂未排期。
联系方式
遇到其他问题，欢迎邮件联系 selfren@163.com。反馈时请附上：
- Roam 版本号（关于页面）
- macOS 版本
- Android 设备型号与系统版本
- 诊断面板的复制内容（⌘D 然后点击「复制诊断」）
- 问题复现步骤