SwiftUI WatchOS应用推送通知注册及点击跳转技术咨询

一、WatchOS 推送注册的核心逻辑 #

你提到的WKExtension.shared().registerForRemoteNotifications()是正确的注册远程推送的方法，但完整流程需要先请求用户通知权限，再执行注册，和iPhone端逻辑类似。

二、SwiftUI Watch App 的代码放置方式 #

SwiftUI Watch App 确实没有传统的 Watch Extension 入口，但可以通过WKApplicationDelegateAdaptor属性包装器，适配自定义的WKExtensionDelegate来处理推送注册、令牌接收和通知点击逻辑。

三、完整实现步骤 #

1. 开启 Watch App 的推送权限

在 Xcode 中选中 Watch App 目标，进入Signing & Capabilities，添加Push Notifications能力。

2. 自定义 Watch Extension 代理

创建处理推送逻辑的代理类：

class WatchExtensionDelegate: NSObject, WKExtensionDelegate, UNUserNotificationCenterDelegate {
    // App启动时执行初始化
    func applicationDidFinishLaunching() {
        // 设置通知中心代理
        UNUserNotificationCenter.current().delegate = self
        
        // 请求用户通知权限
        let authOptions: UNAuthorizationOptions = [.alert, .sound, .badge]
        UNUserNotificationCenter.current().requestAuthorization(options: authOptions) { granted, error in
            guard error == nil else {
                print("请求通知权限失败：\(error!.localizedDescription)")
                return
            }
            if granted {
                // 权限通过后注册远程推送
                WKExtension.shared().registerForRemoteNotifications()
            }
        }
    }
    
    // 接收Watch设备推送令牌
    func application(_ application: WKExtension, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
        let tokenString = deviceToken.map { String(format: "%02.2hhx", $0) }.joined()
        print("Watch 推送令牌：\(tokenString)")
        // 将令牌发送到你的服务器，和iPhone端逻辑一致
    }
    
    // 推送注册失败处理
    func application(_ application: WKExtension, didFailToRegisterForRemoteNotificationsWithError error: Error) {
        print("Watch 推送注册失败：\(error.localizedDescription)")
    }
    
    // 处理通知点击事件
    func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
        // 从通知payload中获取跳转参数（需要服务器推送时携带）
        let userInfo = response.notification.request.content.userInfo
        
        // 通知SwiftUI界面跳转
        if let targetPage = userInfo["target_page"] as? String {
            NavigationManager.shared.navigateTo(page: targetPage)
        }
        
        completionHandler()
    }
}

3. 在 Watch App 中绑定代理

在你的@main标记的Watch App结构体中，通过WKApplicationDelegateAdaptor关联自定义代理：

@main
struct WatchApp: App {
    // 绑定自定义Extension代理
    @WKApplicationDelegateAdaptor(WatchExtensionDelegate.self) var delegate
    
    var body: some Scene {
        WindowGroup {
            NavigationStack {
                MainView()
                    .environmentObject(NavigationManager.shared)
            }
        }
    }
}

4. 实现页面跳转逻辑

通过ObservableObject管理导航状态，实现通知点击后的页面跳转：

// 导航状态管理器
class NavigationManager: ObservableObject {
    static let shared = NavigationManager()
    private init() {}
    
    @Published var targetPage: String? = nil
    
    func navigateTo(page: String) {
        targetPage = page
    }
}

// 主页面
struct MainView: View {
    @EnvironmentObject var navManager: NavigationManager
    
    var body: some View {
        VStack {
            Text("Watch 主页面")
        }
        .navigationDestination(item: $navManager.targetPage) { page in
            // 根据参数跳转对应页面
            switch page {
            case "detail":
                DetailView()
            case "settings":
                SettingsView()
            default:
                Text("未知页面")
            }
        }
    }
}

// 示例详情页
struct DetailView: View {
    var body: some View {
        Text("详情页面")
    }
}

四、额外注意事项 #

• 服务器推送通知时，需指定apns-topic为Watch App的Bundle ID，确保通知推送到Watch设备；
• 默认情况下，通知会优先推送到iPhone，仅当iPhone锁屏或不在范围内时才会推送到Watch；若需强制推送到Watch，需在推送payload中配置对应参数；
• 跳转参数需在推送的userInfo字段中携带，比如"target_page": "detail"。

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