跳转到内容
选择主题
选择语言简体中文

第一个应用

终端窗口
acdev new my-app

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

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

终端窗口
acdev new my-app --template html --label "My App" --yes

模板有:

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

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

acdev dev 在运行时里跑你的应用, 安装脚本已经把它装在 acdev 旁边. acdev doctor 检查它在不在、在这台机器上能不能用; 见 运行时.

终端窗口
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 能力:

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

然后在 src/main.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), 再加上用户为它选的文件夹. 用户的共享文件夹 (比如桌面、下载) 要在配置里点名, 并由用户批准之后应用才拿得到; 见 文件与文件夹. 没申请的能力, import 会直接失败.

终端窗口
acdev check # 查配置和入口
acdev build # 构建到 .acde/

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