نوشتن A2UI

رندرکننده‌ی Jetpack Compose Agent-to-UI (A2UI) پیاده‌سازی پروتکل A2UI را ارائه می‌دهد و به عامل‌های هوش مصنوعی این امکان را می‌دهد تا رابط‌های کاربری غنی و تعاملی ایجاد کنند که اجزای Compose بومی را رندر می‌کنند - بدون اجرای کد دلخواه.
آخرین به‌روزرسانی انتشار پایدار کاندیدای انتشار انتشار بتا انتشار آلفا
۲۳ سپتامبر ۲۰۲۶ - - - ۱.۰.۰-آلفا۰۱

اعلام وابستگی‌ها

برای افزودن یک وابستگی به A2UI Compose، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Google's 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 کمک می‌کند. اگر مشکلات جدیدی کشف کردید یا ایده‌هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد یک کتابخانه جدید، نگاهی به مشکلات موجود در این کتابخانه بیندازید. می‌توانید با کلیک بر روی دکمه ستاره، رأی خود را به یک مشکل موجود اضافه کنید.

ایجاد یک مسئله جدید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

نسخه ۱.۰

نسخه ۱.۰.۰-آلفا۰۱

۲۳ سپتامبر ۲۰۲۶

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 Agent-to-UI (A2UI) پیاده‌سازی پروتکل A2UI را ارائه می‌دهد و به عامل‌های هوش مصنوعی این امکان را می‌دهد تا رابط‌های کاربری غنی و تعاملی ایجاد کنند که اجزای Compose بومی را بدون اجرای کد دلخواه رندر می‌کنند. این کتابخانه پیام‌های پروتکل A2UI را به عناصر اولیه‌ی Compose نگاشت می‌کند و در عین حال واکنش‌پذیری دقیقی را بر اساس سیستم وضعیت Compose Snapshot ارائه می‌دهد. این کتابخانه همچنین APIهایی را برای ایجاد اجزا و کاتالوگ‌های سفارشی ارائه می‌دهد.

تغییرات API

  • 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 به سبک نامگذاری پاسکال تغییر داده شد. ( I91512 ، b/547851648 )
  • AccessibilityProperty به تمام رابط‌های کامپوننت تحت A2uiBasicCatalogV1 اضافه شد و مقدار property از طریق پارامتری که به 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 به انواع enum، number و boolean 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 )
  • در observeA2uiComponentState A2uiCoreSurfaceModel با A2uiSurfaceModel جایگزین کنید تا مطمئن شوید که APIهای عمومی در androidx.a2ui.compose.runtime انواع androidx.a2ui.engine را افشا نمی‌کنند. ( Ic45e2 ، b/544705890 )
  • قابلیت ترکیب A2uiTestSurface برای نصب و آزمایش سطوح و اجزای A2UI به صورت جداگانه اضافه شد. ( I03c8a ، b/527415570 )
  • A2uiSchema اکنون از کلمات کلیدی درون هر زیرکلاس به جای زیرکلاس‌های اختصاصی برای oneOf ، allOf ، anyOf ، not ، const ، default و enum پشتیبانی می‌کند. ( I6a6f8 )
  • APIهای تست برای رندرکننده Compose A2UI اضافه شد. ( I59c9f ، b/527415570 )
  • A2uiReadinessEvaluator و API های مرتبط اضافه شد. ( Ib37d3 ، b/527415547 ، b/524122705 )
  • A2uiComponentCollection ، A2uiFunctionCollection و A2uiCoreComponentDefinitionCollection اضافه شد و APIهای کاتالوگ برای استفاده از مجموعه‌های جدید به‌روزرسانی شدند. ( I96438 ، b/527415547 )
  • یک تابع کارخانه‌ای A2uiMessageParser اضافه شد. ( I8596a ، b/524122705 )
  • رابط نشانگر A2uiRuntimeCatalog و APIهایی در 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 به نسخه ۲.۱۰.۰ به‌روزرسانی شد. این نسخه برای بررسی‌های lint زمان اجرای چرخه عمر همراه با AGP نسخه ۹.۵.۰-alpha۰۴ یا بالاتر مورد نیاز است. ( Id18ea ، b/556807521 )
  • compileSdk برای کتابخانه‌های Compose به نسخه ۳۷.۱ به‌روزرسانی شد. این کار مستلزم به‌روزرسانی مداوم compileSdk برای همه برنامه‌ها و کتابخانه‌هایی است که از Compose استفاده می‌کنند. ( I05b0f )
  • تراز افقی پیش‌فرض Column در A2UI Basic Catalog V1 Ia1c6db به Alignment.Start به‌روزرسانی شد.
  • ترازبندی عمودی پیش‌فرض Row در A2UI Basic Catalog V1 به Alignment.Top به‌روزرسانی شد. If0bca4
،

نوشتن A2UI

رندرکننده‌ی Jetpack Compose Agent-to-UI (A2UI) پیاده‌سازی پروتکل A2UI را ارائه می‌دهد و به عامل‌های هوش مصنوعی این امکان را می‌دهد تا رابط‌های کاربری غنی و تعاملی ایجاد کنند که اجزای Compose بومی را رندر می‌کنند - بدون اجرای کد دلخواه.
آخرین به‌روزرسانی انتشار پایدار کاندیدای انتشار انتشار بتا انتشار آلفا
۲۳ سپتامبر ۲۰۲۶ - - - ۱.۰.۰-آلفا۰۱

اعلام وابستگی‌ها

برای افزودن یک وابستگی به A2UI Compose، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Google's 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 کمک می‌کند. اگر مشکلات جدیدی کشف کردید یا ایده‌هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد یک کتابخانه جدید، نگاهی به مشکلات موجود در این کتابخانه بیندازید. می‌توانید با کلیک بر روی دکمه ستاره، رأی خود را به یک مشکل موجود اضافه کنید.

ایجاد یک مسئله جدید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

نسخه ۱.۰

نسخه ۱.۰.۰-آلفا۰۱

۲۳ سپتامبر ۲۰۲۶

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 Agent-to-UI (A2UI) پیاده‌سازی پروتکل A2UI را ارائه می‌دهد و به عامل‌های هوش مصنوعی این امکان را می‌دهد تا رابط‌های کاربری غنی و تعاملی ایجاد کنند که اجزای Compose بومی را بدون اجرای کد دلخواه رندر می‌کنند. این کتابخانه پیام‌های پروتکل A2UI را به عناصر اولیه‌ی Compose نگاشت می‌کند و در عین حال واکنش‌پذیری دقیقی را بر اساس سیستم وضعیت Compose Snapshot ارائه می‌دهد. این کتابخانه همچنین APIهایی را برای ایجاد اجزا و کاتالوگ‌های سفارشی ارائه می‌دهد.

تغییرات API

  • 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 به سبک نامگذاری پاسکال تغییر داده شد. ( I91512 ، b/547851648 )
  • AccessibilityProperty به تمام رابط‌های کامپوننت تحت A2uiBasicCatalogV1 اضافه شد و مقدار property از طریق پارامتری که به 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 به انواع enum، number و boolean 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 )
  • در observeA2uiComponentState A2uiCoreSurfaceModel با A2uiSurfaceModel جایگزین کنید تا مطمئن شوید که APIهای عمومی در androidx.a2ui.compose.runtime انواع androidx.a2ui.engine را افشا نمی‌کنند. ( Ic45e2 ، b/544705890 )
  • قابلیت ترکیب A2uiTestSurface برای نصب و آزمایش سطوح و اجزای A2UI به صورت جداگانه اضافه شد. ( I03c8a ، b/527415570 )
  • A2uiSchema اکنون از کلمات کلیدی درون هر زیرکلاس به جای زیرکلاس‌های اختصاصی برای oneOf ، allOf ، anyOf ، not ، const ، default و enum پشتیبانی می‌کند. ( I6a6f8 )
  • APIهای تست برای رندرکننده Compose A2UI اضافه شد. ( I59c9f ، b/527415570 )
  • A2uiReadinessEvaluator و API های مرتبط اضافه شد. ( Ib37d3 ، b/527415547 ، b/524122705 )
  • A2uiComponentCollection ، A2uiFunctionCollection و A2uiCoreComponentDefinitionCollection اضافه شد و APIهای کاتالوگ برای استفاده از مجموعه‌های جدید به‌روزرسانی شدند. ( I96438 ، b/527415547 )
  • یک تابع کارخانه‌ای A2uiMessageParser اضافه شد. ( I8596a ، b/524122705 )
  • رابط نشانگر A2uiRuntimeCatalog و APIهایی در 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 به نسخه ۲.۱۰.۰ به‌روزرسانی شد. این نسخه برای بررسی‌های lint زمان اجرای چرخه عمر همراه با AGP نسخه ۹.۵.۰-alpha۰۴ یا بالاتر مورد نیاز است. ( Id18ea ، b/556807521 )
  • compileSdk برای کتابخانه‌های Compose به نسخه ۳۷.۱ به‌روزرسانی شد. این کار مستلزم به‌روزرسانی مداوم compileSdk برای همه برنامه‌ها و کتابخانه‌هایی است که از Compose استفاده می‌کنند. ( I05b0f )
  • تراز افقی پیش‌فرض Column در A2UI Basic Catalog V1 Ia1c6db به Alignment.Start به‌روزرسانی شد.
  • ترازبندی عمودی پیش‌فرض Row در A2UI Basic Catalog V1 به Alignment.Top به‌روزرسانی شد. If0bca4
،

نوشتن A2UI

رندرکننده‌ی Jetpack Compose Agent-to-UI (A2UI) پیاده‌سازی پروتکل A2UI را ارائه می‌دهد و به عامل‌های هوش مصنوعی این امکان را می‌دهد تا رابط‌های کاربری غنی و تعاملی ایجاد کنند که اجزای Compose بومی را رندر می‌کنند - بدون اجرای کد دلخواه.
آخرین به‌روزرسانی انتشار پایدار کاندیدای انتشار انتشار بتا انتشار آلفا
۲۳ سپتامبر ۲۰۲۶ - - - ۱.۰.۰-آلفا۰۱

اعلام وابستگی‌ها

برای افزودن یک وابستگی به A2UI Compose، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Google's 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 کمک می‌کند. اگر مشکلات جدیدی کشف کردید یا ایده‌هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد یک کتابخانه جدید، نگاهی به مشکلات موجود در این کتابخانه بیندازید. می‌توانید با کلیک بر روی دکمه ستاره، رأی خود را به یک مشکل موجود اضافه کنید.

ایجاد یک مسئله جدید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

نسخه ۱.۰

نسخه ۱.۰.۰-آلفا۰۱

۲۳ سپتامبر ۲۰۲۶

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 Agent-to-UI (A2UI) پیاده‌سازی پروتکل A2UI را ارائه می‌دهد و به عامل‌های هوش مصنوعی این امکان را می‌دهد تا رابط‌های کاربری غنی و تعاملی ایجاد کنند که اجزای Compose بومی را بدون اجرای کد دلخواه رندر می‌کنند. این کتابخانه پیام‌های پروتکل A2UI را به عناصر اولیه‌ی Compose نگاشت می‌کند و در عین حال واکنش‌پذیری دقیقی را بر اساس سیستم وضعیت Compose Snapshot ارائه می‌دهد. این کتابخانه همچنین APIهایی را برای ایجاد اجزا و کاتالوگ‌های سفارشی ارائه می‌دهد.

تغییرات API

  • 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 به سبک نامگذاری پاسکال تغییر داده شد. ( I91512 ، b/547851648 )
  • AccessibilityProperty به تمام رابط‌های کامپوننت تحت A2uiBasicCatalogV1 اضافه شد و مقدار property از طریق پارامتری که به 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 به انواع enum، number و boolean 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 )
  • در observeA2uiComponentState A2uiCoreSurfaceModel با A2uiSurfaceModel جایگزین کنید تا مطمئن شوید که APIهای عمومی در androidx.a2ui.compose.runtime انواع androidx.a2ui.engine را افشا نمی‌کنند. ( Ic45e2 ، b/544705890 )
  • قابلیت ترکیب A2uiTestSurface برای نصب و آزمایش سطوح و اجزای A2UI به صورت جداگانه اضافه شد. ( I03c8a ، b/527415570 )
  • A2uiSchema اکنون از کلمات کلیدی درون هر زیرکلاس به جای زیرکلاس‌های اختصاصی برای oneOf ، allOf ، anyOf ، not ، const ، default و enum پشتیبانی می‌کند. ( I6a6f8 )
  • APIهای تست برای رندرکننده Compose A2UI اضافه شد. ( I59c9f ، b/527415570 )
  • A2uiReadinessEvaluator و API های مرتبط اضافه شد. ( Ib37d3 ، b/527415547 ، b/524122705 )
  • A2uiComponentCollection ، A2uiFunctionCollection و A2uiCoreComponentDefinitionCollection اضافه شد و APIهای کاتالوگ برای استفاده از مجموعه‌های جدید به‌روزرسانی شدند. ( I96438 ، b/527415547 )
  • یک تابع کارخانه‌ای A2uiMessageParser اضافه شد. ( I8596a ، b/524122705 )
  • رابط نشانگر A2uiRuntimeCatalog و APIهایی در 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 به نسخه ۲.۱۰.۰ به‌روزرسانی شد. این نسخه برای بررسی‌های lint زمان اجرای چرخه عمر همراه با AGP نسخه ۹.۵.۰-alpha۰۴ یا بالاتر مورد نیاز است. ( Id18ea ، b/556807521 )
  • compileSdk برای کتابخانه‌های Compose به نسخه ۳۷.۱ به‌روزرسانی شد. این کار مستلزم به‌روزرسانی مداوم compileSdk برای همه برنامه‌ها و کتابخانه‌هایی است که از Compose استفاده می‌کنند. ( I05b0f )
  • تراز افقی پیش‌فرض Column در A2UI Basic Catalog V1 Ia1c6db به Alignment.Start به‌روزرسانی شد.
  • ترازبندی عمودی پیش‌فرض Row در A2UI Basic Catalog V1 به Alignment.Top به‌روزرسانی شد. If0bca4
،

نوشتن A2UI

رندرکننده‌ی Jetpack Compose Agent-to-UI (A2UI) پیاده‌سازی پروتکل A2UI را ارائه می‌دهد و به عامل‌های هوش مصنوعی این امکان را می‌دهد تا رابط‌های کاربری غنی و تعاملی ایجاد کنند که اجزای Compose بومی را رندر می‌کنند - بدون اجرای کد دلخواه.
آخرین به‌روزرسانی انتشار پایدار کاندیدای انتشار انتشار بتا انتشار آلفا
۲۳ سپتامبر ۲۰۲۶ - - - ۱.۰.۰-آلفا۰۱

اعلام وابستگی‌ها

برای افزودن یک وابستگی به A2UI Compose، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Google's 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 کمک می‌کند. اگر مشکلات جدیدی کشف کردید یا ایده‌هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد یک کتابخانه جدید، نگاهی به مشکلات موجود در این کتابخانه بیندازید. می‌توانید با کلیک بر روی دکمه ستاره، رأی خود را به یک مشکل موجود اضافه کنید.

ایجاد یک مسئله جدید

برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.

نسخه ۱.۰

نسخه ۱.۰.۰-آلفا۰۱

۲۳ سپتامبر ۲۰۲۶

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 Agent-to-UI (A2UI) پیاده‌سازی پروتکل A2UI را ارائه می‌دهد و به عامل‌های هوش مصنوعی این امکان را می‌دهد تا رابط‌های کاربری غنی و تعاملی ایجاد کنند که اجزای Compose بومی را بدون اجرای کد دلخواه رندر می‌کنند. این کتابخانه پیام‌های پروتکل A2UI را به عناصر اولیه‌ی Compose نگاشت می‌کند و در عین حال واکنش‌پذیری دقیقی را بر اساس سیستم وضعیت Compose Snapshot ارائه می‌دهد. این کتابخانه همچنین APIهایی را برای ایجاد اجزا و کاتالوگ‌های سفارشی ارائه می‌دهد.

تغییرات API

  • 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 به سبک نامگذاری پاسکال تغییر داده شد. ( I91512 ، b/547851648 )
  • AccessibilityProperty به تمام رابط‌های کامپوننت تحت A2uiBasicCatalogV1 اضافه شد و مقدار property از طریق پارامتری که به 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 به انواع enum، number و boolean 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 )
  • در observeA2uiComponentState A2uiCoreSurfaceModel با A2uiSurfaceModel جایگزین کنید تا مطمئن شوید که APIهای عمومی در androidx.a2ui.compose.runtime انواع androidx.a2ui.engine را افشا نمی‌کنند. ( Ic45e2 ، b/544705890 )
  • قابلیت ترکیب A2uiTestSurface برای نصب و آزمایش سطوح و اجزای A2UI به صورت جداگانه اضافه شد. ( I03c8a ، b/527415570 )
  • A2uiSchema اکنون از کلمات کلیدی درون هر زیرکلاس به جای زیرکلاس‌های اختصاصی برای oneOf ، allOf ، anyOf ، not ، const ، default و enum پشتیبانی می‌کند. ( I6a6f8 )
  • APIهای تست برای رندرکننده Compose A2UI اضافه شد. ( I59c9f ، b/527415570 )
  • A2uiReadinessEvaluator و API های مرتبط اضافه شد. ( Ib37d3 ، b/527415547 ، b/524122705 )
  • A2uiComponentCollection ، A2uiFunctionCollection و A2uiCoreComponentDefinitionCollection اضافه شد و APIهای کاتالوگ برای استفاده از مجموعه‌های جدید به‌روزرسانی شدند. ( I96438 ، b/527415547 )
  • یک تابع کارخانه‌ای A2uiMessageParser اضافه شد. ( I8596a ، b/524122705 )
  • رابط نشانگر A2uiRuntimeCatalog و APIهایی در 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 به نسخه ۲.۱۰.۰ به‌روزرسانی شد. این نسخه برای بررسی‌های lint زمان اجرای چرخه عمر همراه با AGP نسخه ۹.۵.۰-alpha۰۴ یا بالاتر مورد نیاز است. ( Id18ea ، b/556807521 )
  • compileSdk برای کتابخانه‌های Compose به نسخه ۳۷.۱ به‌روزرسانی شد. این کار مستلزم به‌روزرسانی مداوم compileSdk برای همه برنامه‌ها و کتابخانه‌هایی است که از Compose استفاده می‌کنند. ( I05b0f )
  • تراز افقی پیش‌فرض Column در A2UI Basic Catalog V1 Ia1c6db به Alignment.Start به‌روزرسانی شد.
  • ترازبندی عمودی پیش‌فرض Row در A2UI Basic Catalog V1 به Alignment.Top به‌روزرسانی شد. If0bca4