AGenUI - 高德地图联合阿里千问推出的端云一体原生 A2UI 开源框架

AGenUI是什么

AGenUI 是高德地图联合阿里千问C端应用团队发布的行业首个覆盖 iOS、Android、HarmonyOS 三端的端云一体原生 A2UI 开源框架。基于 Google 开源的 A2UI v0.9 协议构建，通过跨平台 C++ 核心引擎，将 AI 大模型生成的界面意图（A2UI JSON）直接转化为各端原生组件渲染，推动 AI 应用从文本式交互走向生成式 UI 交互。

AGenUI的功能特色

• 三端原生覆盖：行业首个同时支持 iOS、Android、HarmonyOS 的 A2UI 原生渲染框架，三端共用同一套 C++ Core，通过各平台原生能力（UIView、Android View、ArkUI）完成最终渲染，兼顾跨端一致性与原生体验。
• 端云一体架构：云侧通过 Agent Skill 生成符合 A2UI 协议的 JSON 结构化界面描述，降低大模型 Token 消耗与输出不确定性；端侧依托跨平台 C++ Core 统一处理协议解析、状态管理与布局计算，直接渲染为原生组件。
• Streaming-first 流式渲染：支持"边生成边呈现"，组件到达即刻挂载，无需等待完整 JSON 生成完毕；配合最小化节点差分更新与独立线程异步渲染，高频增量更新不卡顿主线程，核心场景目标对齐 120fps。
• 深度适配鸿蒙系统级能力：深度适配鸿蒙 1+8+N 全场景分布式架构，直连系统级渲染、动效及分布式核心能力，与小艺、鸿蒙意图框架天然协同；相较 iOS、Android 对应版本，鸿蒙版渲染性能提升 20%，内存占用降低 18%。
• 完善的组件与样式体系：内置 22 个基础组件（18 个 A2UI 协议组件 + 4 个 SDK 扩展组件）和 45+ 项 CSS 样式属性，覆盖文本、图片、按钮、列表、输入框、卡片等常用交互元素。
• 主题定制与 Design Token：Theme 系统支持 Design Token，模型只需输出语义描述（如 primary、surface），端侧即可自动映射为符合品牌规范的具体颜色、字体、圆角、间距等视觉参数。
• 高性能 Native 渲染：采用纯 Native 渲染路线，不以 JavaScript 或 WebView 实现跨平台，核心逻辑（协议解析、状态管理、Yoga 布局计算、节点 Diff）均在独立线程完成，主线程只负责提交轻量级 UI 操作。
• 可扩展组件与 Function 机制：支持自定义 Native View 注册为 AGenUI 组件，参与流式渲染与生命周期管理；Function 采用统一设计，支持按钮动作、输入校验、字符串插值、事件回流等能力的统一注册和调用。
• 极简接入与 Playground：提供端侧 SDK、云侧 Agent Skill 及开源仓库内置 Playground，三端接入逻辑高度一致，通过统一入口 SurfaceManager 仅需少量代码即可创建渲染容器、加载 A2UI JSON 并监听事件回流。
• 全面开源：采用 MIT 协议开源，涵盖端侧 Client SDK（三端原生渲染能力）与云侧 Agent Skill（生成 A2UI JSON 的能力），并在仓库中提供 Playground 供开发者快速体验协议调试与端云协同流程。

AGenUI的核心优势

• 三端原生覆盖，一套代码多端运行：行业首个同时支持 iOS、Android、HarmonyOS 的 A2UI 原生渲染框架，三端共用同一套 C++ Core，保证核心逻辑一致的同时，通过各平台原生能力（UIView、Android View、ArkUI）完成最终渲染，兼顾跨端一致性与原生体验。
• 端云一体架构：云侧通过 Agent Skill 生成符合 A2UI 协议的 JSON 结构化界面描述，降低大模型 Token 消耗与输出不确定性；端侧依托跨平台 C++ Core 统一处理协议解析、状态管理与布局计算，直接渲染为原生组件。
• Streaming-first 流式渲染：支持"边生成边呈现"，组件到达即刻挂载，无需等待完整 JSON 生成完毕；配合最小化节点差分更新与独立线程异步渲染，高频增量更新不卡顿主线程，核心场景目标对齐 120fps。
• 深度适配鸿蒙系统级能力：作为高德面向鸿蒙打造的开源框架，AGenUI 深度适配鸿蒙 1+8+N 全场景分布式架构，直连系统级渲染、动效及分布式核心能力，与小艺、鸿蒙意图框架天然协同；相较 iOS、Android 对应版本，鸿蒙版渲染性能提升 20%，内存占用降低 18%。
• 完善的组件与样式体系：内置 22 个基础组件（18 个 A2UI 协议组件 + 4 个 SDK 扩展组件）和 45+ 项 CSS 样式属性，支持组件、Function Call 及主题的三维定制；Theme 系统支持 Design Token，模型只需输出语义描述，端侧即可自动映射为符合品牌规范的具体样式。
• 极简接入，分钟级上手：提供端侧 SDK、云侧 Agent Skill 及开源仓库内置 Playground，三端接入逻辑高度一致，通过统一入口 SurfaceManager 仅需少量代码即可创建渲染容器、加载 A2UI JSON 并监听事件回流。

AGenUI官网是什么

• 项目官网：https://genui.amap.com/
• GitHub仓库：https://github.com/AGenUI/AGenUI

AGenUI的操作步骤

• 环境准备与依赖接入：在项目中引入 AGenUI SDK（Maven 坐标为 com.amap.genui:agenui-sdk:0.9.8），确保开发环境满足系统要求（iOS 13+ / Android API 21+ / HarmonyOS NEXT API 20+）。
• 初始化渲染容器：通过统一入口 SurfaceManager 创建原生渲染容器，在各端分别挂载到对应的视图层级中（iOS 的 UIView、Android 的 View、鸿蒙的 ArkUI）。
• 加载 A2UI JSON 内容：将云侧 Agent Skill 生成或本地构造的符合 A2UI v0.9 协议的 JSON 结构化界面描述，传入端侧 SDK 进行协议解析。
• 触发流式渲染：SDK 自动完成布局计算（Yoga 引擎）与节点 Diff，将 JSON 描述转化为原生组件并挂载到渲染树；支持 Streaming-first 模式，组件到达即刻呈现，无需等待完整 JSON。
• 监听事件回流：注册事件回调，捕获用户在原生组件上的点击、输入、滑动等交互行为，将事件数据回流到业务层或 Agent 侧进行下一步处理。

AGenUI的适用人群

• AI Agent 开发者与架构师：需要为智能体构建结构化、可交互的原生界面，将大模型输出从纯文本转化为可点击、可填写的原生 UI 卡片。
• 鸿蒙应用开发者：希望降低手机、平板、车机、智慧屏、穿戴等多设备界面适配成本，深度利用鸿蒙系统级渲染、动效及分布式核心能力。
• 跨平台移动端开发者：追求一套代码覆盖 iOS、Android、HarmonyOS 三端，避免为不同平台分别编写和维护 UI 代码。
• 追求极致性能的产品团队：目标场景涉及复杂页面滚动、长列表、高频增量更新（如直播数据看板、实时消息流），需要 120fps 级流畅原生体验。
• 希望升级 AI 交互形态的创业公司与大厂业务线：计划将 AI 能力从"文本对话"走向"生成式 UI 交互"，用于智能问答、服务卡片、任务引导、动态表单等场景。
• 多设备协同场景开发者：需要同一 Agent 输出无缝适配手机、车机、IoT 设备、智慧屏等多终端，实现 1+8+N 全场景分布式 UI 渲染。

AGenUI的常见问题