静态资源与图标
public 目录
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 写一个图标名, 或工程里的一张图:
{ "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 会警告.