如何检查Mac Designed for iPad模式下App的WKWebview

问题本质 #

iPad 应用在 Apple Silicon Mac 上以 Designed for iPad 兼容模式运行时，属于独立沙盒的 iOS 兼容进程，和 iOS 真机/模拟器环境的调试逻辑不同：默认不会向同机 Safari 暴露 WKWebView 调试端口，必须手动完成应用端、系统端的权限配置才能被识别。

操作步骤 #

• 显式开启 WKWebView 可调试属性
  若项目最低部署版本 ≥ iOS 16.4，在 WKWebView 初始化逻辑中加入如下代码（建议做条件编译，仅 Debug 环境开启，避免线上包泄露调试权限）：

  #if DEBUG
  if #available(iOS 16.4, *) {
      webView.isInspectable = true
  }
  #endif
  

  注意：该模式下哪怕是 Xcode 直接编译的 Debug 包，isInspectable 属性默认值也为 false，和 iOS 真机/模拟器下 Debug 环境默认开启可调试的逻辑不一致，必须手动赋值。
  若项目最低部署版本低于 iOS 16.4，无需修改业务代码，直接打开 Xcode 项目的 Target → Build Settings，搜索 Other Linker Flags，为 Debug 配置添加参数 -Wl,-inspectable,1，即可强制 Debug 包内所有 WKWebView 实例开启可调试权限。
• 配置进程通信权限
  打开 Xcode 项目的 Target → Signing & Capabilities，为 Debug 配置添加 Outgoing Connections (Client) 能力，允许兼容模式下的应用进程和本地 Safari 建立调试连接。
  如果是通过 Adhoc、TestFlight 安装的调试包，需要打开 Mac 系统设置 → 隐私与安全性 → 开发者工具，将对应应用加入允许调试的列表，同时确认 Xcode、Safari 均在该列表内。
• 按正确顺序启动调试
  启动顺序错误会导致 Safari 无法枚举到目标：
  1. 完全退出 Safari 浏览器、所有正在运行的 iOS 模拟器（模拟器进程会占用兼容模式的调试通道，导致冲突）
  2. 通过 Xcode 选择「My Mac (Designed for iPad)」作为运行目标，启动应用，进入包含 WKWebView 的页面，等待页面加载完成
  3. 打开 Safari，点击顶部菜单栏的「开发」选项，找到和你 Mac 本机名称同名的分组，展开后即可看到对应应用进程和可调试的 WKWebView 页面
• 兼容旧系统的补充配置
  如果你使用 macOS 13 Ventura 及更早版本，且应用部署版本低于 iOS 16，除上述配置外，可在 WKWebView 初始化时加入如下配置（仅 Debug 环境生效）：

  #if DEBUG
  webView.preferences.setValue(true, forKey: "developerExtrasEnabled")
  #endif
  

  执行完配置后如果仍未识别，在终端执行如下命令重启 Safari 调试服务即可：

  defaults write com.apple.Safari IncludeInternalDebugMenu -bool true
  

常见踩坑：Designed for iPad 模式的应用不会出现在 Safari 开发菜单的单独设备分组里，会直接归类在你当前使用的 Mac 本机分组下，不要误去「Simulator」分组里找目标。

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