无法在iOS 16.4 Safari模拟器调试Ionic Capacitor应用

问题根源 #

你手动创建的WKWebView并非Capacitor实际使用的WebView实例，开启isInspectable后只会让这个空WebView被检测到，导致调试目标显示about:blank。Capacitor有自身的WebView初始化逻辑，无需手动创建额外WebView。

正确解决步骤 #

1. 移除无效代码 #

删除AppDelegate中你手动添加的以下所有代码：

let webConfiguration = WKWebViewConfiguration()
let webView: WKWebView = WKWebView(frame: .zero, configuration: webConfiguration)

以及对应的webView.isInspectable = true代码块。

2. 配置Capacitor原生WebView检查权限 #

在ios/App/AppDelegate.swift的application(_:didFinishLaunchingWithOptions:)方法中，添加Capacitor专属的WebView检查配置：

import Capacitor

func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
    // 保留原有代码...
    
    #if DEBUG
        if #available(iOS 16.4, *) {
            let webConfig = WKWebViewConfiguration()
            webConfig.isInspectable = true
            CapacitorBridge.defaultWebViewConfiguration = webConfig
        }
    #endif
    
    return true
}

3. 确保调试环境正确 #

• 用Debug模式编译运行模拟器（Xcode顶部工具栏选择Debug，而非Release）。
• 运行应用后，在Safari「开发」菜单中选择对应模拟器和应用名称（不再是about:blank）。

4. 额外排查点 #

• 重启Xcode和Safari，缓存可能导致检测异常。
• 确认模拟器iOS版本为16.4，且Safari已开启「开发」菜单（Safari偏好设置→高级→勾选「显示开发菜单」）。

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