跳到主要内容

AUP 跨设备 primitive · ARC 2.0.0-beta.28

`surface` primitive

surface 是跨设备挂载意图;不要与 Web Device layout surface 混淆。

surface 是 AUP 跨设备 primitive,不是 Web Device 的 layout 组件,也不是 Web-only widget。它属于 AUP_PRIMITIVES 中的 18 个名称之一,并出现在每个 target 的 DeviceCaps.primitives map 中(取值为 native、webview、partial 或 unsupported)。

合同

字段值
Primitive 名称surface
层级AUP 跨设备 primitive(AUP_PRIMITIVES)
公共状态unsupported (document)
Document 能力unsupported
共享 degradation chain无共享 chain
作者入口支持 runtime 上的 AUP / widget surface 挂载
Document renderer / 备注Document unsupported; see frames/surfaces docs for Web Device mounts
Showcase 证据Interactive surfaces / comments-surface etc. (widgets may host surfaces)

何时使用

在 runtime 已定义该 surface 的 AUP tree 中挂载命名交互 surface。

何时不要使用

不要把 AUP surface 等同于 Web Device surfaces/* layout 挂载(docs-page、pagination 等)。层级不同。

Document sample

不提供。 document 能力为 unsupported。没有共享 degradation chain 会伪造安全替代。Web Device 页面 chrome surface 见 Web Device 文档,而不是本 primitive 页。

证据锚点

项值
注册表packages/aup/src/aup-types.ts · AUP_PRIMITIVES
Document capsproviders/runtime/web-device/src/device-caps.ts · DEVICE_CAPS_DOCUMENT
Degradationpackages/aup/src/degradation.ts · DEGRADATION_CHAINS
内部矩阵docs/aup/capability-matrix.md(内部,不对外路由)
Taxonomy hubPrimitive 类型分类与证据
Sample 合同规则Live 示例:范围与合同

相关页面