升级Xcode13后无法添加GPX文件进行位置模拟怎么解决？

1. 校验GPX文件格式合法性 #

Xcode 13 对GPX文件的Schema校验比旧版本更严格，旧版本可正常使用的不规范格式在新版本会被直接忽略，你可以对照最小可用GPX格式排查问题：

<?xml version="1.0" encoding="UTF-8"?>
<gpx version="1.1" creator="Xcode">
    <!-- 单点定位示例 -->
    <wpt lat="39.9042" lon="116.4074">
        <name>Beijing</name>
    </wpt>
    <!-- 路线模拟示例，多个trkpt按时间排序即可生成移动轨迹 -->
    <!--
    <trk>
        <trkseg>
            <trkpt lat="39.9042" lon="116.4074"></trkpt>
            <trkpt lat="39.9043" lon="116.4075"></trkpt>
        </trkseg>
    </trk>
    -->
</gpx>

需要注意：

• 纬度取值范围必须在-90_{90之间，经度取值范围必须在-180}180之间
• 所有标签必须正常闭合，属性值需要用英文双引号包裹

2. 确认GPX文件的Target成员资格配置 #

导入文件时如果未勾选对应Target，Xcode不会将GPX打包到App资源中，自然无法识别：

• 右键点击项目中的GPX文件，选择Show File Inspector
• 在右侧面板的Target Membership区域，勾选你当前运行的App主Target
• 如果是刚拖入文件，在弹出的导入确认窗口中直接勾选Add to targets即可

3. 正确加载GPX的操作步骤 #

• 完成上述配置后，执行Product -> Clean Build Folder（快捷键Shift + Cmd + K）清理缓存
• 运行App到模拟器或真机，点击Xcode顶部Debug栏的定位图标
• 在下拉菜单中找到你添加的GPX文件，点击即可启用模拟定位

4. 异常排查 #

• 检查文件后缀是否为全小写的.gpx，Xcode 13对文件名大小写敏感，.GPX后缀会被识别为普通文件
• 不要将GPX文件放在嵌套过深的资源子目录，优先放在项目根目录层级，避免路径读取异常
• 如果仅需要单次临时模拟，可直接在Xcode顶部菜单栏选择Debug -> Simulate Location -> Add GPX File to Project临时导入

内容的提问来源于stack exchange，提问作者Sridhar