Skip to content

렌더러 (클라이언트 라이브러리)

렌더러는 A2UI JSON 메시지를 여러 플랫폼을 위한 네이티브 UI 컴포넌트로 변환합니다.

에이전트는 A2UI 메시지를 생성하는 역할을 담당하고, 전송 계층(transports)은 메시지를 클라이언트로 전달하는 역할을 담당합니다. 클라이언트 렌더러 라이브러리는 A2UI 메시지를 버퍼링하고 처리하며, A2UI 생명주기를 구현하고 서피스(위젯)를 렌더링해야 합니다.

커스텀 컴포넌트를 렌더러에 추가하거나, 여러분의 UI 컴포넌트 프레임워크를 지원하기 위해 직접 렌더러를 구축할 수도 있는 유연성을 제공합니다.

사용 가능한 렌더러

렌더러 플랫폼 상태 링크
Lit (Web Components) 웹 ✅ 안정(Stable) 코드
Angular 웹 ✅ 안정(Stable) 코드
Flutter (GenUI SDK) 모바일/데스크톱/웹 ✅ 안정(Stable) 문서 · 코드
React 웹 🚧 개발 중 2026년 1분기 예정

자세한 내용은 로드맵을 확인하세요.

렌더러 동작 방식

A2UI JSON → 렌더러 → 네이티브 컴포넌트 → 여러분의 앱
  1. 전송 계층으로부터 A2UI 메시지 수신
  2. JSON 파싱 및 스키마 검증
  3. 플랫폼 네이티브 컴포넌트를 사용하여 렌더링
  4. 앱의 테마에 맞춰 스타일링

빠른 시작

Web Components (Lit):

npm install @a2ui/lit

TODO: 퀵스타트 가이드 추가 예정

Angular:

npm install @a2ui/angular

TODO: 퀵스타트 가이드 추가 예정

Flutter:

flutter pub add flutter_genui

TODO: 퀵스타트 가이드 추가 예정

렌더러에 커스텀 컴포넌트 추가하기

TODO: 가이드 추가 예정

렌더러 테마 설정 및 스타일링

TODO: 가이드 추가 예정

렌더러 구축하기

직접 플랫폼용 렌더러를 만들고 싶으신가요?

  • 계획 중인 프레임워크는 로드맵을 확인해 주세요.
  • 기존 렌더러의 패턴을 검토해 보세요.
  • 렌더러 구현에 대한 자세한 내용은 렌더러 개발 가이드를 확인하세요.

주요 요구 사항:

  • A2UI JSON 메시지, 특히 인접 리스트(adjacency list) 형식의 파싱
  • A2UI 컴포넌트를 네이티브 위젯으로 매핑
  • 데이터 바인딩 및 생명주기 이벤트 처리
  • UI를 구축하고 업데이트하기 위한 순차적인 증분 A2UI 메시지 처리
  • 서버 주도 업데이트 지원
  • 사용자 액션 지원

다음 단계