首次开发Safari App Extension遇弹窗失效及控制台报错求助

针对macOS 13.5/Safari 16.6环境下，Safari App Extension模板点击无弹窗、控制台报XPC连接无效的问题，按以下步骤排查修复：

1. 核心处理：修复XPC连接失效问题 #

XPC连接无效是导致扩展无响应的关键原因，说明Safari与扩展进程的通信链路断裂，尝试以下操作：

• 重置Safari扩展状态：打开Safari设置→扩展标签页，先禁用目标扩展，重启Safari后重新启用；若无效，删除扩展后重新构建安装。
• 检查扩展签名与沙箱权限：
  • 打开XPC项目设置，选中扩展target→签名与功能，确保签名身份为Apple Development: 你的开发者账号，且必须启用App Sandbox（Safari App Extension强制要求）。
  • 在沙箱权限中勾选Outgoing Connections (Client)，否则无法与Safari建立XPC通信。
• 清理XPC缓存：打开终端执行以下命令，清除Safari相关缓存后重启Mac：

  rm -rf ~/Library/Containers/com.apple.Safari/Data/Library/Caches/com.apple.Safari.SafeBrowsing/
  rm -rf ~/Library/Containers/com.apple.Safari/Data/Library/Caches/com.apple.Safari.WebKit2/
  

2. 处理窗口唤起遮挡问题 #

控制台的窗口唤起警告可能导致弹窗被当前活跃应用遮挡，修改扩展弹窗的唤起逻辑：
在SFSafariExtensionHandler子类的按钮点击处理方法中，添加窗口激活代码：

override func toolbarItemClicked(in window: SFSafariWindow) {
    // 原模板创建弹窗窗口的代码后，追加以下内容
    if let popupWindow = yourPopupWindow {
        popupWindow.makeKeyAndOrderFront(nil)
        NSApp.activate(ignoringOtherApps: true)
    }
}

3. 消除旧SDK调试警告 #

针对com.apple.security.get-task-allow的警告，在扩展target的Info.plist中，给NSExtension下的SFSafariExtension字典新增Inspectable键，值设为YES：

<key>NSExtension</key>
<dict>
    <key>NSExtensionAttributes</key>
    <dict>
        <key>SFSafariExtension</key>
        <dict>
            <key>Inspectable</key>
            <true/>
            <!-- 保留原有其他属性 -->
        </dict>
    </dict>
    <!-- 保留原有其他键值 -->
</dict>

4. 验证版本兼容性 #

确认项目及扩展target的部署目标设置为macOS 13.0或更高，Xcode使用的SDK为macOS 13.5（Xcode 14.3.1默认SDK），避免版本不兼容引发的隐性问题。

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