打包资源

把不会编译进可执行文件的应用文件放在 resources/ 目录：图像、模板、JSON 和其他数据。CLI 会把该目录的内容复制进打包后的应用。运行中的应用从 AppPaths::resource_dir() 读取它们，不依赖启动时的工作目录。

若要在编译期嵌入字节，使用 BundledAssets 和 Application::assets。自定义字体是单独的选项。见字体。

#resources 目录

my-app/
├── resources/
│   ├── icon.png
│   ├── hero.png
│   └── copy/
│       └── template.txt
├── src/main.rs
└── quickgui.config.ts

每个文件保留相对于 resources/ 的路径。resources/hero.png 安装为 hero.png。resources/copy/template.txt 安装为 copy/template.txt。目标名称不得覆盖 fonts、AppIcon.icns 或 quickgui.json 等保留名。

quickgui dev 和 quickgui build 都会暂存这些文件。配置里列出的额外路径缺失时构建失败。resources/ 目录本身是可选的。Rust 的身份和字体路径会写入同一资源目录中的 quickgui.json。

#额外文件

用 resources 配置项把额外文件或文件夹合并进同一个打包目录。每条额外路径按其基名复制。不要在这里列出项目的 resources/ 文件夹，它会自动包含。

import { defineConfig } from "@quickgui/cli";

export default defineConfig({
  language: "rust",
  name: "My App",
  identifier: "com.example.my-app",
  entry: ".",
  resources: ["legal/NOTICE.txt", "vendor/data"],
  fonts: ["assets/MyFont.ttf"],
});

legal/NOTICE.txt 安装为 NOTICE.txt。vendor/data 安装为 data/。

#安装位置

运行时把打包后的名称拼到 resource_dir() 上；不要从项目树或当前工作目录读取。

#读取文件

let hero = cx
    .app_paths()
    .unwrap()
    .resource_dir()
    .join("hero.png");

img(hero).size(160.0, 120.0)

img 接受文件系统路径。其他文件用同样的拼接：用 std::fs::read 读取该路径，或在字节应留在二进制内时加载编译期的 BundledAssets 映射。

let bundle = BundledAssets::new()
    .with("copy/template.txt", include_bytes!("../resources/copy/template.txt"))?;
let assets = Assets::new(bundle);

相对图像路径不会相对资源目录解析。

#字体

fonts 列出 OpenType 文件。CLI 把它们复制到资源目录里的 fonts/，并在第一个窗口打开前根据 quickgui.json 注册。

export default defineConfig({
  language: "rust",
  name: "My App",
  identifier: "com.example.my-app",
  entry: ".",
  fonts: ["assets/MyFont.ttf"],
});

也可以对 Application::font 传入字节或资源路径。字体不能代替 resources/：图像或 JSON 文件仍应放在该目录、额外的 resources 列表或 BundledAssets 中。