跳到主要内容

ARC 2.0.0-beta.28

心智模型

用一张简短术语图理解 ARC 架构,再打开真正拥有该任务的 board。

把这些词当作边界,而不是同义词。

术语把它理解为不要把它当成
AFS按路径寻址的资源与能力文件系统单一物理数据库或云存储桶
Provider拥有挂载路径、实现所声明操作的模块每个路径都支持全部操作的证明
AFS UI架构视角:相对 AFS 路径与设备表达 UI 工作与 AUP、Web Device 并列的第三套公开 authoring 产品
AUP声明式语义 UI tree(节点、事件、绑定、降级)HTML、CSS 或站点内容模型
Web Device读取站点树并渲染静态 HTML 的 AFS provider交互式 AUP session 或通用应用运行时
Blocklet你编写的 package 与你运行的 instance仅仅是一个网站,或仅仅是一个 UI 文件
DID / caller运行时附加到请求或 session 的已验证身份上下文碰巧看起来像 DID 的路径字符串
DID Space通过 AFS 挂载的、按 DID 分区的持久存储第二套并行文件系统协议
Data Space描述 caller 数据上下文与视图的文档术语另一套公开 SDK 或生命周期 API
ARC承载 AFS、session 与 Blocklet 的运行时与 CLI 外壳与 AFS 同一件事

各部分如何连接

  1. AFS 回答:「资源在哪,其 Provider 支持哪些操作?」
  2. AFS UI 回答:「展示或编辑该资源时,适用哪类设备与 UI 合同?」
  3. AUP 回答交互呈现:语义 tree、session、设备能力、降级。
  4. Web Device 回答站点呈现:页面、内容对象、主题、静态 HTML。
  5. Blocklet 回答打包:交付什么、如何本地运行、如何把 surface 绑到 AFS。
  6. 身份与数据空间 回答:「谁在行动,得到哪份数据视图?」
  7. ARC CLI 是从本机检查并驱动上述层次的操作入口。

阅读顺序

如果你是…先读
刚接触 ARC,需要术语本页,然后 ARC 与 AFS
在选择指南归属产品层次
把 UI 工作接到 AFS 路径AFS UI,再进 AUPWeb Device
实现资源或 ProviderAFS
交付应用单元Blocklets
处理登录、成员关系或用户数据Identity & Data Spaces
检查一句话是否构成产品承诺合同与证据
追查旧产品名产品沿革与边界

合同、解释与沿革

  • 公开合同 —— 源码、测试与本地运行一致后可以依赖的行为。由专题 board 持有。
  • 架构解释 —— 层次如何配合;用于定向,不能替代类型与命令。
  • 沿革 —— 旧名称为何仍会出现;绝不是完整功能等价声明。

内部 ARC 材料也会用 AOS 指 ARC 所承载的可移植操作系统语义(session、HTTP 表面、调度)。本公开 board 不把 AOS 当作独立开发者文档产品。需要 session 或 caller 细节时,使用 Identity & Data Spaces 与 AUP 的 session 相关页面。