Google은 AI 기술을 사용하여 콘텐츠를 사용자의 기본 언어로 번역합니다. AI 번역에는 오류가 있을 수 있습니다.

A2UI Compose

Jetpack Compose 에이전트-UI (A2UI) 렌더러는 A2UI 프로토콜을 구현하여 AI 에이전트가 임의의 코드를 실행하지 않고도 네이티브 Compose 구성요소를 렌더링하는 풍부한 대화형 사용자 인터페이스를 생성할 수 있도록 지원합니다.

최근 업데이트	안정화 버전	출시 후보 버전	베타 버전	알파 버전
2026년 9월 23일	-	-	-	1.0.0-alpha01

종속 항목 선언

A2UI Compose의 종속 항목을 추가하려면 프로젝트에 Google Maven 저장소를 추가해야 합니다. 자세한 내용은 Google Maven 저장소를 읽어보세요.

다음과 같이 앱 또는 모듈의 build.gradle 파일에 필요한 아티팩트의 종속 항목을 추가합니다.

Groovy

dependencies {
    implementation "androidx.a2ui.compose:compose-runtime:1.0.0-alpha01"
    implementation "androidx.a2ui.compose:compose-ui:1.0.0-alpha01"
    androidTestImplementation "androidx.a2ui.compose:compose-ui-testing:1.0.0-alpha01"
}

Kotlin

dependencies {
    implementation("androidx.a2ui.compose:compose-runtime:1.0.0-alpha01")
    implementation("androidx.a2ui.compose:compose-ui:1.0.0-alpha01")
    androidTestImplementation("androidx.a2ui.compose:compose-ui-testing:1.0.0-alpha01")
}

종속 항목에 관한 자세한 내용은 빌드 종속 항목 추가를 참고하세요.

의견

제출하신 의견은 Jetpack을 개선하는 데 도움이 됩니다. 새로운 문제를 발견하거나 라이브러리 개선을 위한 아이디어가 있다면 Google에 알려 주세요. 새 문제를 제출하기 전에 이 라이브러리의 기존 문제를 살펴보시기 바랍니다. 별표 버튼을 클릭하여 기존 문제에 투표할 수 있습니다.

새로운 문제 제출하기

자세한 내용은 Issue Tracker 문서를 참고하세요.

버전 1.0

버전 1.0.0-alpha01

2026년 9월 23일

androidx.a2ui.compose:compose-runtime:1.0.0-alpha01, androidx.a2ui.compose:compose-ui:1.0.0-alpha01 및 androidx.a2ui.compose:compose-ui-testing:1.0.0-alpha01이 출시되었습니다. 버전 1.0.0-alpha01에는 이러한 커밋이 포함되어 있습니다.

새로운 기능

Jetpack Compose 에이전트-UI (A2UI) 렌더러는 A2UI 프로토콜을 구현하여 AI 에이전트가 임의의 코드를 실행하지 않고도 네이티브 Compose 구성요소를 렌더링하는 풍부한 대화형 사용자 인터페이스를 생성할 수 있도록 지원합니다. 이 라이브러리는 A2UI 프로토콜 메시지를 Compose 기본 요소에 매핑하는 동시에 Compose 스냅샷 상태 시스템을 기반으로 세부적인 반응성을 제공합니다. 이 라이브러리는 맞춤 구성요소와 카탈로그를 만들기 위한 API도 제공합니다.

API 변경사항

표준 A2UI 프로토콜 사양에 맞게 A2uiBasicCatalogV1.CatalogId을 .../v0_9_1/...에서 .../v0_9/...로 업데이트했습니다. (Idcc20)
A2uiBasicCatalogV의 구성요소 순서를 기본 카탈로그 사양과 정확히 일치하도록 업데이트합니다. (I23093, b/547851648)
A2uiBasicCatalogV1 아래의 모든 관련 구성요소 인터페이스에 ChecksProperty를 추가하고 각 구성요소의 TypedContent에 전달된 매개변수를 통해 속성 값을 사용할 수 있도록 했습니다. (I9f393, b/547851648)
A2uiBasicCatalogV1.ChoicePicker 및 MaterialA2uiBasicCatalogV1Defaults.choicePicker를 추가했습니다. (I875a6, b/547851648)
A2uiBasicCatalogV1.Modal 및 MaterialA2uiBasicCatalogV1Defaults.modal를 추가했습니다. (Icd553, b/547851648)
A2uiBasicCatalogV1의 속성 이름을 파스칼 케이스 명명 스타일을 따르도록 변경했습니다. (I91512, b/547851648)
A2uiBasicCatalogV1 아래의 모든 구성요소 인터페이스에 AccessibilityProperty를 추가하고 각 구성요소의 TypedContent에 전달된 매개변수를 통해 속성 값을 사용할 수 있도록 했습니다. (I76b80, b/547851648)
A2uiBasicCatalogV1.TextField 및 MaterialA2uiBasicCatalogV1Defaults.textField를 추가했습니다. (Ifdaec, b/547851648)
A2uiBasicCatalogV1.Video 및 MaterialA2uiBasicCatalogV1Defaults.video를 추가했습니다. (I8595c, b/547851648)
A2uiBasicCatalogV1.AudioPlayer 및 MaterialA2uiBasicCatalogV1Defaults.audioPlayer를 추가했습니다. (Ida509, b/547851648)
a2ui-model 및 a2ui-engine에 format 및 조건부 if-then 스키마 키워드 지원이 추가되었으며 A2uiBasicCatalogV1.DateTimeInput 최소 및 최대 속성 스키마가 업데이트되었습니다. (I556d5, b/553193771)
A2uiBasicCatalogV1.Slider 및 MaterialA2uiBasicCatalogV1Defaults.slider를 추가했습니다. (Ieb72d, b/547851648)
A2uiBasicCatalogV1.CheckBox 및 MaterialA2uiBasicCatalogV1Defaults.checkBox를 추가했습니다. (I84525, b/547851648)
A2uiBasicCatalogV1.Divider 및 MaterialA2uiBasicCatalogV1Defaults.divider를 추가했습니다. (I91208, b/547851648)
A2uiBasicCatalogV1.Tabs 및 MaterialA2uiBasicCatalogV1Defaults.tabs를 추가했습니다. (Ic33d3, b/547851648)
A2uiBasicCatalogV1.List 및 MaterialA2uiBasicCatalogV1Defaults.list를 추가했습니다. (I89f73, b/547851648)
A2uiBasicCatalogV1.Icon 및 MaterialA2uiBasicCatalogV1Defaults.icon를 추가했습니다. (I65524, b/547851648)
하위 구성요소의 작업을 가로채기 위한 ProvideActionInterceptor 추가 (I6ae69, b/552486965)
A2uiClientCapabilities 및 A2uiCoreCatalog에서 인라인 카탈로그 스키마 광고에 대한 지원이 추가되었습니다. (I973cf, b/537714970)
A2uiBasicCatalogV1.Image 및 MaterialA2uiBasicCatalogV1Defaults.image를 추가했습니다. (I673b3, b/547851648)
A2uiBasicCatalogV1.Button 및 MaterialA2uiBasicCatalogV1Defaults.button를 추가했습니다. (I5215f, b/547851648)
A2uiBasicCatalogV1.Row/A2uiBasicCatalogV1.Column 및 MaterialA2uiBasicCatalogV1Defaults.row/MaterialA2uiBasicCatalogV1Defaults.column를 추가했습니다. (Ibcbe7, b/547851648)
열거형, 숫자, 불리언 A2uiProperty 유형에 default 매개변수를 추가했습니다. (Id509e, b/547851648)
A2uiBasicCatalogV1.Card 및 MaterialA2uiBasicCatalogV1Defaults.card를 추가했습니다. (Icf604, b/547851648)
A2uiProperty.nested 및 A2uiProperty.nestedList에 isAdditionalPropertiesAllowed 및 additionalPropertiesSchema 매개변수를 추가했습니다. (I72836, b/547815898)
A2uiProperty 유형 목록에 minItems 및 maxItems 매개변수를 추가했습니다. (I716d3, b/547798330)
A2uiProperty.enum, A2uiProperty.custom, A2uiProperty.dynamicCustom 속성 유형이 추가되었습니다. (I0647d, b/545522395)
androidx.a2ui.compose.runtime의 공개 API가 androidx.a2ui.engine의 유형을 노출하지 않도록 observeA2uiComponentState에서 A2uiCoreSurfaceModel을 A2uiSurfaceModel로 바꿉니다. (Ic45e2, b/544705890)
A2UI 표면과 구성요소를 격리된 상태로 마운트하고 테스트하는 A2uiTestSurface 컴포저블이 추가되었습니다. (I03c8a, b/527415570)
A2uiSchema에서는 이제 oneOf, allOf, anyOf, not, const, default, enum의 전용 서브클래스 대신 각 서브클래스 내에서 키워드를 지원합니다. (I6a6f8)
Compose A2UI 렌더러의 테스트 API를 추가했습니다. (I59c9f, b/527415570)
A2uiReadinessEvaluator 및 관련 API가 추가되었습니다. (Ib37d3, b/527415547, b/524122705)
A2uiComponentCollection, A2uiFunctionCollection, A2uiCoreComponentDefinitionCollection를 추가하고 새 컬렉션을 사용하도록 카탈로그 API를 업데이트했습니다. (I96438, b/527415547)
A2uiMessageParser 팩토리 함수를 추가했습니다. (I8596a, b/524122705)
구성요소와 카탈로그를 정의하기 위해 androidx.a2ui.compose.ui에 A2uiRuntimeCatalog 마커 인터페이스와 API를 추가했습니다. (Ibea7a, b/527415547, b/524122705)
androidx.compose.runtime:runtime-a2ui을 androidx.a2ui.compose:compose-runtime로 이동했습니다. (Ifc7cf, b/524122705)

버그 수정

androidx.lifecycle:lifecycle-runtime 종속 항목이 2.10.0으로 업데이트되었습니다. 이 버전은 번들 수명 주기 런타임 린트 검사가 AGP 버전 9.5.0-alpha04 이상에서 실행되는 데 필요합니다. (Id18ea, b/556807521)
Compose 라이브러리의 compileSdk가 37.1로 업데이트되었습니다. 이렇게 하면 Compose를 사용하는 모든 앱과 라이브러리의 compileSdk가 전이적으로 업데이트됩니다. (I05b0f)
A2UI Basic Catalog V1에서 기본 Column 가로 정렬이 Alignment.Start로 업데이트되었습니다. Ia1c6db
A2UI Basic Catalog V1에서 기본 Row 세로 정렬을 Alignment.Top로 업데이트했습니다. If0bca4