feat(assets): embed LCD and audio resources in OTA app

2026-10-08 16:58:33 +08:00
parent 3160a33f50
commit 7bc9a3dc76
43 changed files with 443 additions and 243 deletions
@@ -4,7 +4,7 @@

 固件使用的 LCD 为 RGB565 显示格式，而设计工具导出的 PNG 通常是 RGB888 或 RGBA8888。原始 PNG 中包含 LCD 无法显示的颜色精度，部分图片还携带未实际使用的 Alpha 通道。

-本项目在不改变 LCD 最终 RGB565 像素的前提下，将固件图片转换成 RGB565 颜色精度，并在颜色数量不超过 256 时保存为索引色 PNG，以降低 `gifpack` LittleFS 分区的占用。
+本项目在不改变 LCD 最终 RGB565 像素的前提下，将固件图片转换成 RGB565 颜色精度，并在颜色数量不超过 256 时保存为索引色 PNG，以降低应用镜像中的素材占用。

 正常固件编译直接使用已经提交到 Git 的优化图片，不要求开发环境安装 Pillow。只有修改或验证图片资源时才需要 Pillow。

@@ -16,9 +16,9 @@ components/platform/assets/
 └── lcd_optimized/    优化图片和 manifest.json，固件实际使用
 ```

-两个目录中的 PNG 文件名必须一致。运行时路径仍为 `/lcd/<文件名>.png`，业务代码不需要区分原图和优化图。
+两个目录中的 PNG 文件名必须一致。运行时逻辑名称为 `lcd/<文件名>.png`，业务代码不需要区分原图和优化图。

-`lcd_source` 中的 `OTA.gif` 是历史资源，不属于当前 PNG 优化和 `gifpack` 打包清单。
+`lcd_source` 中的 `OTA.gif` 是历史资源，不属于当前 PNG 优化和嵌入素材清单。

 ## 优化规则

@@ -81,7 +81,7 @@ components/platform/assets/lcd_optimized/manifest.json
 - 优化图片没有缺失或被手动修改；
 - 原图、优化图和清单中的文件集合一致。

-资源过期时，构建会停止并提示重新运行 `generate`。资源有效时，构建系统把 `lcd_optimized` 中的 PNG 复制到构建目录并生成 `gifpack` 分区镜像。
+资源过期时，构建会停止并提示重新运行 `generate`。资源有效时，构建系统把 `lcd_optimized` 中的 PNG 复制到构建目录，生成只读素材包并链接到应用镜像。

 ## 命令说明