A2UI Compose

  
يوفّر عارض Agent-to-UI (A2UI) في Jetpack Compose عملية تنفيذ بروتوكول A2UI، ما يتيح لوكلاء الذكاء الاصطناعي إنشاء واجهات مستخدم تفاعلية وغنية تعرض مكوّنات Compose الأصلية بدون تنفيذ أي رموز برمجية عشوائية.
آخر الأخبار الإصدار الثابت إصدار محتمل الإصدار التجريبي الإصدار الأوّلي
‫23 سبتمبر 2026 - - - 1.0.0-alpha01

تحديد الاعتماديات

لإضافة اعتمادية على A2UI Compose، يجب تضمين مستودع Maven من Google في مشروعك. اطّلِع على مستودع Maven من Google لمزيد من المعلومات.

أضِف الاعتماديات الخاصة بالعناصر التي تحتاج إليها في ملف 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. يُرجى إعلامنا إذا اكتشفت مشاكل جديدة أو كانت لديك أفكار لتحسين هذه المكتبة. يُرجى الاطّلاع على المشاكل الحالية في هذه المكتبة قبل إنشاء مشكلة جديدة. يمكنك إضافة صوتك إلى مشكلة حالية من خلال النقر على زر النجمة.

إنشاء مشكلة جديدة

يُرجى الاطّلاع على مستندات Issue Tracker للحصول على مزيد من المعلومات.

الإصدار 1.0

الإصدار ‎1.0.0-alpha01

‫23 سبتمبر 2026

تم طرح ميزات 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 هذه التعديلات.

الميزات الجديدة

يوفّر عارض Agent-to-UI (A2UI) في Jetpack Compose عملية تنفيذ بروتوكول A2UI، ما يتيح لوكلاء الذكاء الاصطناعي إنشاء واجهات مستخدم تفاعلية وغنية تعرض مكوّنات Compose الأصلية بدون تنفيذ أي رموز برمجية عشوائية. تربط هذه المكتبة رسائل بروتوكول A2UI بعناصر Compose الأساسية مع توفير تفاعلية دقيقة استنادًا إلى نظام حالة Compose Snapshot. توفّر المكتبة أيضًا واجهات برمجة تطبيقات لإنشاء مكونات وفهارس مخصّصة.

التغييرات في واجهة برمجة التطبيقات

  • تم تعديل A2uiBasicCatalogV1.CatalogId من .../v0_9_1/... إلى .../v0_9/... ليتوافق مع مواصفات بروتوكول A2UI الأساسي. (Idcc20)
  • عدِّل ترتيب المكوّنات في A2uiBasicCatalogV ليتطابق تمامًا مع مواصفات الفهرس الأساسية. (I23093، b/547851648)
  • تمت إضافة ChecksProperty إلى جميع واجهات المكوّنات ذات الصلة ضمن A2uiBasicCatalogV1 وإتاحة قيمة السمة من خلال مَعلمة تم تمريرها إلى TypedContent لكل مكوّن. (I9f393، b/547851648)
  • تمت إضافة A2uiBasicCatalogV1.ChoicePicker وMaterialA2uiBasicCatalogV1Defaults.choicePicker. (I875a6، b/547851648)
  • تمت إضافة A2uiBasicCatalogV1.Modal وMaterialA2uiBasicCatalogV1Defaults.modal. (Icd553، b/547851648)
  • تمت إعادة تسمية السمات في A2uiBasicCatalogV1 لتتّبع أسلوب التسمية pascal-case. (I91512، b/547851648)
  • تمت إضافة AccessibilityProperty إلى جميع واجهات المكوّنات ضمن A2uiBasicCatalogV1 وإتاحة قيمة السمة من خلال مَعلمة تم تمريرها إلى 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)
  • أضفنا إمكانية استخدام الكلمات الرئيسية format وif-then الشرطية في المخطط في a2ui-model وa2ui-engine، وعدّلنا مخططات سمات الحد الأدنى والحد الأقصى في 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)
  • تمت إضافة مَعلمات default إلى أنواع التعداد والرقم والقيمة المنطقية A2uiProperty. (Id509e، b/547851648)
  • تمت إضافة A2uiBasicCatalogV1.Card وMaterialA2uiBasicCatalogV1Defaults.card. (Icf604، b/547851648)
  • تمّت إضافة المَعلمتَين isAdditionalPropertiesAllowed وadditionalPropertiesSchema إلى A2uiProperty.nested وA2uiProperty.nestedList. (I72836، b/547815898)
  • تمت إضافة المَعلمتَين minItems وmaxItems إلى قائمة أنواع A2uiProperty. (I716d3، b/547798330)
  • تمت إضافة أنواع السمات A2uiProperty.enum وA2uiProperty.custom وA2uiProperty.dynamicCustom. (I0647d، b/545522395)
  • استبدِل A2uiCoreSurfaceModel بـ A2uiSurfaceModel في observeA2uiComponentState لضمان عدم عرض الأنواع من androidx.a2ui.engine في واجهات برمجة التطبيقات العامة في androidx.a2ui.compose.runtime. (Ic45e2، b/544705890)
  • تمت إضافة دالة مركّبة A2uiTestSurface لتثبيت واختبار مساحات عرض ومركّبات A2UI بشكل منفصل. (I03c8a، b/527415570)
  • تتيح A2uiSchema الآن استخدام كلمات رئيسية ضمن كل فئة فرعية بدلاً من الفئات الفرعية المخصّصة لـ oneOf وallOf وanyOf وnot وconst وdefault وenum. (I6a6f8)
  • تمت إضافة واجهات برمجة تطبيقات للاختبار خاصة بأداة العرض A2UI في Compose. (I59c9f، b/527415570)
  • تمت إضافة A2uiReadinessEvaluator وواجهات برمجة التطبيقات ذات الصلة. (Ib37d3، b/527415547، b/524122705)
  • تمت إضافة A2uiComponentCollection وA2uiFunctionCollection وA2uiCoreComponentDefinitionCollection، وتم تعديل واجهات برمجة التطبيقات الخاصة بالفهرس لاستخدام المجموعات الجديدة. (I96438، b/527415547)
  • تمت إضافة دالة مصنع A2uiMessageParser. (I8596a، b/524122705)
  • تمت إضافة واجهة العلامة A2uiRuntimeCatalog وواجهات برمجة التطبيقات في androidx.a2ui.compose.ui لتحديد المكوّنات والفهارس. (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. هذا الإصدار مطلوب لتشغيل عمليات التحقّق من أخطاء lint المجمَّعة في وقت التشغيل لدورة الحياة مع الإصدار 9.5.0-alpha04 أو إصدار أحدث من "مكوّن Android الإضافي لبرنامج Gradle". (Id18ea، b/556807521)
  • تم تعديل compileSdk لمكتبات Compose إلى الإصدار 37.1. سيتطلّب ذلك تعديل compileSdk بشكل متعدٍّ لجميع التطبيقات والمكتبات التي تستخدم Compose. (I05b0f)
  • تم تعديل المحاذاة الأفقية التلقائية Column إلى Alignment.Start في A2UI Basic Catalog V1. Ia1c6db
  • تم تعديل المحاذاة العمودية التلقائية Row إلى Alignment.Top في A2UI Basic Catalog V1. If0bca4