Flutter Android端动态本地通知图标：如何支持用户自定义上传图片作为通知图标

你之前了解的「通知只能访问内置drawable、mipmap资源」是默认配置的限制，并非Android系统的硬限制，系统本身支持加载App私有目录下的本地图片作为通知图标，具体实现步骤如下：

前置准备 #

使用主流的flutter_local_notifications库实现本地通知功能，同时搭配path_provider库获取App私有目录路径。

实现步骤 #

1. 存储自定义图片到App私有目录 #

用户上传/选择/下载的任意图片，统一转存到App内部私有目录，不要放在公共存储区域：

• 私有目录可通过getApplicationDocumentsDirectory()或getCacheDir()接口获取，该目录不需要额外申请存储权限，系统通知服务默认有权限读取
• 提前对图片做压缩处理：大图标建议控制在4848dp、100KB以内，小图标建议控制在2424dp，避免内存占用过高导致图标加载失败

2. 配置通知参数加载自定义图标 #

分大图标、小图标两种场景配置：

注意：Android 5.0及以上系统对通知小图标有强制规范：仅保留图片的alpha通道，所有非透明区域会被系统自动填充为白色，普通带颜色的图片作为小图标会出现样式异常，此类场景建议将自定义图片作为大图标展示，小图标保留内置的固定品牌logo即可。

自定义大图标（无样式限制，适用发信人头像等场景）

直接在AndroidNotificationDetails的largeIcon参数传入本地文件路径的Bitmap对象即可，示例代码：

import 'package:flutter_local_notifications/flutter_local_notifications.dart';

// 替换为你自己的图片私有存储路径
String customIconPath = '/data/data/[你的应用包名]/files/user_upload_icon.png';

final androidNotificationDetails = AndroidNotificationDetails(
  'custom_notify_channel',
  '自定义通知渠道',
  channelDescription: '支持动态图标的通知渠道',
  importance: Importance.max,
  priority: Priority.high,
  // 加载私有目录下的自定义图片作为大图标
  largeIcon: FilePathAndroidBitmap(customIconPath),
);

自定义小图标（需符合系统样式规范）

如果确实需要修改小图标，先将用户上传的图片处理为仅含alpha通道的轮廓图，再将本地图片解码为Bitmap对象，通过AndroidBitmap.fromBitmap传入smallIcon参数即可。如果有更复杂的定制需求，也可以通过调用原生层Notification.Builder.setSmallIcon(Icon.createWithBitmap(bitmap))实现。

3. 权限适配 #

• Android 13及以上版本需要提前申请POST_NOTIFICATIONS权限，否则通知无法正常展示
• 不需要申请存储读写权限，App私有目录的文件系统通知服务可直接读取

常见问题排查 #

• 图标显示为默认图标：优先检查图片是否存放在公共存储路径，系统通知服务没有权限读取公共存储的非本App文件
• 小图标显示为白色块：检查图片是否符合Android 5.0+的小图标规范，是否仅保留alpha通道
• 通知加载失败：检查图片大小是否超过1MB，过大的图片会被系统限制加载

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