iOS Notification Service Extension未触发：移入口至库中失效排查

iOS支持将Notification Service Extension（NSE）的入口类放在自定义库中，你的问题大概率是配置或代码实现的疏漏，以下是具体排查方向：

1. 库中NSE类的实现规范 #

• 确保TWNotificationService类为public权限（默认internal权限会导致扩展目标无法访问），且正确继承自UNNotificationServiceExtension，同时必须实现超时回调方法：

  public class TWNotificationService: UNNotificationServiceExtension {
      var contentHandler: ((UNNotificationContent) -> Void)?
      var bestAttemptContent: UNMutableNotificationContent?
  
      public override func didReceive(_ request: UNNotificationRequest, withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) {
          self.contentHandler = contentHandler
          bestAttemptContent = (request.content.mutableCopy() as? UNMutableNotificationContent)
          
          // 这里添加你的通知增强逻辑
          if let bestAttemptContent = bestAttemptContent {
              bestAttemptContent.title = "\(bestAttemptContent.title) [增强版]"
              contentHandler(bestAttemptContent)
          }
      }
  
      public override func serviceExtensionTimeWillExpire() {
          // 超时必须调用contentHandler返回内容，否则扩展会启动失败
          if let contentHandler = contentHandler, let bestAttemptContent = bestAttemptContent {
              contentHandler(bestAttemptContent)
          }
      }
  }
  

2. 扩展目标Info.plist配置检查 #

• 确认NSExtensionPrincipalClass取值为完整模块名+类名：可通过库的Build Settings -> Product Module Name确认模块名，若模块名不是TWNotifications，此处会匹配失败。
• 确认NSExtension字典下的NSExtensionPointIdentifier为固定值com.apple.usernotifications.service，不能写错。

3. 扩展目标的依赖配置 #

• 确保TWNotifications库已正确关联到扩展目标：
  • 选中TWNotificationServiceExtension目标 -> General -> Frameworks, Libraries, and Embedded Content
  • 动态库需设置为Embed & Sign，静态库设置为Do Not Embed
  • 若用Swift Package Manager，需确认库已添加到扩展目标的依赖列表（而非仅主App目标）

4. 测试Payload的正确性 #

• 确保mutable-content为整数1，APNs不识别字符串类型的该字段，示例Payload：

  {
      "aps": {
          "alert": {
              "title": "测试通知",
              "body": "可增强的通知内容"
          },
          "mutable-content": 1,
          "category": "MEETING_INVITE"
      }
  }
  

5. 调试与日志排查 #

• 直接调试扩展目标：在Xcode中选择TWNotificationServiceExtension为运行目标，连接测试设备后点击运行，发送推送即可查看扩展的实时日志。
• 通过Mac的Console app搜索TWNotificationServiceExtension或UNNotificationServiceExtension，查看是否有类找不到、权限不足等启动失败报错。

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