# 第一个应用

## 新建

```sh
acdev new my-app
```

在终端里, `acdev new` 会依次问你缺的信息: 目录、应用还是桌面、模板、显示名、要不要后端、Bun 还是 Node.js (两个都装了时)、要不要装依赖、要不要 `git init`. 每一步都直接按回车, 就是用默认值.

不想被问, 用参数把它们给全, 加 `--yes` (依赖仍然会装; 不想装就加 `--no-install`):

```sh
acdev new my-app --template html --label "My App" --yes
```

模板有:

| 模板 | 是什么 |
| --- | --- |
| `html` | 一张普通网页 (默认); 加 `--backend` 再带一个后端 |
| `desktop` | 一个桌面 (见 [桌面](https://docs.dopame.ai/zh/guide/desktop.md)) |
| `react` `vue` `svelte` `solid` `preact` `vanilla` | create-vite 的模板. `--backend` 加上 `server.ts` |
| `next` `nuxt` `sveltekit` `astro` | 各框架的官方脚手架 |

框架模板会经你的包管理器跑那个框架最新版的脚手架, 再加上 `acde.config.jsonc`.

## 跑起来

`acdev dev` 在运行时里跑你的应用, 安装脚本已经把它装在 acdev 旁边. `acdev doctor` 检查它在不在、在这台机器上能不能用; 见 [运行时](https://docs.dopame.ai/zh/start/install.md#运行时).

```sh
cd my-app
acdev dev
```

`acdev dev` 构建工程、启动运行时, 在你的电脑上开一个窗口, 里面是你的应用. 保持它开着, 改 `index.html` 或 `src/main.js` 并保存, 窗口会自动重新载入.

按 Ctrl+C 或关掉窗口结束, 或者在另一个终端里, 在工程目录下运行 `acdev stop`.

> 自带模板的 `package.json` 里有 `dev`、`build`、`check` 三个脚本, 就是 `acdev dev` / `acdev build` / `acdev check`. 框架模板不动框架自己的脚本, 另加 `acde:dev`、`acde:build`、`acde:check`.

## 加个系统能力

让应用存一个自己的文件. 这个例子用的是 `html` 模板; 框架模板只在它的 `acde.config.jsonc` 里加 `capabilities` 这一行 (框架模板的配置没有 `entry`, 也不要加), 代码写进框架自己的某个源文件.

先在 `acde.config.jsonc` 里申请 `fs` 能力:

```jsonc
{
  "type": "app",
  "id": "my-app",
  "label": "My App",
  "icon": "files",
  "entry": "index.html",
  "capabilities": { "fs": true }
}
```

然后在 `src/main.js` 里:

```js
import { fs } from 'acde:fs'

const status = document.querySelector('#status')
await fs.writeFile('private', 'hello.txt', 'Hello from my app')
const { text } = await fs.readText('private', 'hello.txt')
const roots = await fs.roots()
status.textContent = `${text} (roots: ${roots.map((r) => r.id).join(', ')})`
```

保存, 窗口重载后就能看到 `Hello from my app (roots: private)`. 写了 `"fs": true`, 应用就有一个自己的私有文件夹 (根 `private`), 再加上用户为它选的文件夹. 用户的共享文件夹 (比如桌面、下载) 要在配置里点名, 并由用户批准之后应用才拿得到; 见 [文件与文件夹](https://docs.dopame.ai/zh/guide/files.md). 没申请的能力, `import` 会直接失败.

## 构建与检查

```sh
acdev check   # 查配置和入口
acdev build   # 构建到 .acde/
```

`.acde/` 就是运行时认的**包**: 一个目录, 里面的 `package.json` 的 `acde` 字段是**清单** (说明包里有什么), 再加上网页和后端的产物. 想把应用装进本机的 Dopame 桌面, 用 `acdev install`, 见 [本机安装](https://docs.dopame.ai/zh/guide/install.md).

## 下一步

- [工程结构](https://docs.dopame.ai/zh/start/project.md)
- [配置工程](https://docs.dopame.ai/zh/guide/config.md)
- [后端](https://docs.dopame.ai/zh/guide/backend.md)
