Roam Control最新版

Roam Control 是一款开源的 SwiftUI 应用，专为开发者、QA 工程师及注重隐私的个人用户设计。它允许用户在完全掌控的 iPhone 设备上，通过简洁的 Apple Maps 界面选择、测试和移动报告的位置。该工具支持固定位置、模拟步行路线、收藏管理以及本地开发 VPN 集成，是进行基于位置的软件开发和质量保证的理想伴侣。

核心亮点

• 直观的地图交互：集成 MapKit，支持实时地点搜索、坐标输入或直接点击地图选择目标。
• 灵活的位置模拟：
  • 固定位置：一键启动并维持特定坐标，无需反复重新连接。
  • 步行路线：在开始前预览 Apple Maps 规划的步行路径，支持暂停、恢复、反转或重定向正在进行的模拟。
• 历史与收藏：保存命名收藏夹，快速访问最近使用的位置，提升重复测试效率。
• 安全与隐私：
  • 显式恢复：测试结束后，可手动将位置恢复为真实 GPS 数据。
  • 中断恢复：在会话意外中断后，能安全地恢复之前的状态。
  • 本地配对：配对记录仅存储在 iPhone 钥匙串中，绝不上传云端。
• LocalDevVPN 兼容：遵循独立的引导流程，完美适配 Wi-Fi 和移动数据环境下的本地开发 VPN 会话。
• 无障碍与设计：支持动态字体、VoiceOver、减弱动态效果，并提供自动/浅色/深色外观及标准/卫星/混合地图视图。

安装指南 (公开测试版)

由于苹果的政策限制，Roam Control 不通过 App Store 或 TestFlight 分发。用户需通过侧载方式安装。

前置要求

• 设备：运行 iOS 27 或更新版本的 iPhone。
• 设置：已启用“开发者模式”。
• 依赖：需安装并配置 LocalDevVPN。
• 签名工具：SideStore（推荐）或 Mac 上的 Xcode。

安装步骤

1. 下载 IPA：从 GitHub Release 页面下载与您的设备架构匹配的 IPA 文件。
2. 签名安装：使用 SideStore 和您自己的 Apple ID 对 IPA 进行签名并安装。（注意：免费 Apple ID 仍受每 7 天刷新一次的限制）。
3. 阅读指南：安装前请务必阅读完整的安装指南以解决潜在问题。

首次设置流程

1. 启动应用：打开 Roam Control 并完成四页功能介绍。
2. 发起配对：在应用内点击“配对这台 iPhone”。
3. 系统授权：进入 iOS 设置 → 隐私和安全 → 开发者模式，找到“与 Roam Control 配对”选项。
4. 输入代码：在系统弹窗中输入 Roam Control 显示的六位配对代码。
5. 配置 VPN：安装并连接 LocalDevVPN。
6. 开始测试：选择一个位置或规划一条步行路线，即可开始模拟。

适用场景

• LBS 应用开发：调试地图 SDK、地理围栏触发逻辑或基于位置的服务。
• 游戏 QA 测试：模拟玩家在现实世界中的移动轨迹，测试 AR 游戏或位置相关玩法。
• 隐私保护测试：在不暴露真实行踪的情况下，测试社交应用的定位分享功能。
• 本地开发调试：配合 LocalDevVPN，在内网环境中测试需要特定地理位置的后端服务。