跳到主要内容

ARC 2.0.0-beta.25

准备与适用范围

用 ARC 2.0.0-beta.25 从一个本地 blocklet 开始验证最小 Web Device 站点。

先把 Web Device 当成一个本地 blocklet 的 Web route 来验证。它读取 blocklet 内的 .web/、pages/ 和（以后需要时的）content/，再把这些文件渲染成静态页面。第一个站点不需要 DID Space，也不需要发布。

这条起步路径只验证一件事：你能从一个空目录建立、检查、直接运行并在浏览器里看到一个静态页面。它不尝试证明内容集合、主题库、CMS、部署或正式域名已经配置完成。

使用的运行时

本页的命令已在 arc 2.0.0-beta.25 上运行过：

text
$ arc --version
2.0.0-beta.25

先检查你的版本：

bash
arc --version

如果输出不是这个版本，不要假定下面的组件文件或 CLI 输出完全相同。先阅读 版本兼容性，再用你的目标版本重跑本页的检查。

最小边界

准备一个可以写入的空目录，并确认终端已经能找到 arc。如果命令不存在，先完成安装 ARC CLI。arc blocklet run 会自行选择或复用本机服务，再打印实际 URL；本教程不要求你预先决定端口。第一轮会使用下面这些文件：

text
my-site/
├── blocklet.yaml
├── .route/web
├── .web/
│   ├── site.yaml
│   └── components/hello/
│       ├── manifest.json
│       ├── render.js
│       └── style.css
└── pages/
    └── index/
        └── layout.aup

blocklet.yaml 给本地运行时一个 blocklet 身份；它含有一个本地 DID，但这不要求创建、登录或部署 DID Space。.route/web 把根路径交给 Web Device；.web/ 放站点配置和组件；pages/ 放可渲染的页面。下一页会逐个建立它们。

不要把本地验收换成部署

本地页面验收使用 arc blocklet run <directory>，并直接打开它打印出的 localhost URL。这个命令只在本机运行指定 blocklet。

arc deploy 和 DID Space 是正式发布链路的另一条测试面。它们不会替代本页的本地验证，也不应该为了看一个页面而提前使用。

已知边界

当前 CLI 没有一个只生成纯 Web Device 内容站的专用 recipe：basic 只建立 blocklet 元数据，minimal-app 同时包含 AUP app、agent 和 settings。本页因此从 basic 开始，再明确写出最小 Web 文件树。

这里使用的是在 2.0.0-beta.25 实际通过验证的兼容组件形状：manifest.json、render.js 和 style.css。组件 DSL 的源码/生成关系仍需要按目标版本在参考页中单独说明；不要从这个最小例子推导所有版本都只接受这一种形状。