# 静态资源与图标

## public 目录

工程里的 `public/` (用配置的 `public` 改名) 原样复制进应用的 `web/`.

页面里以 `/` 开头、指向 public 里文件的引用:

- HTML 里的: 照常打包.
- CSS 的 `url(/x)`: 工程是入口为 HTML 的应用时原样保留, 因为运行时把应用目录也挂在 `/` 下. 别处 (桌面, 或桌面自带的应用) 照常打包.
- 哪里都找不到这个文件时构建失败, 并说明是哪个文件的哪个 URL、public 里缺了什么.

## 脚本里引用的文件

只有 JavaScript 里提到的文件, 按下面几种方式之一打包:

- `import logo from './logo.png'`: `logo` 是它在构建出的应用里的 URL.
- `new URL('./logo.png', import.meta.url)`: 文件被拷过去, URL 指向它 (用 Node.js 时由 Vite 做; 用 Bun 时由 acdev 做). 路径要是以 `./` 或 `../` 开头、指向一个存在的文件的字面量; 模块 (`.js`、`.ts` 等) 不处理.
- 字符串里的路径 (`img.src = 'img/logo.png'`) 哪个打包器都看不到: 把文件放进 `public/`, 用 `/img/logo.png` 引用.

## 页面的地址

应用页面的源是 `http://acde.local`. 应用的文件同时挂在 `/app/<id>/` 和 `/` 下, 所以 `/logo.png` 和相对路径都能用.

## 图标

`icon` 写一个图标名, 或工程里的一张图:

```jsonc
{ "icon": "chart" }        // 图标名
{ "icon": "assets/logo.svg" } // 工程里的图片
```

**图标名** 是 Dopame 内置的一套图标, 和桌面的视觉风格一致:

`files` `browser` `editor` `office` `term` `projects` `dash` `team` `dopa` `settings` `store` `app` `timer` `cards` `list` `chart` `calc` `music` `video` `photo` `paint` `game` `chat` `mail` `calendar` `code` `book` `map` `weather`

不写时是 `app`.

**图片**: 含 `/`、`\` 或带扩展名的值当作路径, 相对工程目录, 只能是 `.svg` 或 `.png`. 构建时复制进应用的 `web/icon.<ext>`, 清单里写 `/app/<id>/icon.<ext>`. 别的值 `acdev check` 会警告.
