很多人误以为将 PNG 转为 .ico 只需要直接修改文件扩展名。如果直接将 logo.png 重命名为 logo.ico,Windows Visual Studio 资源编译器(rc.exe)、Inno Setup 安装包、Electron Builder 以及 Tauri 构建流程都会直接报错并拒绝该文件。
Utiliome 利用 ArrayBuffer 和 DataView 直接在你的浏览器本地构建符合规范的低字节序(little-endian)二进制 .ico 缓冲区:
- 6 字节
ICONDIR文件头: 写入0x0000(保留字段)、0x0001(类型1= Windows 图标),以及内嵌分辨率图层总数的uint16计数。 - 每个图层 16 字节的
ICONDIRENTRY目录表: 针对所选的每个分辨率(16、24、32、48、64、128、256),写入像素宽度与高度(根据 Windows Vista+ 规范,0代表256px)、颜色平面数(1)、每像素位数(32位 RGBA 透明通道)、字节长度以及精确的字节偏移量。 - 32 位 RGBA PNG 帧数据: 在计算好的字节偏移量位置依次拼接经过高质量重采样的 PNG 图像帧。