# acde.config.jsonc

工程配置. JSON Schema 是 `acde.config.schema.json`, `acdev new` 把它放在配置文件旁边 (它随 acdev 一起来), TypeScript 类型是 `AcdeConfig` (来自 `@dopame/acde-api`):

```ts
type AcdeConfig = AppConfig | DesktopConfig
```

## 共有字段

| 字段 | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `$schema` | string | | JSON Schema 的路径 |
| `type` | `"app"` \| `"desktop"` | | 必填 |
| `name` | string | `package.json` 的 `name` | 包名 |
| `version` | string | `package.json` 的 `version` | |
| `apiLevel` | 整数 ≥ 1 | SDK 的 `API_LEVEL` (1) | 契约级别; `acdev build` 把它写进清单. 不用写 |
| `public` | string | `"public"` | 原样复制的静态文件目录 |

## AppConfig

| 字段 | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `id` | string | 由包名得出 | `[a-z0-9][a-z0-9-]*` |
| `label` | string | | 显示名 |
| `icon` | 图标名 \| 路径 | `"app"` | 见 [图标](https://docs.dopame.ai/zh/guide/assets.md#图标) |
| `entry` | string | `"index.html"` | HTML 或默认导出 `WindowApp` 的模块; 用框架时不写 |
| `framework` | `Framework` | `"auto"` | 见下 |
| `capabilities` | `Capabilities` | `{}` | 系统能力, 见 [包清单](https://docs.dopame.ai/zh/reference/manifest.md#capabilities). 在这里写桌面服务的名字是错误 |
| `optional` | string[] | `[]` | 同时也在 `capabilities` 里的名字: 没有它们应用也能跑, 用动态的 `import('acde:<名字>')` 取 |
| `services` | string[] | `[]` | 应用用到的桌面服务, 以 `acde:<名字>` 导入; 不能是系统模块的名字 |
| `size` | `[number, number]` | `[800, 600]` | 内容区的逻辑像素, 正整数. `acdev dev` 单独跑这个应用时, 是宿主窗口打开时的尺寸 (应用铺满它); 带 `--headless` 时不生效 |
| `frame` | boolean | `true` | 系统标题栏 |
| `multiple` | boolean | `false` | 允许多个窗口 |
| `mimeTypes` | string[] | `[]` | `type/subtype` 或 `type/*` |
| `schemes` | string[] | `[]` | 应用打开的链接的 URL scheme: `[a-z][a-z0-9+.-]*`, 不带冒号, 不能是 `file` |
| `requests` | string[] | `[]` | 应用从 `open()` 接受的请求种类: `[a-z][a-z0-9-]*`, 不能是 `open-file` 或 `open-link` |
| `heapMb` | number | 256 | 每窗口的 JS 堆上限, ≥ 32 |
| `backend` | `false` \| `{entry?, port?}` | 自动找 | 见 [后端](https://docs.dopame.ai/zh/guide/backend.md) |

`Framework`: `auto` `none` `next` `nuxt` `sveltekit` `astro` `react-router` `remix` `angular` `vite` `cra` `script`.

## DesktopConfig

| 字段 | 类型 | 默认 | 说明 |
| --- | --- | --- | --- |
| `id` / `label` / `description` | string | | |
| `entry` | string | `"index.html"` | 桌面页面 |
| `heapMb` | number | 1024 | |
| `services` | `Record<string, string \| ServiceConfig>` | | 服务名 → 模块路径, 或 `{ module, modules? }`: 模块路径和服务从 `ctx.import()` 拿到的 shell 模块; 见 [服务](https://docs.dopame.ai/zh/guide/services.md#服务里的-shell-模块) |
| `apps` | `WindowAppConfig[]` | | 自带应用 (系统应用): `AppConfig` 的字段, 除了 `framework`; `id` 和 `entry` 必填, `capabilities` 里可以写 shell 模块 |
