GPX轨迹生成器教程

在真实地图上画出基础曲线，生成带时间戳的 GPX 运动轨迹，再导出给支持 GPX 的开发工具使用。

基本流程

1. 在右侧地图搜索或拖动到需要绘制轨迹的位置。
2. 切换到轨迹编辑模式，点击地图添加锚点，至少 3 个锚点形成闭环。
3. 拖动黄色锚点调整路线位置，拖动控制柄调整弯道形状。
4. 设置圈数和偏移范围后，点击生成轨迹。
5. 确认黄色生成轨迹符合预期后，点击导出 GPX。

圈数

1. 圈数表示导出的轨迹围绕路线重复几圈。
2. 例如圈数为 4 时，GPX 会包含 4 圈连续轨迹。
3. 圈数越多，导出的点位和总运动时间也会增加。

GPX时间档位

1. GPX时间档位控制导出文件内部的时间戳密度。
2. 默认 1 分钟档适合当前版本的基础测试节奏。
3. 不同读取端处理 GPX 的方式可能不同，实际播放时间可能有差异。

偏移范围

1. 单圈偏移控制每一圈内部轨迹的轻微摆动程度。
2. 多圈偏移控制不同圈之间的整体分散程度。
3. 数值越小越贴近原始曲线，数值越大变化越明显。

控制柄与地图模式

1. 独立：入口控制柄和出口控制柄互不影响。
2. 镜像：两侧控制柄保持相反方向和相同长度。
3. 对称：同步方向，但保留另一侧原有长度。
4. 地图定位模式用于移动、缩放和搜索地图。
5. 轨迹编辑模式用于添加、拖动和删除锚点。

Xcode使用教程

用于开发调试时通过 Xcode 的 Simulate Location 读取 GPX 轨迹；不要用于绕过第三方 App 规则。

安装 Xcode

1. 打开 Mac App Store，搜索 Xcode，点击获取并安装。
2. 第一次打开 Xcode 时，按提示安装额外组件。
3. 打开 Xcode 设置，进入 Accounts，登录 Apple ID。

准备 iPhone

1. 用 USB 连接 iPhone 和 Mac，iPhone 上点击信任此电脑。
2. 在 iPhone 设置中打开隐私与安全性，进入开发者模式并开启。
3. 按系统提示重启 iPhone，重启后再次确认开启开发者模式。

创建调试项目

1. 在 Xcode 选择 File > New > Project。
2. 选择 iOS > App，填写任意项目名称。
3. Interface 选择 SwiftUI，Language 选择 Swift。
4. 在 Signing & Capabilities 中选择你的开发团队。
5. 运行设备选择 iPhone，然后点击运行按钮。

导入 GPX 文件

1. 在本工具中生成轨迹并导出 .gpx 文件。
2. 回到 Xcode，把导出的 .gpx 文件拖入项目导航栏。
3. 如果出现选项窗口，可以勾选 Copy items if needed，并确保 iOS App target 被选中。
4. GPX 文件加入项目后，Xcode 才能在调试定位菜单中看到它。

调试定位

1. 确保 iPhone 上的调试 App 正在由 Xcode 运行。
2. 在 Xcode 菜单栏选择 Debug > Simulate Location。
3. 选择刚导入的 GPX 文件名。
4. Xcode 会在当前开发调试会话中按 GPX 文件模拟定位。
5. 停止调试、断开连接或选择 None 后，模拟定位会停止。

常见问题

1. 如果看不到 iPhone，先解锁手机，并确认已经信任 Mac。
2. 如果提示 Signing 错误，回到 Signing & Capabilities 选择 Team。
3. 如果 Simulate Location 里没有 GPX 文件，确认 GPX 已加入 iOS 项目且 target 被勾选。