如何为iOS通知添加图标？求类似WhatsApp的可行实现方案

阿华AIGC实验室

2026-5-27

实现iOS通知中精准图标效果的方案（参考WhatsApp实现）

我之前也被这个问题困扰过！系统自带的通知图片展示要么拉伸变形，要么尺寸适配混乱，完全达不到WhatsApp那种规整的图标效果。后来研究了一番，发现核心是用**通知内容扩展（Notification Content Extension）**来自定义整个通知界面，而不是依赖系统默认的图片附件。

为什么系统默认方案不行？

iOS原生的UNNotificationAttachment虽然能添加图片，但它是为展示大图设计的，会自动填充通知区域，而且对图片尺寸、比例要求严格，很难做出小而精准的图标效果——比如WhatsApp那种圆形联系人头像，用原生附件根本做不到完美适配。

具体实现步骤（和WhatsApp思路一致）

第一步：创建通知内容扩展
在Xcode中给项目新增一个Target，选择「Notification Content Extension」。注意扩展的Bundle ID要和主App保持关联（比如主App是com.yourcompany.yourapp，扩展可以设为com.yourcompany.yourapp.notification-icon），这样系统才能识别到这个扩展属于你的App。
第二步：自定义通知界面布局
打开扩展的NotificationViewController.swift，在对应的Storyboard或者纯代码里布局一个UIImageView——你可以精准设置它的尺寸（比如40x40pt）、圆角（设为宽高一半就是圆形）、边框样式等，完全按照你想要的图标效果来。记得用AutoLayout把它固定在通知的左侧，和文字内容对齐。

第三步：传递图标数据到扩展
主App发送推送通知时，把图标的数据（比如本地缓存路径，或者Base64编码的图片数据）放在通知的userInfo字典里。举个例子，发送本地通知的代码大概是这样：

let content = UNMutableNotificationContent()
content.title = "新消息"
content.body = "来自张三的消息"
content.userInfo = ["iconPath": "/path/to/cached/avatar.png"] // 传递图标路径
content.categoryIdentifier = "customIconNotification" // 要和扩展支持的类别一致

let request = UNNotificationRequest(identifier: UUID().uuidString, content: content, trigger: nil)
UNUserNotificationCenter.current().add(request)

第四步：在扩展中加载图标
在扩展的didReceive(_ notification: UNNotification)方法里，从notification.request.content.userInfo中取出图标数据，加载到之前布局的UIImageView里。如果是本地路径，直接用UIImage(contentsOfFile:)加载；如果是Base64，就解码成Data再转成UIImage。

第五步：注册通知类别并关联扩展
主App启动时，注册通知类别，确保categoryIdentifier和扩展里设置的一致，并且指定这个类别使用自定义界面：

let category = UNNotificationCategory(identifier: "customIconNotification",
                                      actions: [],
                                      intentIdentifiers: [],
                                      options: .customDismissAction)
UNUserNotificationCenter.current().setNotificationCategories([category])