通知栏小图标为什么变成白块：单色 alpha、渠道缓存与素材清单

本文属于"新手上路"里的机制篇。主角是安卓修改大师智改工坊——一款 Windows 桌面工具：把安装包拖进来，用中文写一句需求，AI 在反编译出来的工程里改 smali 与资源，改完自动回编、对齐、签名、校验，最后一键装到手机或模拟器上看效果。它的介绍页在 https://www.apkeditor.cn/ai-version.aspx，官网是 www.apkeditor.cn。

先描述一个几乎每个改图标的人都会经历的画面：设计给了一张很漂亮的通知图标，你把应用里那张小图标替换掉，打包、装机、下拉通知栏 —— 状态栏上出现的却是一个纯白色的小方块，四四方方、什么都看不出来。你换回原来的图，它还是白块；你换一张更简单的图，它还是白块。于是你开始怀疑资源替换没生效、怀疑打包没打进去、怀疑设备缓存。

答案其实在第一句话里就给出了：通知的小图标是一张"单色图"，系统只读它的形状，不读它的颜色。 你给了一张彩色图，系统就只从中提取出"哪里不透明、哪里透明"这一层信息 —— 如果整张图处处不透明（比如一张带白色背景的方图），提取出来的形状就是一个完整方块，于是它老老实实给你画了一个白色方块。这不是故障，是规范。这篇文章就把这条规范、它带来的六种常见坑、以及"改完怎么验证"讲清楚。

一、规范先行：小图标只认"形状"，不认"颜色"

从较新的 Android 版本开始，状态栏与通知里的小图标被设计成"白色剪影"：系统拿到你提供的图，只看它的透明度通道 —— 不透明的地方画成白色（或跟随系统主题着色），透明的地方留空。这样做的理由很现实：状态栏背景有深有浅、还要和系统整体风格一致，只有单色剪影才能在任何背景下都清晰、统一。

这条规范带来三个直接推论，每一条都能解释一类现象：

• 颜色信息会被丢掉。 一张彩色图标放进去，最终只会显示成白色剪影。你精心配的品牌色在状态栏上根本不会出现 —— 想在通知里显示彩色图，那是另一个角色（大图标）的活，后面会讲。
• 不透明的背景会让整个图形变成"实心块"。 一张带白色底、或者完全不含透明通道的图，提取出来的形状就是整个矩形 —— 于是显示成白块。这就是"白块"的第一大来源。
• 形状太细碎会"糊成一团"。 反过来，如果图形线条太细（比如把一张复杂插画塞进 24 像素的画布里），缩小之后笔画互相粘连或直接消失，看起来就像一个小白点或者什么都没有。

尺寸上也有硬约定。小图标的通行做法是按24 个设备无关像素的画布来画，图形本体控制在画布内收一点的位置、四周留出均匀留白 —— 不留白，图形贴着边，在部分系统上会被裁掉一圈。同一张图要在五个密度档上各备一份：mdpi 对应 24 像素、hdpi 对应 36、xhdpi 对应 48、xxhdpi 对应 72、xxxhdpi 对应 96。少备了会怎样？系统会拿邻近密度的那一张来缩放，结果就是"在有些手机上看着有点糊"。这一点和后面要讲的文件定位直接相关：同一个图标名往往在多个密度目录里各有一份，只改一份等于只在部分设备上生效。

这里还有一个非常容易造成误判的版本差异，必须提前说明："只取形状、统一上色"是较新系统的做法。在很老的 Android 版本上，小图标是按原图直接画的 —— 也就是说同一张彩色图，在老设备上显示得"挺好看"，在新设备上就变成了白块。"同事的老手机上明明没问题"这句话，恰恰是这句话在作祟，它不是"新手机有问题"，而是新系统在按规范办事。 类似的差异还有一层：较新的系统会给状态栏图标做整体主题化处理，颜色由系统决定，应用只能控制形状 —— 这也是为什么"我明明画了蓝色的图，怎么是白的"永远没有例外。

这也回答了一个设计上的疑问：为什么通知的小图标和桌面图标规范正好相反？因为两者面对的场景完全相反。桌面图标是"应用的门面"：它有自己的名字、自己的位置，可以多彩、可以带背景、可以用分层图做动效；通知小图标是"一排标识里的一个"：它要和别的应用的小图标并排站在状态栏上，谁也不能抢戏，所以只能是统一的单色剪影。理解了这个出发点，"规范"就不再是一堆束缚，而是一句话：在不同的场合，用不同性质的图。

二、变白块的六种成因：一张排查表

"白块"只是一个症状，背后的原因有六种，处理方式各不相同。下面这张表按"从最常见到最不常见"排列，遇到白块时从上往下对一遍即可。

成因	为什么	怎么改
换上了带背景的彩色图	整块不透明，形状被认成"一个矩形"	去掉背景，只保留图形本身的不透明区域
用了不含透明通道的图片格式	格式本身没有透明度这一层信息，等于处处不透明	换成支持透明通道的格式重出一份
图形太细 / 太小	缩放后笔画粘连或消失，看着像白点或没有	简化造型、加粗笔画、放大到画布允许的范围内
图形贴边被裁	没有留白，边缘被系统裁掉一圈	四周留出均匀边距，图形居中略小
替换的不是被引用的那张图	同一个名字在多个密度目录里各有一份，只改了一份，或者代码引用的根本是另一张	先找出"真正被引用"的资源名与它所有密度目录下的文件，成套替换
改错了对象（换的是启动器图标）	桌面图标与通知小图标是两套资源，互不相干	先确认通知用的资源名，再去改那一份

表里最后两条最容易让人白忙一场，值得展开。它们都指向同一个前提动作：先找出"通知到底在用哪张图"。 做法是回到工程里看通知构造的那几行 —— 通知是通过代码创建的，创建时会指定一个小图标资源；把这个资源名记下来，再去资源目录里搜这个名字，你会看到它在几个密度目录下各有文件，有的项目还同时有一张矢量图。这时候"改哪一份"的答案才真正明确：同名资源的所有密度版本都要换，而且格式要一致；如果原来引用的是矢量图，那你换多少张 PNG 都不会生效 —— 这是最容易被误判成"工具没改到"的一种。

还有一个特别"冤"的现象：通知改用另一张图之后，有些机型上显示的仍然是旧图标。常见原因是通知没有重新发出 —— 已经挂在通知栏上的那条通知，是旧的那一次构建结果，改包重装不会去刷新它；退出应用、让通知重新发一次（或重启设备）才能看到新图标。这类"是不是缓存"的问题，判断方法很统一：把旧通知全部清掉，让应用再发一条新的。

先定位：通知小图标到底是哪张图

上面六种成因里有一半都指向同一个前提动作：先确认"通知到底在用哪一张图"。这件事有三步，做起来不到五分钟，但能把后面所有试错都省掉。

1. 找创建通知的那几行。 在反编译出来的代码里，通知是这样被"组装"出来的：先选定小图标资源，再填标题、正文、大图标，最后发出去。小图标就是这段代码里最先被指定的那个资源 —— 从它开始找。
2. 记下资源名，去资源目录里搜。 用这个名字在资源目录里搜一遍，你会看到同一名字在多个密度目录下各有文件；如果搜不到任何图片文件，八成它指向的是一张矢量图 —— 这本身就是重要线索，说明"替换 PNG"这条路走不通。
3. 确认它没有被别处复用。 顺手看看这个名字还有没有出现在桌面图标、快捷方式之类的位置。如果小图标和别处共用了同一个资源，改动它就会连带影响别处 —— 这时候更稳的做法是给通知单独准备一张图、把引用换过去，而不是硬改那张公用的。

顺带把"一个应用里的图标家族"列清楚，避免以后再拿错对象。它们看起来都叫"图标"，规范却各不相同：

图标	用在哪	规范要点
启动器图标	桌面、应用列表、"设置"里的应用条目	彩色、可带背景、可用分层图
通知小图标	状态栏、通知条目左侧	单色剪影、背景透明、画布约 24 像素
通知大图标	通知展开后的那张图	可以是彩色，尺寸通常按更大的画布准备
快捷方式图标	应用自己创建的桌面快捷方式	彩色，跟随创建它的那次调用
应用内图标	界面上的按钮、标签、列表项	跟随应用的界面风格，与系统规范无关

这张表最实用的一栏是"用在哪"。很多"改了没变"的疑问，其实只要先问一句"我要改的到底是哪一行里的东西"，答案就自己出来了：桌面上的、状态栏上的、通知展开后的，各是各的资源，改一处不会自动带上另一处。

三、大图标、通知渠道：一张通知上其实有三个"角色"

很多"改了没变"的问题，根源在于把三个不同的角色混成了一个。一条通知上，与图标和显示相关的东西其实是三份：

三者混起来会踩的坑，集中在两件事上。

第一件事：渠道的打扰级别会直接影响"你还能不能在状态栏看到那个小图标"。 如果这个渠道被设定为最低的静音级别，通知就只在通知栏里安静地出现，状态栏上根本不会挂图标。于是"我换了图标但状态栏没变化"有一类原因根本不是图标，而是这条通知压根不上状态栏。排查时先确认渠道级别，再看图标，顺序反了会白折腾。

第二件事：渠道一旦被创建，系统侧就记住了它。 渠道的名称与描述可以由应用在后续版本里再次提交更新，但重要性、声音、震动这些"行为"从创建那一刻起就归用户掌控、应用改不动；更要命的是，很多项目为了不覆盖用户的设置，写的是"先查渠道在不在，在就直接跳过创建" —— 结果就是你把代码里的渠道名改了，它永远不会被重新提交，系统里显示的仍是第一次那份。所以改通知相关的文案或分类时，验证前先把这个应用卸载重装（或在系统设置里清除应用数据），否则你看到的可能是上一版的渠道记录。另外也别忘了一条硬规则：目标版本较新的应用如果没有给通知创建渠道，那条通知根本不会显示 —— 这类"通知完全不出现"的问题，也要先查渠道有没有建。

顺带补一条近年新增的门槛：新版本的系统把"能不能发通知"也变成了需要用户授权的运行时权限（和相机、定位是一个机制）。新装的应用默认可能没有这个授权，于是"装上去完全没有通知" —— 这跟图标、跟渠道都无关，是授权没给。验收通知类改动时，第一眼先看应用有没有通知权限，能省掉一大类误判。

一条通知的三个角色，各查各的：看不到图标 → 查渠道级别与通知权限；图标是白块 → 查小图标的 alpha；彩色图没显示 → 查大图标，且在展开状态看。三个方向不混，排查时间从一下午变成三分钟。

四、改完怎么验证：五步核对，别只看一眼

通知是在"系统界面"上显示的，验证链路比应用内的改动长一点。下面五步按顺序做，每一步确认一件事，全部走完才算真的验完。

1. 先让包真的装上、跑起来。 打包完勾选"打包后自动运行"，程序会用 adb 找手机或模拟器、装包并拉起应用：手机走屏幕投屏、模拟器把窗口提到最前；拉起用的是系统命令而不是那种"失败了也报成功"的老办法，装完还会复核一次前台应用到底是不是它 —— 这一步保证你看的是刚打的那个包，而不是设备上残留的旧版本。
2. 确认通知权限与渠道级别。 进系统设置里这个应用的通知页，看通知是否被允许、这条渠道的打扰级别是不是"静音"（静音级别不会在状态栏挂图标）。这一步能把"图标问题"和"根本没显示"分开。
3. 让通知重新发一次。 清掉通知栏上残留的旧通知，触发一次会发通知的操作（或重启设备）。新发出来的那条才是这一版的真面目。
4. 分两处看图标。 先看状态栏的小图标 —— 形状是否清晰、是否还是白块；再把通知展开，看大图标是不是你要的那张彩色图。两处看的是两个不同的资源，缺一处都可能漏判。
5. 换台设备再对一次。 至少在两台不同版本/不同品牌的设备上看一眼：一台能覆盖旧系统对图标的处理方式，一台覆盖新系统。同一张图在新旧系统上的表现不完全一样，两台都正常，才算这次改动真的稳。

如果验证时发现"图标没变"，也先别怀疑改动：按第三章那条铁律，先确认渠道是不是缓存了旧记录（卸载重装再看一次）。这一步做过之后仍然不对，再回到第二章的表格逐条排查，顺序对了基本不会走弯路。

五、一份可以直接照做的通知图标素材准备清单

把前面的规则收成一份清单。下次让设计出图、或者自己动手做，照着这份清单走就能一次过。

这份清单还有一个用法：把它贴给设计或外包，作为"交付标准"的一部分 —— 通知类图标之所以反复返工，多半是因为出图的人不知道状态栏上只会显示一个单色剪影，交上来的自然是一张彩色方图。一次把规则讲清，之后每一版素材都能一次过。

素材准备好之后，把这一整套图放进附件一起发出去，是最省事也最不容易出错的做法：点「选择附件」一次多选几个文件，每个文件写一句用途说明。这里有一条硬规则正好用在图标上 —— 每个附件的说明不少于 10 个字，因为一张叫 ic_stat_notify.png 的图和一张叫 logo_new.png 的图，对 AI 来说没有任何语义差别 —— 只有"这张是通知小图标，24 像素单色、背景透明"这样的说明，才能让它把图放对位置。附件在加入前还会被逐个校验（存在、不是目录、不是 0 字节、能读出来），同一个路径重复选择会自动去重。

顺便说清一个分层：需求原文会进修改历史，附件说明不会。 历史里只留你自己写的那句话 —— 回看时干净，点「选择」就能把那条需求填回输入框，照着上次再来一遍。图标类改动特别适合这么用：第一次把"哪张图、放在哪个位置、什么规格"说清楚，之后每次换素材只要重新附加文件、复用那条需求即可。如果连需求都不知道怎么写，界面上的话术库里有 6 大分类共 3000 条成型指令（每条都把要做什么、细节要求、参数参考、范围、验收写全），点「选择」填进输入框、点「复制」复制正文；话术库的内容放在程序目录下的 Resources\话术库.xml，可以自己加几条团队专用的"通知图标替换"规范，改完点刷新重新读。

六、工具侧：它是怎么把图标从包里挑出来的

上面讲的是"图标该长什么样"，这一章讲"工具怎么拿到图标" —— 两件事合起来，你才能理解项目里看到的那张"应用图标"和通知里那个"小图标"之间的关系。

导入安装包时，工具会用工作目录里自带的 aapt 解析包信息，其中一步就是让 aapt 报出各密度档下应用图标的路径。这里有一个踩过的坑值得写进来：aapt 报出来的密度值里会出现一个 65534，它不是"最高密度"，而是表示"任意密度"的哨兵值 —— 如果把它当成最高密度去比较，就会挑到一张很小的图。所以工具的选择逻辑只认 1 到 640 这个区间内的真实密度档（640 就是真实存在的最高档），在这个范围内挑密度最高的那一张原图。

还有两条相邻的设计也很关键：第一，aapt 给出的路径有可能指向自适应图标的那份配置（不是图片文件），这时工具不会硬用它，而是在包里按"名字 + 分辨率"重新挑一张最像启动图标的：以标准启动图标名为最高优先，其次是以图标命名的图，圆角版会降一档，自适应图标的前景与背景图层也降一档，图片格式优先于新一代压缩格式，mipmap 目录与更高密度都会加分。这套打分的意义在于：尽量挑到"你在桌面上看到的那张图"，而不是某个图层碎片。

第二，遇到界面显示不了的原图，它照样把原图存下来。 如果图标是新一代压缩格式而系统缺少对应解码器，项目页面上会退化成文字头像 —— 但这是"界面显示"层面的退让，原图已经被原样保存进项目目录（文件名跟随原格式），可以直接拿去做素材、比对或替换。这一点对通知图标排查很有用：工具里的图标显示不出来，不代表这张图有问题；反过来，工具里显示得很漂亮的图标，也只是"应用图标"，和通知小图标是两套资源。

顺带说清项目里的图标是怎么存的，因为它直接关系到"换素材"的顺手程度：从包里取出的原图会被原样写进项目目录，扩展名跟着原格式走（是 PNG 就是 .png，是新一代压缩格式就是那个格式），项目配置里记的是相对文件名而不是硬盘上的绝对路径 —— 这样整个项目目录拷到别的盘、别的工作目录，图标依然找得到。要对照"这张图到底长什么样"，直接打开项目目录里那份原图就行，不用再回包里翻。

这最后一句值得再强调一次，因为它是很多误会的源头：项目详情页上那张图是启动器图标（给桌面用的），而状态栏上那个白色剪影是通知小图标（给通知用的）；前者的规范是多彩、可带背景、可用自适应图层，后者的规范是单色、透明、24 像素 —— 两套规范正相反。所以"我把应用图标换成新的了，通知里怎么没变"这种疑问，答案是：你改的是另一套资源，通知那张图还在原地等你。正确做法是先定位通知用的资源名（在创建通知的那几行代码里），再成套替换它的所有密度版本。

七、两个自家实例：从白块到一眼就对

下面两个例子都发生在自家应用和内部工具上，重点看"以前怎么做、现在一句话怎么做、改完怎么验证"。

实例一：内部「巡检打卡」的通知小图标变成白块。

事情的起因很典型：运营同事做了一张很漂亮的通知图标 —— 圆角底色加白色图形，PNG 格式、色彩饱满。替换进包里之后，状态栏上的通知变成了一个白色方块。以前的做法是在包里逐张翻图标文件、反复替换尝试，试到第三版才隐约意识到"系统只取形状"这件事，最后靠手工把背景抠掉收场；整个过程没有明确的判断依据，全靠感觉。

现在一句话，而且把规格写进需求："把通知的小图标换成附件里的这张图：只用图形本身、背景透明、按 24 像素画布居中留边，各密度目录下的同名文件成套替换；桌面图标与其它资源不要动。"附件里放上按五个密度导出的图，并在用途说明里写清"这是通知小图标，单色透明背景"（说明超过 10 个字，这条硬要求在这里正好帮上忙）。点「立刻修改」之后，AI 定位到通知实际引用的那个资源名，把各密度版本逐一换掉；改完留标志文件，主窗口读到即自动打包。

改完怎么验证：勾上打包后自动运行，装到设备上触发一次会发通知的操作，然后先看状态栏、再展开通知：状态栏上是一个清晰的白色剪影（不再是方块），展开后如果大图标还挂着原来的彩色图，那正好说明你只动了该动的那一份。最后换一台系统版本不同的设备再看一眼，确认两头都正常。

实例二：自家「记账助手」把通知的图标与分类名称一起改掉。

这个应用的通知分几类（记账提醒、月末汇总、活动通知），这次要统一换成新的品牌剪影，并把分类的名称按新叫法改一遍。以前的做法是改完代码、打包装机，然后在通知设置页看到分类名称还是旧的 —— 折腾半天才想到是系统侧记着旧记录，最后靠卸载重装才看到新名字；而且当时还顺手把桌面图标也换了一版，结果通知里一点变化都没有（改的是另一套资源）。

现在拆成两句话发。第一句解决图标："把通知的小图标换成附件里的新剪影（各密度目录成套替换），同时把通知分类的名称与描述改成下面这几条（写在需求里）；桌面图标这次不动。"第二句专门交代验证前提："这次要对比渠道名称，验证时会卸载重装，测试设备上没有需要保留的数据。"—— 别小看这句：它会直接影响你后面看到的结论是否可信。

改完怎么验证：先卸载旧版再装新包（清掉系统侧的渠道记录），触发三类通知各一次，确认三条通知的剪影都正确、分类名称与描述都是新叫法；再进系统设置的通知页，确认权限与分类级别没有被改乱。回到项目里，这条需求原文还留在修改历史里，下次换素材时点「选择」填回输入框、重新附上新图即可。

两个例子合起来说明一件事：通知类改动的难点不在"换图"，而在"知道有几个角色、每个角色归谁管"。 小图标归形状规范管，大图标归每条通知管，分类名称归系统侧的记录管 —— 三个都点在需求里，一次就能改干净。

八、用户评价：他们是怎么把白块改回去的

以下引述来自内部试用与技术交流群里的使用体验整理，属于体验性反馈（文案性内容，非官方统计口径），供你对照自己的场景参考。

九、结语：白块不是故障，是规范在提醒你

把这篇收成一句话：通知小图标是"只取形状、会统一上色"的剪影，透明通道才是它的正文；白块的成因九成出在这一点上，剩下的一成出在"改错了资源"和"渠道缓存"。 记住三个角色（小图标管形状、大图标管颜色、渠道管打扰级别与分类名称），记住五步验证（装上、看权限与级别、重发通知、分两处看图标、换台设备再对），再配上一份按规范出的素材，通知图标这类改动就变成了一件很确定的事。

这也是安卓修改大师智改工坊希望给你的那种确定性：只需说话，就能让应用变成你想要的样子 —— 你把"哪张图、放在哪个位置、什么规格、哪些不要动"说清楚，剩下的事情交给流程：AI 在摊平后的工程里定位资源并成套替换，主窗口等标志文件、跑完回编对齐签名校验四步，再把包装到设备上让你亲眼确认。产品介绍页与下载入口：https://www.apkeditor.cn/ai-version.aspx（官网 www.apkeditor.cn）。