在上一页的 my-site/ 目录中运行以下检查:
arc dsl lint .
arc dsl validate .
arc blocklet check .
arc blocklet build .这组最小站点在 2.0.0-beta.25 上的结果分别是 Passed DSL lint、Passed DSL validation、Passed blocklet check (basic),并在 dist/ 生成构建产物。构建输出由本地生成;不要提交它,除非项目自己的发布流程明确要求这样做。
直接运行当前 blocklet
arc blocklet run .该命令会复用或启动本地 daemon,并打印这个 blocklet 的实际访问 URL。端口和 host 取决于你的本机环境,所以复制命令输出中的 URL,不要手写猜测。
打开命令打印的主地址。不要把其他机器、示例或旧输出中的 host、端口拿来替代它。你应看到:
Hello, Web Device作为页面标题;This page is rendered by a local blocklet.作为正文;- 页面没有横向溢出或浏览器 console error。
这一步才是页面验收。DSL 检查和 build 只能证明输入能被处理;浏览器确认的是用户真正能看到的结果。
出错时先看什么
| 现象 | 先检查 |
|---|---|
missing_web_component_file | 确认自定义组件的 manifest.json、render.js 和 style.css 都在同一目录。 |
| 页面提示没有 direct app entry | 确认 .route/web 存在,且 handler: web、source: . 和 site 都正确。 |
arc blocklet build 失败 | 先修复 arc dsl lint 或 arc dsl validate 给出的第一条错误,再重新构建。 |
| URL 无法访问 | 不要部署到 DID Space。先确认命令实际打印的 host 和端口,并检查本机端口是否已被其他服务使用。 |
完成这一页后,你已经验证了最小静态站点。下一步若要加入内容对象,继续读 内容对象、元数据与语言;若只需查字段或语法,转到 参考。