WatchOS中AppIntents与AppShortcuts不显示问题求助

以下是针对你遇到的问题的具体排查和解决步骤：

• 检查WatchOS目标的基础配置

  1. 确认WatchOS target的Signing & Capabilities中已开启App Intents能力，很多人容易只给iOS端开启，漏掉Watch端。
  2. 打开WatchOS target的Info.plist，添加NSUserActivityTypes数组，把你的Intent类对应的标识符加进去，格式为$(PRODUCT_BUNDLE_IDENTIFIER).你的Intent类名。

• 验证Shortcuts的注册逻辑

  1. 确保AppShortcuts结构体是放在WatchOS target中，而非仅iOS target。示例代码：

     import AppIntents
     
     struct WatchAppShortcuts: AppShortcuts {
         static var appShortcuts: [AppShortcut] {
             AppShortcut(
                 intent: YourCustomIntent(),
                 phrases: ["用\(applicationName)完成XX操作"],
                 shortTitle: "XX操作",
                 systemImageName: "gearshape"
             )
         }
     }
     

  2. 在WatchOS的App入口注册Intent，比如SwiftUI的App结构体中：

     @main
     struct WatchApp: App {
         init() {
             // 注册所有定义的Intent
             IntentConfiguration.register()
         }
     
         var body: some Scene {
             WindowGroup {
                 ContentView()
             }
         }
     }
     

• 真机测试的关键注意点

  1. 确保Watch上的App是手动确认安装的，而非自动同步后未完成安装。可以在iPhone的Watch App中检查App状态，卸载后重新安装。
  2. 检查Watch的系统设置：打开「设置」→「快捷指令」，确认你的App在允许访问的列表中。
  3. 重启Watch和iPhone，真机环境下有时候缓存会导致Intent不加载。
  4. 确保你的Intent类是public修饰的，因为跨target通信需要公开访问权限：

     public struct YourCustomIntent: AppIntent {
         static var title: LocalizedStringResource = "自定义操作"
         static var description = IntentDescription("这是一个自定义的WatchOS Intent")
     
         func perform() async throws -> some ReturnsValue & ProvidesDialog {
             // 执行逻辑
             return .result(value: "完成", dialog: "操作已完成")
         }
     }
     

• 调试排查

  1. 在WatchOS的App启动逻辑中添加日志，打印已注册的Intent类型：

     print("已注册的Intent类型：\(IntentConfiguration.allIntentTypes())")
     

     运行后查看控制台，确认你的Intent是否在列表中。
  2. 搜索Xcode控制台中的AppIntents相关日志，排查是否有注册失败、权限不足等报错信息。

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