如何在Notifications Service扩展中预加载资源供Notifications Content扩展使用

嘿，这个需求完全踩中了UNNotificationAttachment的设计初衷——在Service扩展里提前处理好媒体资源，让Content扩展能直接展示，避免用户展开通知时还要等待加载，体验确实会顺畅很多！我来给你拆解具体的实现步骤和注意点：

这一步的核心是把远程图片下载到本地临时目录，然后包装成UNNotificationAttachment，再更新通知内容：

1. 首先在didReceive(_:withContentHandler:)方法里，从通知的userInfo中取出图片的远程URL（你需要在推送 payload 里带上这个字段，比如"image_url": "https://example.com/your-image.jpg"）
2. 使用URLSession下载图片到系统临时目录，这里要注意文件名用UUID保证唯一，避免冲突
3. 基于本地文件路径创建UNNotificationAttachment，指定好标识符和类型提示
4. 把Attachment添加到通知内容中，最后调用contentHandler传递更新后的内容

代码示例（Swift）：

override func didReceive(_ request: UNNotificationRequest, withContentHandler contentHandler: @escaping (UNNotificationContent) -> Void) {
    self.contentHandler = contentHandler
    bestAttemptContent = (request.content.mutableCopy() as? UNMutableNotificationContent)
    
    guard let content = bestAttemptContent,
          let imageURLString = content.userInfo["image_url"] as? String,
          let imageURL = URL(string: imageURLString) else {
        // 没有图片URL或者内容不可变，直接返回原通知
        contentHandler(request.content)
        return
    }
    
    // 启动图片下载任务
    let downloadTask = URLSession.shared.dataTask(with: imageURL) { [weak self] data, _, error in
        guard let self = self, let imageData = data, error == nil else {
            print("图片下载失败: \(error?.localizedDescription ?? "未知错误")")
            contentHandler(request.content)
            return
        }
        
        // 创建临时文件路径
        let tempDir = FileManager.default.temporaryDirectory
        let tempFileURL = tempDir.appendingPathComponent("\(UUID().uuidString).jpg")
        
        do {
            // 把图片数据写入临时文件
            try imageData.write(to: tempFileURL)
            
            // 创建UNNotificationAttachment
            let attachmentOptions = [UNNotificationAttachmentOptionsTypeHintKey: "public.jpeg"]
            let attachment = try UNNotificationAttachment(identifier: "notification_image", url: tempFileURL, options: attachmentOptions)
            
            // 更新通知内容的附件列表
            content.attachments = [attachment]
            
            // 传递处理后的通知内容
            self.contentHandler(content)
        } catch {
            print("创建Attachment失败: \(error.localizedDescription)")
            contentHandler(request.content)
        }
    }
    downloadTask.resume()
}

这一步就简单了，直接从通知内容里取出Attachment，加载到你的UI控件即可：

1. 在didReceive(_:)方法里，获取通知内容中的Attachment，通过标识符筛选出我们预加载的图片附件
2. 因为Attachment的URL是安全范围资源，必须调用startAccessingSecurityScopedResource()才能访问，用完记得调用stopAccessingSecurityScopedResource()
3. 读取本地文件数据转换成UIImage，展示在UIImageView里；如果加载失败，记得做容错处理（比如隐藏图片视图、显示占位图）

代码示例（Swift）：

override func didReceive(_ notification: UNNotification) {
    super.didReceive(notification)
    
    // 获取目标Attachment
    guard let imageAttachment = notification.request.content.attachments.first(where: { $0.identifier == "notification_image" }),
          imageAttachment.url.startAccessingSecurityScopedResource() else {
        // 没有有效图片，隐藏图片视图
        notificationImageView.isHidden = true
        return
    }
    
    // 用完必须停止访问安全资源
    defer {
        imageAttachment.url.stopAccessingSecurityScopedResource()
    }
    
    // 加载图片到视图
    do {
        let imageData = try Data(contentsOf: imageAttachment.url)
        if let image = UIImage(data: imageData) {
            notificationImageView.image = image
            notificationImageView.isHidden = false
        } else {
            notificationImageView.isHidden = true
        }
    } catch {
        print("加载图片失败: \(error.localizedDescription)")
        notificationImageView.isHidden = true
    }
}

• 临时文件生命周期：Service扩展的临时目录文件会被系统自动清理，不需要手动删除，但一定要用唯一文件名（UUID）避免重复写入导致的问题
• 格式兼容性：确保下载的图片是系统支持的格式（JPEG、PNG、GIF等），创建Attachment时通过UNNotificationAttachmentOptionsTypeHintKey指定类型，帮助系统正确解析
• 容错机制：任何环节（下载、创建Attachment、加载图片）出错都要 fallback 到原通知内容，绝对不能让通知无法展示
• 权限问题：Content扩展中访问Attachment的URL必须调用安全资源访问方法，否则会读取失败

内容的提问来源于stack exchange，提问作者Milan Nosáľ