WWDC23 MapKit教程中Content View内Map()无法加载求助

常见原因及修复步骤 #

• 添加地图权限描述：
  iOS要求访问地图相关功能时必须在Info.plist中添加权限描述。右键项目里的Info.plist，选择"Open As" -> "Source Code"，添加以下任意一项（按需选择）：

  <!-- 仅使用时允许定位 -->
  <key>NSLocationWhenInUseUsageDescription</key>
  <string>需要访问您的位置以显示地图</string>
  <!-- 始终允许定位（需后台定位场景） -->
  <key>NSLocationAlwaysAndWhenInUseUsageDescription</key>
  <string>需要始终访问您的位置以提供地图服务</string>
  

  即使仅显示默认地图，部分场景下也需权限描述才能正常加载地图瓦片。

• 检查预览环境网络状态：
  MapKit需联网加载地图资源，确保你的Mac/iOS模拟器处于联网状态，且未被防火墙或代理拦截网络请求。

• 指定初始地图区域：
  默认Map()未设置初始区域时，可能因无明确加载范围导致仅显示网格。可给Map指定初始区域，示例代码如下：

  import SwiftUI
  import MapKit
  
  struct ContentView: View {
      // 以纽约坐标为例设置初始区域
      @State private var region = MKCoordinateRegion(
          center: CLLocationCoordinate2D(latitude: 40.7128, longitude: -74.0060),
          span: MKCoordinateSpan(latitudeDelta: 0.05, longitudeDelta: 0.05)
      )
  
      var body: some View {
          Map(coordinateRegion: $region)
      }
  }
  
  #Preview {
      ContentView()
  }
  

  明确的区域会触发地图加载对应瓦片资源。

• 清理项目并重启Xcode：
  Xcode缓存可能导致资源加载异常，尝试：

  1. 按下Cmd+Shift+K清理项目
  2. 关闭Xcode后重新打开项目并运行预览

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