搞安卓定制的朋友应该都碰过开机动画这东西看起来就是个 zip 包但里面那个desc.txt一旦写错轻则黑屏半天起不来重则开机动画直接不显示、卡在 logo 不动。尤其是现在 Android 16 的 boot 流程和分区校验越来越严很多老一套的改法已经不好使了。我这段时间正好在做 RK3568 平台和几台高通机型的开机动画定制踩了不少坑也把 desc.txt 的规则彻底摸了一遍这篇就把修改逻辑、参数计算、打包签名这些环节完整捋清楚。先说清一个概念Android 的开机动画本质上不是视频而是按帧播放的 PNG 图片序列。系统开机时通过bootanimation这个 native 进程去解析/system/media/bootanimation.zip部分机型也可能是/oem/media/或/product/media/desc.txt就是整个动画的“导演脚本”它决定图片按什么顺序、什么尺寸、什么帧率播放以及播放多少次。所以改开机动画核心工作就是改这个 txt 和里面的图片目录。1. 先搞清楚开机动画的运行机制再动手改文件1.1 bootanimation 进程的启动链路不少同学上来直接改 desc.txt结果发现改了没效果或者开机动画直接没了。这通常是因为没搞懂 Android 系统是在哪个阶段、由谁去读这个文件的。在 Android 16 上开机动画的加载链路大概是这样的Kernel 启动完成后init 进程解析init.rc其中有一个关键服务叫bootanim它执行的二进制就是/system/bin/bootanimation。bootanimation启动后会先去读取系统属性persist.sys.boot.animation或者默认路径下的bootanimation.zip。解压 zip 后第一件事就是解析desc.txt按描述文件里的字段去加载对应的帧目录。同时 SurfaceFlinger 已经起来了bootanimation 通过它把每一帧图像提交到屏幕上形成动画效果。开机动画播放结束或收到boot_completed属性变化后进程退出系统切换到桌面。Android 16 相比老版本变化比较大的地方是分区只读校验更强、/system分区默认是 EROFS 或 ext4 只读挂载如果你没有 root 或者没解锁 bootloader直接去改 system 里的 zip 是写不进去的。所以现在的常规做法是做“覆盖式定制”通过vendor分区、oem分区或者product分区里的同名文件去覆盖默认路径或者直接用临时挂载 overlay 的方式替换。1.2 为什么要改 desc.txt 而不是只换图片很多人以为换开机动画 换图片实际上如果你只替换了part0里的 PNG但 desc.txt 里写的解析逻辑还是老样子的可能出现两种情况图片尺寸不匹配导致黑边、拉伸帧数太多但 desc.txt 里定义的总帧数只有 20 帧后面的图根本不会播。desc.txt 里定义的核心信息包括动画的宽和高单位像素帧率fps播放模式静态、循环、按次播放每个 part 的目录名、循环次数、暂停时间所以它是整个动画的“心脏”图片只是素材。改动画逻辑必须同步改 desc.txt。1.3 搞清楚文件结构再下手一个标准的 bootanimation.zip 内部结构如下bootanimation.zip ├── desc.txt ├── part0/ │ ├── 00000.png │ ├── 00001.png │ ├── ... │ └── 00039.png └── part1/ ├── 00000.png ├── ... └── 00019.pngdesc.txt 示例内容最常见写法720 1280 30 p 1 0 part0 p 0 10 part1逐行解释第一行是全局参数宽度 高度 帧率这里是 720x128030 帧/秒。第二行p 1 0 part0表示播放part0目录 1 次播放结束后停顿 0 帧立即进入下一个 part。第三行p 0 10 part1表示part1目录循环播放0 表示无限循环每次循环结束后暂停 10 帧的时间。如果你想把动画做成“播一次就停”把最后一行改成p 1 0 part1即可。2. desc.txt 逐字段拆解参数含义和常见写法一次讲透2.1 第一行全局参数宽、高、帧率第一行的720 1280 30是最容易出问题的地方。很多人会把这里理解成“图片的最大尺寸”其实它是一个全局缩放基准。bootanimation 进程在播放时会以这里的宽高作为基准去适配屏幕。如果你的屏幕是 1080x2400但 desc.txt 写的是 720x1280动画会被拉伸到全屏图片本身如果也是 720x1280 就会被模糊放大。这里建议的做法是按屏幕实际分辨率写。你可以在 adb shell 里执行wm size拿到类似Physical size: 1440x3120的输出然后 desc.txt 第一行就写1440 3120 30。图片素材也按这个尺寸做才能保证锐利。帧率的选择同样有讲究。常见的是 30也有用 60 的。帧率越高动画越流畅但 zip 包体积会暴增而且低端设备在开机阶段 CPU 频率还没拉高高帧率动画容易掉帧甚至卡死。我的经验是非特殊需求一律 30如果想要顺滑一些可以 24~30 之间取一个60 除非是演示机否则不建议。2.2 第二行开始的 p 指令播放策略p 指令的格式是p 循环次数 暂停帧数 目录名循环次数0代表无限循环正整数代表播放完该次数后进入下一个 part如果这是最后一个 part则动画结束。暂停帧数每次循环结束后额外停顿多少帧不是秒是帧常用于在两个 part 之间做短暂停留制造“停顿感”。目录名对应 zip 内的图片目录。举个例子一个常见的三段式动画1080 2400 30 p 1 0 part0 p 0 10 part1意思是part0 播放 1 次一般是 logo 出现、放大消失的过程然后 part1 无限循环一般是“系统正在启动”之类的循环 loading 效果每次循环结束停 10 帧约 0.33 秒。2.3 多 part 的衔接逻辑和注意事项多 part 场景下图片数量要按“总帧数 帧率 × 时长”来准备。比如你希望第一个动画播放 2 秒帧率 30那 part0 里就应该放 60 张 PNG。系统按文件名顺序读取常见命名规则是00000.png、00001.png……注意必须是 5 位数字。还要注意所有 part 目录里的图片命名要连续、从 0 开始。如果中间缺了某个编号bootanimation 会提前结束当前 part甚至导致整个动画闪退。2.4 常见 desc.txt 错误写法避坑有一种老教程会把 desc.txt 写成720 1280 30 p 1 0 part0 p 1 0 part1这在老版本没问题但在部分高版本设备上第二个 part 播完就没了动画结束得很突兀桌面出现前会有一黑屏。更稳妥的做法是用一个“结束帧”在 part0 里完成收尾或者让最后一个 part 循环播放直到系统启动完成。在 Android 16 上如果动画提前结束但系统还没启动好屏幕上会一直停在 bootanimation 最后停留的那一帧然后才跳到桌面看起来就像卡死了一样其实是在等 SystemUI 启动。3. 完整实操解包、修改、打包、替换一步不落3.1 工具准备和基础环境要求修改 bootanimation.zip 不需要编译整个系统只要有解压/压缩工具、图片处理工具就行。我自己常用的组合是7-Zip 或 Linux 下的zip命令打包压缩GIMP 或 Photoshop批量处理 PNGadb推送到设备测试任意文本编辑器改 desc.txt推荐 VS Code注意编码必须 UTF-8 无 BOM如果是在 Windows 上操作建议装一个Notepad3之类能显示编码的工具避免 Windows 记事本把 txt 存成带 BOM 的 UTF-8这会导致第一行解析失败。这个问题我见过很多次症状是开机动画完全没有黑屏一段时间直接进桌面。3.2 解包并查看原始 desc.txt这一节以一台 android 16 的测试机为例。先用 adb 把原始 zip 拉出来adb root adb remount adb pull /system/media/bootanimation.zip如果你已经 root也可以直接从/product/media/或者/oem/media/下找。有些国产 ROM 会把开机动画放在/system/media/把关机动画放在/system/media/shutanimation.zip注意区分。拉到本地后解压看 desc.txtmkdir bootanim_extract cd bootanim_extract unzip ../bootanimation.zip cat desc.txt看到一个典型的原始内容1080 2400 30 p 1 0 part0 p 0 0 part1不用急着改先把 part0 和 part1 的图片数量统计一下ls part0 | wc -l ls part1 | wc -l比如 part0 有 90 张、part1 有 120 张那么原始设计就是“播放 3 秒动画 无限循环 4 秒动画”。3.3 修改 desc.txt 的具体步骤假设我的需求是把第一段动画改成 2 秒60 帧第二段循环动画改成 5 秒后停住不要无限循环。那么新的 desc.txt 这样写1080 2400 30 p 1 0 part0 p 1 150 part1解释part0 播放 1 次、停 0 帧part1 播放 1 次、结束后暂停 150 帧即 5 秒。但要注意这里暂停是在最后一次循环之后不是每次循环后都暂停。也就是说 part1 播完一次后动画就停了但后面还“挂在”最后一帧 5 秒然后退出。如果想让 part1 循环 3 次每次之间停 5 帧最后停 0 帧就写p 3 5 part1注意这个5是每次循环结束后都暂停 5 帧包括最后一次。如果最后不想停就不能用这种写法要拆成两个 part 或在图片素材里多复制几帧来做停顿。3.4 打包时必须注意的压缩方式很多人在这一步翻车。bootanimation.zip 不是随便 zip 一下就能用不能使用压缩率极高的方式也不能在 zip 里带有顶层目录。标准要求是压缩方式建议用“存储Stored”或“仅存储”至少不要用 LZMA 这类高压缩算法。实测部分老版本 bootanimation 进程解析不了高压缩 zip会直接跳过动画。zip 内路径不能包含顶层文件夹desc.txt必须在压缩包根目录。文件名编码建议保持 ASCII不要有中文。Linux 下推荐这样打包cd bootanim_extract zip -0 -r ../bootanimation.zip desc.txt part0 part1-0表示不压缩纯存储。-r表示递归。注意这里的desc.txt、part0、part1都是相对路径不要带./前缀。Windows 下用 7-Zip 时压缩方式选“存储”压缩级别选“仅存储”并且确保打开 zip 后第一层就是这些文件和目录。3.5 替换到系统并验证打包完成后先把新 zip 推到/data/local/tmp下做验证adb push bootanimation.zip /data/local/tmp/ adb shell cd /data/local/tmp cp bootanimation.zip /system/media/bootanimation.zip chmod 644 /system/media/bootanimation.zip如果你有 root 并且已经 remount 了系统分区这个操作是可以成功的。完成后重启看效果adb reboot如果动画没生效先不要急着重启执行一次setprop ctl.stop bootanim setprop ctl.start bootanim可以热切换不用重启系统就能预览。3.6 免 root 替换方案的说明如果你的设备没有 root但 bootloader 已解锁可以走 boot 镜像内嵌或者动态分区 overlay 的方式这超出了单篇教程的范畴简单说就是你可以在vendor分区里放一个 bootanimation.zip同时通过 overlay 机制让它覆盖/system/media下的同名文件。具体操作在 Android 16 上依赖于overlayfs需要你修改fstab并启用对应的 mount 配置。这块不建议新手直接搞容易把系统弄成无法开机。4. 常见问题与排查技巧实录遇到黑屏先别慌4.1 开机动画不显示、黑屏后直接进桌面这通常不是图片问题而是 desc.txt 解析失败。先确认编码是否是 UTF-8 无 BOM第一行有没有多余空格比如1080 2400 30后面多了个空格某些严格解析会崩。换行符是不是 LFWindows 记事本默认 CRLF在 Android 上解析时可能异常。修好这几项重新打包测试大概率解决。我遇到过最离谱的一次是 desc.txt 文件名被改成了desc.txt.txt系统找不到文件直接跳过动画。4.2 有动画但画面拉伸、变形或出现黑边这是宽高参数和图片尺寸不一致导致的。建议在修改前统一确认“屏幕物理分辨率”“图片实际分辨率”“desc.txt 第一行宽高”三者的关系。如果有黑边多半是图片尺寸小于屏幕分辨率系统按原比例居中显示如果拉伸多半是图片分辨率与屏幕比例不一致。比如屏幕是 20:9但图片是 16:9就会明显变形。一个稳妥做法是图片按屏幕比例裁切desc.txt 写屏幕物理分辨率。不要为了省素材体积把图片宽度缩小因为放大后模糊比黑边更难看。4.3 动画只播放 part0不进入 part1一般是 part1 路径写错了或者目录里没有任何 PNG。bootanimation 在解析不到帧时会直接跳过该 part。检查 zip 里part1/*.png是否存在以及命名是否为00000.png开头。4.4 动画播放速度过快或过慢这是帧率问题。desc.txt 第一行的 fps 和实际图片数量不匹配。比如你希望播 3 秒素材 90 张那 fps 应写 30。如果你 fps 写 60播放时间会缩到 1.5 秒看起来就像“快进”。另外要注意部分设备有“快启动”策略开机动画会在系统 boot 完成前强制退出这种情况下不是你的参数问题是系统急着进桌面不要浪费时间去调帧率。4.5 边角有残留的静态 logo这种情况在系统默认开机动画里常见。Android 内核启动后会先显示一个静态 logologo.bmp然后 bootanimation 接管。如果你看到的是一张图固定不动几秒然后才开始动那不是你的动画卡住而是 logo 阶段。要改这部分需要去改内核里的 logo 图片和 bootanimation.zip 无关。这块很多人误解先说明白免得白忙。4.6 快速排查速查表症状可能原因排查方向无动画黑屏desc.txt 解析失败编码、换行符、第一行格式动画结束时黑屏几秒最后一个 part 播放次数有限早于系统启动完成把最后 part 改无限循环拉伸变形宽高参数与屏幕不匹配用 wm size 查实际分辨率静态画面不切换zip 压缩方式不对重新打包用存储模式只播一个部分part 路径或素材缺失检查目录和 PNG 命名动画播完但停不下来最后 part 设为无限循环改固定次数加暂停帧数4.7 关于 Android 16 的新变化和避坑经验到了 Android 16有几个点值得单独说动态分区和只读系统分区进一步普及手动 remount 失败的概率变高。如果adb remount报错建议用adb disable-verity需要解锁 bootloader再重试。部分设备对 zip 的校验更严格要求desc.txt以换行符结尾否则解析到最后一行可能崩溃。建议修改后统一在文件最后按一个回车。使用p 0 0 part1这种无限循环写法时如果 part1 的图片数量太少循环切换会非常生硬。我一般会确保循环 part 至少 10~20 帧并能构成一个完整的视觉闭环否则看起来就像卡顿。如果你的设备有“关机动画”它就是另一个 zip修改方式完全一样只是路径不同。碰到关机动画不生效优先检查路径而不是怀疑 desc.txt 写错。5. 高效制作和测试流程以及自动化批处理的思路5.1 批量生成和调整图片素材做动画最麻烦的是图片素材。手头有视频素材时可以用 ffmpeg 批量转帧ffmpeg -i input.mp4 -vf scale1080:2400 -start_number 0 part0/%05d.png注意把分辨率按设备实际值调整。处理完记得确认生成的第一张是00000.png并清理掉所有非 PNG 文件。如果是自己用 Photoshop 或 GIMP 设计的一整套图导出的命名规则也要统一。我习惯用“5位数字 下划线 描述”的方式命名比如00000_logo.pngbootanimation 会忽略下划线后的部分但保留 .png 后缀即可。不过为了保险起见建议文件名只保留数字避免某些解析器不识别。5.2 desc.txt 变体用法关机动画和充电动画关机动画的 desc.txt 格式和开机动画完全一样只是存放路径不同。充电动画则不在 bootanimation 进程管理范围内通常是 framework 直接读帧路径一般在/system/media/或/product/media/下文件名可能是charging_animation.zip之类。改之前先用命令行找一下adb shell find /system /product /oem -name *animation* -o -name *charging*搜出来的路径才是你真正要改的目标。5.3 用脚本做自动打包和推送手动操作多了会烦而且容易漏步骤。我习惯写一个简单的打包推送脚本#!/bin/bash cd bootanim_extract zip -0 -r ../bootanimation.zip desc.txt part0 part1 adb push ../bootanimation.zip /data/local/tmp/ adb shell cp /data/local/tmp/bootanimation.zip /system/media/bootanimation.zip chmod 644 /system/media/bootanimation.zip adb shell setprop ctl.stop bootanim; setprop ctl.start bootanim脚本跑完直接热切换预览不用反复重启。这里提个醒setprop ctl.start bootanim如果在系统已经 boot 完成后执行部分机型能正常显示动画但有的机型因为 SurfaceFlinger 状态不对热切换会黑屏几秒这是正常现象不用慌。5.4 记录每次修改方便回滚这是个很容易被忽略但极其重要的习惯。bootanimation.zip 不像普通应用能随便卸载重装改错了想恢复如果没有备份原始文件会非常被动。我在本地目录维护了一个历史版本文件夹每次改之前先把原包cp进去命名带时间戳cp bootanimation.zip backups/bootanimation_$(date %Y%m%d_%H%M%S).zip这样即使改得面目全非也能一键恢复。6. desc.txt 高级用法和进阶定制思路6.1 多分辨率适配如果你的固件要跑在一批屏幕分辨率不同的设备上不建议为每台设备做一套 zip。虽然 desc.txt 支持“自动缩放”的语义但实际效果并不可靠。更稳的方案是图片用最大分辨率做一份desc.txt 写最大分辨率让 bootanimation 的缩放能力去适配小屏。放大模糊缩小相对可接受所以统一用最大尺寸更省事。另一种做法是通过系统属性动态选择 zip这需要改 bootanimation 的源代码或 init.rc适合有完整源码环境的团队量产机型用户一般不碰。6.2 在动画中加入类似“读条”的效果开机动画也可以实现进度条效果原理是播放最后一帧时根据系统启动进度做进度映射。但这个功能 bootanimation 原生不支持需要改 native 代码不是改 desc.txt 能搞定的。简单替代方案是做一个“循环转圈”动画这也是绝大多数国产 ROM 的做法视觉上已经有了“正在加载”的心理暗示。6.3 动态使用不同动画的思路Android 16 上有一些定制系统支持根据当前主题切换开机动画实现方式通常是复制多份 zip 到不同目录然后在 framework 层通过 overlay 或属性动态选择。对于普通用户来说能做到的就是在 root 后用 magisk 模块挂载不同动画包。6.4 关于开机动画包体积和性能zip 体积越做越大开机时解压时间变长会影响启动速度。建议单张 PNG 控制体积使用优化过的调色板或把图片压缩到 256 色以内如果动画对颜色不敏感。实测下来同样 30 帧动画调色板优化后 zip 体积能缩小一半左右解压耗时也明显下降。如果一定要大尺寸、高帧率那就用存储模式打包尽量减少 CPU 解压负担。7. 最后分享一个实际项目中的踩坑记录和心得我在给某款基于 Android 16 的 RK3568 设备做开机动画时第一次替换完重启后开机动画正常但随后系统一直启动不起来卡在 bootanimation 结束后黑屏。排查了很久才发现不是动画的问题而是动画播完后系统在等待sys.boot_completed属性但因为我同时改了build.prop里某些跟启动相关的参数导致 SystemUI 一直没起来。把这个还原后才恢复正常。另一个印象很深的坑是同事在 Windows 下用自带记事本改了 desc.txt存成了UTF-8 with BOM结果动画全程黑屏重新用 VS Code 改存为 UTF-8 无 BOM 后一切正常。这个坑非常隐蔽因为 desc.txt 在 Windows 下看起来完全没问题但 Android 端不认 BOM 头。所以如果你是在 Windows 上改 desc.txt建议改完后用 hex 工具确认文件开头是70字符 p而不是EF BB BF。还有一次是在打包时用了 Windows 默认的 zip 工具打出来的包在 Android 上解析时提示 zip 格式非法。后来换成 7-Zip 的存储模式才解决。如果你发现开机动画在部分设备上失效先检查 zip 是不是“仅存储”方式打的。改开机动画这件事技术上不难但细节多尤其是 desc.txt 这种“一行定生死”的文件错了不会有任何报错提示表现出来就是动画没了或黑屏。按上面这套流程走先确认宽高、帧率、part 播放逻辑再统一图片素材分辨率打包用存储模式替换前备份原始文件每一步都验证基本就不会出幺蛾子。希望这篇能帮你在 Android 16 上把开机动画定制这条路走顺。