如何在Android平台正确生成符合系统规范的通知图标？

核心规则溯源：自API 21（Android 5.0）开始，系统对通知栏小图标存在强制渲染逻辑——仅提取图标alpha通道内的纯白不透明像素进行渲染，所有带色彩、非纯白填充的像素都会被系统自动处理为透明，这也是OneSignal等推送SDK文档明确要求通知图标必须为纯白色的根本原因

实操生成步骤 #

• 提前梳理设计边界
  设计阶段就按照系统要求输出素材：所有需要在通知栏显示的图形轮廓，使用完全不透明的#FFFFFF纯白填充，其余区域保持全透明；严格预留系统要求的安全边距，48dp×48dp的图标画布内，核心图形要集中在中间32dp×32dp的范围内，避免被状态栏圆角、高度裁切遮挡。
• 工具生成适配多分辨率素材
  使用Android Asset Studio的通知图标生成模块操作时，需注意上传的源素材为轮廓清晰的核心图形，不要直接上传带复杂品牌色、渐变、阴影的应用启动图。工具会自动按照系统规范输出纯白透明底的适配素材，覆盖全档位dpi的尺寸要求：
  • mdpi：24×24px
  • hdpi：36×36px
  • xhdpi：48×48px
  • xxhdpi：72×72px
  • xxxhdpi：96×96px
• 工程内配置校验
  将生成的各分辨率素材按目录规范放入res/drawable-*对应文件夹，构建通知时通过setSmallIcon()方法引用该纯白透明图标资源，禁止直接将彩色应用启动图标作为通知小图标传入。

常见踩坑说明 #

应用旧版本使用的带彩色、灰度填充的通知图标，在API 21以上系统版本中会出现渲染异常：非纯白像素被系统抠除后，最终可能只显示零散的白色块、甚至完全无可见图标，导致通知无法正常展示。

按照上述流程生成的图标，可完全适配从Android 5.0到最新版本的系统通知栏渲染规则，兼容OneSignal等主流推送SDK的图标校验要求。

内容的提问来源于stack exchange，提问作者José Guilherme