#oboard/assets

#概述

• 扫描指定目录并生成一个 assets.mbt 文件。
• 输出变量类型为 FileEntry，用树状结构表示目录：
  • Dir(Map[String, FileEntry])
  • File(Bytes)
• 可选择生成 pub 变量或私有变量。

#快速开始

moon add oboard/assets
moon run . -C ./.mooncakes/oboard/assets -- --dir assets --output assets.mbt --var assets --pub

./example.sh

默认示例会：

• 扫描 ./assets 目录
• 生成文件 ./assets.mbt
• 输出变量名为 assets_1
• 变量为 pub（可在其他模块使用）

#命令行参数

• --dir, -d：资源目录（可选，默认 assets）。
• --output, -o：输出文件路径（可选，默认 assets.mbt）。
• --var, -v：生成的变量名（可选，默认 assets）。
• --pub, -p：是否生成 pub 变量（可选，默认否）。
• --include-entry, -i：是否包含 FileEntry 结构（可选，默认否）。

#输出示例

pub let assets_1: FileEntry = Dir({
  "images": Dir({"1.png": File(b"")}),
  "1.txt": File(b"\x74\x65\x73\x74")
})

• 1.txt 的内容是 test，以字节序列内嵌。
• images/1.png 在示例中是空字节，只作结构展示。

#在代码中使用

• 将生成的 assets.mbt 放在你的工程中作为普通源码文件参与编译。
• 直接引用生成的变量名（例如 assets_1 或你指定的 --var 名）。
• 你可以根据 FileEntry 的结构递归访问目录、读取字节等。

#注意事项

• 输出文件会被覆盖，请谨慎设置 --output 路径。
• 大体积二进制资源会显著增加编译产物体积，权衡使用。
• 本工具不做压缩与去重，只做原样字节嵌入与结构序列化。

#许可