macCatalyst中Universal Links失效求助：iOS正常Mac端异常

我之前也踩过macCatalyst上Universal Links的坑，结合你提到的情况（AASA已下载但mac端swcutil_show.txt为空、iOS正常mac端失效），整理了几个关键排查方向和特殊处理点，你可以逐一验证：

1. 确认macCatalyst目标的关联域名配置 #

别小看这个基础点，很容易疏忽：

• 打开Xcode，切换到macCatalyst的目标，检查Signing & Capabilities标签页，确保Associated Domains capability已添加，并且格式为applinks:yourdomain.com（和iOS端一致）。有时候会只给iOS目标配置，漏掉macCatalyst的。
• 同时检查macCatalyst目标的Info.plist，确保包含NSUserActivityTypes数组，并且其中有NSUserActivityTypeBrowsingWeb——这是处理Universal Links的必要配置项，macCatalyst和iOS都需要，但经常被遗漏在mac端的配置里。

2. 强制刷新macOS的AASA缓存 #

macOS的swc（Service Worker Cache）缓存机制和iOS略有不同，即使AASA已下载，缓存可能依然是旧的或者未生效：

• 打开终端，执行以下命令强制重置swc缓存：

  swcutil reset
  

• 重启你的macCatalyst应用，然后再测试链接。
• 如果想排查日志细节，可以用这个命令实时查看swcd的日志：

  log stream --predicate 'process == "swcd"' --info
  

  点击链接后，看日志里有没有关于你的AASA文件的解析记录，是否存在签名不匹配、格式错误等报错信息。

3. 验证签名与AASA的匹配性 #

macOS对应用签名的验证比iOS更严格，尤其是使用Developer ID签名时：

• 用终端查看macCatalyst应用的签名信息：

  codesign -dv --verbose=4 /path/to/your/macCatalyst/app
  

  找到TeamIdentifier字段，确保和AASA文件appIDs数组里的Team ID完全一致（格式为TEAMID.BundleID）。
• 确认AASA的appIDs包含macCatalyst应用的完整ID（如果mac端Bundle ID和iOS不同的话，需要单独添加），比如：

  "appIDs": ["ABC1234567.com.yourcompany.yourapp-ios", "ABC1234567.com.yourcompany.yourapp-mac"]
  

4. 检查macOS系统权限设置 #

macOS的隐私设置可能会阻止Universal Links的跳转：

• 打开系统设置 > 隐私与安全性 > 网站 > 关联的应用，查看你的应用是否被列出，并且对应的域名是否处于允许状态。如果没有，可能需要手动授权。
• 确保你的macCatalyst应用是通过有效的Developer ID签名的，并且没有被系统标记为未信任。刚安装的应用可能需要在隐私与安全性里点击"允许"来信任。

5. 场景Delegate的实现适配 #

虽然你在iOS上用了scene(_ scene: UIScene, continue userActivity: NSUserActivity)，但macCatalyst上有几点需要注意：

• 如果用UIKit，确保macCatalyst的SceneDelegate正确处理NSUserActivityTypeBrowsingWeb类型的userActivity，检查userActivity.webpageURL是否正确传递。
• 如果用SwiftUI，确保在App结构体里通过onContinueUserActivity(NSUserActivityTypeBrowsingWeb)来处理跳转逻辑，而不是只依赖iOS的场景配置。

6. AASA文件的格式兼容macOS #

虽然AASA的基本格式和iOS一致，但macOS不支持components字段（iOS 13+引入的），如果你的AASA只使用了components，macCatalyst会无法解析：

• 确保AASA文件中同时保留paths字段来兼容macOS，比如：

  {
    "applinks": {
      "details": [
        {
          "appIDs": ["TEAMID.YourBundleID"],
          "paths": ["*"],
          "components": [
            {
              "/": "*",
              "comment": "Matches any path"
            }
          ]
        }
      ]
    }
  }
  

  这样既满足iOS的components规则，也能让macCatalyst通过paths解析链接。

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