第一个应用
新建
新建 一节的链接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-appacdev devacdev 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, 见 本机安装.