跳到主要内容

ARC 2.0.0-beta.25

AUP 在 Web Device 中

区分 AUP 的静态 HTML tree 渲染、页面 layout 组合与 Web Device 的站点职责。

Web Device 是 Web-facing 的站点 provider,不是把 AUP 和网站的所有概念混成一层。它有两条当前可验证的 AUP 路径:受支持的 AUP tree 可直接静态渲染为 HTML;页面 layout AUP 也可组合站点组件来提供可复用的 Web 呈现。这两条路径彼此相关,但不代表任意 native primitive 都可以直接放进 Web layout section。

关注点AUPWeb Device
tree、event、state、capability/degradation定义语义合同使用目标 renderer 的支持边界
静态 HTML可由受支持 tree 产生负责 Web renderer、页面组装与构建
页面目录、内容对象、locale、SEO、主题不定义pages/content/.web/ 组织
站点组件可被 layout 引用.web/components/ 中承载可复用 Web 实现

选择正确的 path

如果你要在一个站点页面中排列并复用品牌组件、内容列表或主题样式,先从 Web Device 的 pages/.web/components/ 开始,再用 AUP layout 表达结构。如果你要验证一个跨设备交互 tree、session patch 或 device capability,先从 AUP app 和目标 renderer 开始。

这两种路径能共享 AUP 语义,但它们的验收不同:

  • AUP app 的浏览器验收应观察 session、导航、event 和 patch;
  • Web Device 的验收应观察静态页面、locale、链接、SEO 和 build;
  • 一个 path 绿了不替代另一个。静态 HTML 成功不是 interactive session 成功;AUP app 能跑也不证明一个完整内容站点有正确路由与 SEO。

一个站点作者的最小顺序

  1. 在 Web Device 里先建立 .route/web.web/site.yamlpages/index/
  2. 可复用的 layout section 应使用 Web component。把 native tree 的直接静态渲染当作独立的 supported-renderer path,而不是替代 layout component contract。
  3. 对交互行为,使用 AUP 的 event/state 合同;对内容对象,使用 Web Device 的 source/binding 合同。
  4. 分别运行 DSL/站点检查、构建和真实浏览器验收。

不要把隐藏 UI、静态渲染或页面组件当作 AFS 权限控制;caller identity 和 scope 仍在独立边界上。具体建站步骤属于 target-specific 的 Web Device 层,不放在这个 AUP board 中。

相关证据

要在本站 document 表面上 live 走一遍 18 个 primitive、Markdown directives 与 deck 媒体宿主(gallery / YouTube media-fill / tweet clamp),见 AUP capability tour。该导览只是 document target 的证据,不能替代 device capability 报告或 Web Device 站点验收。