A2UI Compose

  
Trình kết xuất Agent-to-UI (A2UI) của Jetpack Compose cung cấp một cách triển khai giao thức A2UI, cho phép các tác nhân AI tạo ra giao diện người dùng phong phú, có tính tương tác cao, kết xuất các thành phần Compose gốc mà không cần thực thi mã tuỳ ý.
Bản cập nhật mới nhất Bản phát hành ổn định Bản phát hành dùng thử Bản phát hành beta Bản phát hành alpha
Ngày 23 tháng 9 năm 2026 - - - 1.0.0-alpha01

Khai báo phần phụ thuộc

Để thêm một phần phụ thuộc vào A2UI Compose, bạn phải thêm kho lưu trữ Maven của Google vào dự án. Đọc nội dung Kho lưu trữ Maven của Google để biết thêm thông tin.

Thêm các phần phụ thuộc cho cấu phần phần mềm bạn cần trong tệp build.gradle cho ứng dụng hoặc mô-đun:

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")
}

Để biết thêm thông tin về các phần phụ thuộc, hãy xem bài viết Thêm phần phụ thuộc vào bản dựng.

Ý kiến phản hồi

Ý kiến phản hồi của bạn có thể giúp chúng tôi cải thiện Jetpack. Hãy cho chúng tôi biết nếu bạn phát hiện lỗi mới hoặc có ý tưởng cải thiện thư viện này. Vui lòng xem các lỗi hiện có trong thư viện này trước khi báo một lỗi mới. Bạn có thể thêm lượt bình chọn cho lỗi hiện có bằng cách nhấp vào nút dấu sao.

Báo lỗi mới

Xem tài liệu về Trình theo dõi sự cố để biết thêm thông tin.

Phiên bản 1.0

Phiên bản 1.0.0-alpha01

Ngày 23 tháng 9 năm 2026

Phát hành androidx.a2ui.compose:compose-runtime:1.0.0-alpha01, androidx.a2ui.compose:compose-ui:1.0.0-alpha01 và androidx.a2ui.compose:compose-ui-testing:1.0.0-alpha01. Phiên bản 1.0.0-alpha01 bao gồm các thay đổi sau.

Tính năng mới

Trình kết xuất Agent-to-UI (A2UI) của Jetpack Compose cung cấp một cách triển khai giao thức A2UI, cho phép các tác nhân AI tạo ra giao diện người dùng phong phú, có tính tương tác cao, kết xuất các thành phần Compose gốc mà không cần thực thi mã tuỳ ý. Thư viện này ánh xạ các thông báo giao thức A2UI sang các thành phần cơ bản của Compose, đồng thời cung cấp khả năng phản ứng chi tiết dựa trên hệ thống trạng thái Snapshot của Compose. Thư viện này cũng cung cấp các API để tạo thành phần và danh mục tuỳ chỉnh.

Thay đổi về API

  • Cập nhật A2uiBasicCatalogV1.CatalogId từ .../v0_9_1/... thành .../v0_9/... để phù hợp với quy cách giao thức A2UI chuẩn. (Idcc20)
  • Cập nhật thứ tự của các thành phần trong A2uiBasicCatalogV để hoàn toàn khớp với quy cách danh mục cơ bản. (I23093, b/547851648)
  • Đã thêm ChecksProperty vào tất cả các giao diện thành phần có liên quan trong A2uiBasicCatalogV1 và cung cấp giá trị thuộc tính thông qua một tham số được truyền đến TypedContent của mỗi thành phần. (I9f393, b/547851648)
  • Thêm A2uiBasicCatalogV1.ChoicePickervà MaterialA2uiBasicCatalogV1Defaults.choicePicker. (I875a6, b/547851648)
  • Thêm A2uiBasicCatalogV1.Modalvà MaterialA2uiBasicCatalogV1Defaults.modal. (Icd553, b/547851648)
  • Đã đổi tên các thuộc tính trong A2uiBasicCatalogV1 để tuân theo kiểu đặt tên theo quy tắc viết hoa chữ cái đầu. (I91512, b/547851648)
  • Đã thêm AccessibilityProperty vào tất cả các giao diện thành phần trong A2uiBasicCatalogV1 và cung cấp giá trị thuộc tính thông qua một tham số được truyền đến TypedContent của mỗi thành phần. (I76b80, b/547851648)
  • Thêm A2uiBasicCatalogV1.TextField và MaterialA2uiBasicCatalogV1Defaults.textField. (Ifdaec, b/547851648)
  • Thêm A2uiBasicCatalogV1.Video và MaterialA2uiBasicCatalogV1Defaults.video. (I8595c, b/547851648)
  • Thêm A2uiBasicCatalogV1.AudioPlayer và MaterialA2uiBasicCatalogV1Defaults.audioPlayer. (Ida509, b/547851648)
  • Thêm chế độ hỗ trợ cho format và từ khoá giản đồ if-then có điều kiện trong a2ui-model và a2ui-engine, đồng thời cập nhật giản đồ thuộc tính tối thiểu và tối đa A2uiBasicCatalogV1.DateTimeInput. (I556d5, b/553193771)
  • Thêm A2uiBasicCatalogV1.Slider và MaterialA2uiBasicCatalogV1Defaults.slider. (Ieb72d, b/547851648)
  • Thêm A2uiBasicCatalogV1.CheckBox và MaterialA2uiBasicCatalogV1Defaults.checkBox. (I84525, b/547851648)
  • Thêm A2uiBasicCatalogV1.Divider và MaterialA2uiBasicCatalogV1Defaults.divider. (I91208, b/547851648)
  • Thêm A2uiBasicCatalogV1.Tabs và MaterialA2uiBasicCatalogV1Defaults.tabs. (Ic33d3, b/547851648)
  • Thêm A2uiBasicCatalogV1.List và MaterialA2uiBasicCatalogV1Defaults.list. (I89f73, b/547851648)
  • Thêm A2uiBasicCatalogV1.Icon và MaterialA2uiBasicCatalogV1Defaults.icon. (I65524, b/547851648)
  • Thêm ProvideActionInterceptor để chặn các thao tác của thành phần con. (I6ae69, b/552486965)
  • Thêm tính năng hỗ trợ cho việc quảng cáo các giản đồ danh mục cùng dòng trong A2uiClientCapabilities và A2uiCoreCatalog. (I973cf, b/537714970)
  • Thêm A2uiBasicCatalogV1.Image và MaterialA2uiBasicCatalogV1Defaults.image. (I673b3, b/547851648)
  • Thêm A2uiBasicCatalogV1.Button và MaterialA2uiBasicCatalogV1Defaults.button. (I5215f, b/547851648)
  • Đã thêm A2uiBasicCatalogV1.Row/A2uiBasicCatalogV1.Column và MaterialA2uiBasicCatalogV1Defaults.row/MaterialA2uiBasicCatalogV1Defaults.column. (Ibcbe7, b/547851648)
  • Thêm các tham số default vào các loại enum, số và boolean A2uiProperty. (Id509e, b/547851648)
  • Thêm A2uiBasicCatalogV1.Cardvà MaterialA2uiBasicCatalogV1Defaults.card. (Icf604, b/547851648)
  • Thêm các tham số isAdditionalPropertiesAllowed và additionalPropertiesSchema vào A2uiProperty.nested và A2uiProperty.nestedList. (I72836, b/547815898)
  • Thêm các tham số minItems và maxItems vào danh sách các loại A2uiProperty. (I716d3, b/547798330)
  • Đã thêm các loại thuộc tính A2uiProperty.enum, A2uiProperty.custom và A2uiProperty.dynamicCustom. (I0647d, b/545522395)
  • Thay thế A2uiCoreSurfaceModel bằng A2uiSurfaceModel trong observeA2uiComponentState để đảm bảo rằng các API công khai trong androidx.a2ui.compose.runtime không hiển thị các loại từ androidx.a2ui.engine. (Ic45e2, b/544705890)
  • Đã thêm thành phần kết hợp A2uiTestSurface để gắn và kiểm thử các thành phần cũng như bề mặt A2UI riêng biệt. (I03c8a, b/527415570)
  • A2uiSchema hiện hỗ trợ từ khoá trong từng lớp con thay vì các lớp con chuyên dụng cho oneOf, allOf, anyOf, not, const, default và enum. (I6a6f8)
  • Thêm các API kiểm thử cho trình kết xuất A2UI của Compose. (I59c9f, b/527415570)
  • Thêm A2uiReadinessEvaluator và các API liên quan. (Ib37d3, b/527415547, b/524122705)
  • Thêm A2uiComponentCollection, A2uiFunctionCollection và A2uiCoreComponentDefinitionCollection, đồng thời cập nhật các API danh mục để sử dụng các bộ sưu tập mới. (I96438, b/527415547)
  • Đã thêm hàm trạng thái ban đầu A2uiMessageParser. (I8596a, b/524122705)
  • Thêm giao diện đánh dấu A2uiRuntimeCatalog và các API trong androidx.a2ui.compose.ui để xác định các thành phần và danh mục. (Ibea7a, b/527415547, b/524122705)
  • Đã chuyển androidx.compose.runtime:runtime-a2ui đến androidx.a2ui.compose:compose-runtime. (Ifc7cf, b/524122705)

Sửa lỗi

  • Phần phụ thuộc androidx.lifecycle:lifecycle-runtime đã được cập nhật lên 2.10.0. Bạn cần có phiên bản này để các quy trình kiểm tra lint thời gian chạy theo gói có thể chạy với AGP phiên bản 9.5.0-alpha04 trở lên. (Id18ea, b/556807521)
  • compileSdk cho các thư viện Compose được cập nhật lên 37.1. Việc này sẽ yêu cầu cập nhật compileSdk một cách gián tiếp cho tất cả các ứng dụng và thư viện sử dụng Compose. (I05b0f)
  • Đã cập nhật chế độ căn chỉnh ngang Column mặc định thành Alignment.Start trong A2UI Basic Catalog V1. Ia1c6db
  • Đã cập nhật chế độ căn chỉnh dọc Row mặc định thành Alignment.Top trong A2UI Basic Catalog V1. If0bca4