跳到主要内容

ARC 2.0.0-beta.25

运行、检查与查看

检查、构建并直接运行本地 blocklet,在浏览器中验收 Web Device 页面。

在上一页的 my-site/ 目录中运行以下检查:

bash
arc dsl lint .
arc dsl validate .
arc blocklet check .
arc blocklet build .

这组最小站点在 2.0.0-beta.25 上的结果分别是 Passed DSL lintPassed DSL validationPassed blocklet check (basic),并在 dist/ 生成构建产物。构建输出由本地生成;不要提交它,除非项目自己的发布流程明确要求这样做。

直接运行当前 blocklet

bash
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.jsonrender.jsstyle.css 都在同一目录。
页面提示没有 direct app entry确认 .route/web 存在,且 handler: websource: .site 都正确。
arc blocklet build 失败先修复 arc dsl lintarc dsl validate 给出的第一条错误,再重新构建。
URL 无法访问不要部署到 DID Space。先确认命令实际打印的 host 和端口,并检查本机端口是否已被其他服务使用。

完成这一页后,你已经验证了最小静态站点。下一步若要加入内容对象,继续读 内容对象、元数据与语言;若只需查字段或语法,转到 参考