اخبار محصول

ویژگی‌های جدید در نسخه نوامبر ۲۰۲۶ Jetpack Compose

زمان خواندن: ۱۰ دقیقه
مشاهده نمایه Meghan Mehta
Meghan Mehta مدافع توسعه‌دهندگان، Android

نسخه نوامبر ۲۰۲۶ از Jetpack Compose پایدار است! این نسخه، نسخه ۱.۱۳ را در سراسر ماژول‌های اصلی Compose ارائه می‌دهد (نگاشت کامل BOM را ببینید)، به‌روزرسانی‌هایی را برای نوشتار، گرافیک، چیدمان، عملکرد، و موارد دیگر معرفی می‌کند—همراه با چند منسوخ‌سازی مهم و تغییرات رفتاری که باید از آن‌ها آگاه باشید.

برای به‌روزرسانی پروژه‌تان به این نسخه، نسخه Compose BOM خود را به 2026.11.01 ارتقا دهید. توجه داشته باشید که این ارتقا به Kotlin 2.2 (یا جدیدتر) و compileSdk 37.1 نیاز دارد.

implementation(platform("androidx.compose:compose-bom:2026.11.01"))

گرافیک‌

ما همچنان به افزودن ویژگی‌های گرافیکی جدید به Compose ادامه می‌دهیم. ‫Compose نسخه ۱.۱۳ شکل‌های چندضلعی، محو کردن تدریجی، و امکان پیکربندی ویژگی‌های محو کردن را مستقیماً در «کادرهای گفتگو» و «بالاپَرها» معرفی کرد.

محو کردن تدریجی

‫Jetpack Compose 1.13 محو کردن تدریجی را معرفی می‌کند که به شما امکان می‌دهد عناصر را به‌طور یکپارچه از حالت واضح به محو انتقال دهید. محو کردن تدریجی بااستفاده از Modifier.blur { ... } و BlurRadiusSpec روی لامبدا فاز ترسیم ساخته می‌شود. می‌توانید گرادیان‌های خطی (مانند انتقال‌های عمودی یا افقی)، گرادیان‌های شعاعی برای جلوه‌های نورافکن کانونی را پیاده‌سازی کنید، یا حتی AGSL سفارشی RuntimeShaders را برای هدایت نقشه‌های محو رویه‌ای پویا ارسال کنید.

چه درحال ترکیب کردن لبه پایینی تصویر سرایند در پس‌زمینه بااستفاده از BlurredEdgeTreatment.Unbounded باشید، چه درحال ردیابی مختصات لمس با نورافکن شعاعی، محو کردن تدریجی باعث می‌شود پیاده‌سازی جلوه‌های عمق میدان لمسی و ممتاز در Android بسیار ساده شود.

Modifier.blur {
    blurRadiusSpec = BlurRadiusSpec.linearGradient(
        start = DpOffset.Zero,
        end = DpOffset(size.width, size.height),
        stops = listOf(
            BlurStop(fraction = 0f, radius = 0.dp),
            BlurStop(fraction = 0.5f, radius = 0.dp),
            BlurStop(fraction = 0.75f, radius = 14.dp),
            BlurStop(fraction = 1f, radius = 28.dp),
        ),
    )
}
image5_size.png
گرادیان خطی روی ۷۵٪ پایین عکس اعمال شده است.

اشکال چندضلعی و دگردیسی 

‫Compose نسخه ۱.۱۳‏ PolygonShape و MorphPolygonShape را به androidx.compose.foundation:foundation اضافه می‌کند. تاکنون، چندضلعی‌های گرد، ستاره‌ها، و دگرگونی شکل در Compose مستلزم استفاده مستقیم از androidx.graphics:graphics-shapes بود — افزودن وابستگی، ایجاد RoundedPolygon در اندازه پیکسل مناسب، تبدیل آن به Path، و نوشتن Shape خودتان برای تطبیق آن با مرزهای چیدمان.

‫PolygonShape یک شکل Compose معمولی است، بنابراین با Modifier.clip یا هر پارامتر شکل مؤلفه کار می‌کند و به‌طور خودکار به اندازه چیدمان تبدیل می‌شود. MorphPolygonShape با خواندن یک لامبدا پیشرفت در زمان ترسیم، بدون بازترکیب، بین دو شکل چندضلعی پویانمایی می‌کند. فقط زمانی‌که خارج از Compose UI هستید یا به هندسه خام RoundedPolygon نیاز دارید، مستقیماً از graphics-shapes استفاده کنید. برای استفاده از PolygonShape نیازی به افزودن graphics-shapes نیست، زیرا foundation ازقبل به آن وابسته است.

var recording by remember { mutableStateOf(false) }
val progress by animateFloatAsState(if (recording) 1f else 0f)
val shape = remember {
   MorphPolygonShape(
       start = PolygonShape.circle(),
       end = PolygonShape.star(
           numPoints = 9,
           innerRadiusRatio = 0.8f,
           outerRounding = CornerRounding.fraction(0.5f),
       ),
       progress = { progress },
   )
}
Box(
   Modifier
       .size(96.dp)
       .clip(shape)
       .background(MaterialTheme.colorScheme.primary)
       .clickable { recording = !recording }
)
وقتی با دکمه تعامل می‌کنید، از دایره به ستاره تبدیل می‌شود.
وقتی با دکمه تعامل می‌کنید، از دایره به ستاره تبدیل می‌شود.

ویژگی‌های محو کردن پس‌زمینه و بالاپر

اکنون می‌توانید blurBehindRadius،  backgroundBlurRadius،  scrimAlpha،  و  windowShape (برای برش دادن محو کردن پس‌زمینه کادر گفتگو به گوشه‌های گرد) را مستقیماً در DialogProperties (و blurBehindRadius/scrimAlpha در PopupProperties) پیکربندی کنید. 
همچنین می‌توانید وضعیت محو کردن بین‌پنجره‌ای سیستم را ازطریق WindowInfo.isCrossWindowBlurEnabled پُرسمان کنید.

بهبود عملکرد گرافیک

بهبود ذخیره در حافظه نهان

در Compose نسخه ۱.۱۳، پردازاندن نمادهای ایستا کارآمدتر است. VectorPainter به‌طور خودکار حافظه‌های پنهان ترسیم شطرنجی‌شده را در نقاشانی که همان ImageVector ثابت را با همان اندازه و پیکربندی ارائه می‌دهند، هم‌رسانی و مجدداً استفاده می‌کند و تخصیص‌های بیت‌مپ و شطرنجی‌سازی زائد را حذف می‌کند. برای به‌حداکثر رساندن ذخیره‌سازی در حافظه نهان، از نمونه‌های ImageVector در ترکیب‌بندی مجدداً استفاده کنید به‌جای اینکه آن‌ها را دوباره ایجاد کنید. این بهینه‌سازی به‌طور پیش‌فرض ازطریق ComposeUiFlags.isVectorDrawCacheSharingEnabled فعال است.

بهبودهای حاشیه اصلاح‌کننده

Modifier.border اکنون دارای پیاده‌سازی سریع‌تر و کارآمدتر است، پشتیبانی از سایه‌زن‌های زمان اجرا (ShaderBrush با RuntimeShader) را در همه انواع شکل‌ها اضافه می‌کند، و به‌طور مداوم از اندازه طرح کلی هنگام رندر کردن حاشیه‌ها استفاده می‌کند.

برای کسب اطلاعات بیشتر درباره همه ویژگی‌های گرافیکی جدید در Compose و پلاتفرم Android، به سخنرانی «نشست توسعه‌دهندگان Android» در سال ۲۰۲۶ مراجعه کنید: 

Material 3 1.5.0

نسخه ۱.۵.۰ از Compose Material 3 اکنون پایدار است و موارد زیر را معرفی می‌کند:

  • ‫Slider و RangeSlider به مدل باوضعیت با SliderState منتقل شده‌اند.
  • مؤلفه‌های بیانی جدید ازجمله ToggleButtons، WavyProgressIndicators، و TimePickers.
  • میاناهای برنامه‌سازی کاربردی ازجمله BottomAppBar، TopAppBar variants، و BasicAlertDialog به نسخه پایدار ارتقا یافتند.
  • ساخته material3-ripple با حلقه‌های فوکوس داخلی.

در این نسخه، حاشیه‌نویسی‌های آزمایشی را ۵۲ درصد کاهش دادیم و از ۱۲۰ به ۵۸ رساندیم. همچنین تقریباً همه مؤلفه‌های بیانی جدید را به پایدار ارتقا داده‌ایم. با ورود Material 3 به ششمین سال دردسترس بودن، کتابخانه Compose Material 2 منسوخ شده است و دیگر به‌طور فعال نگهداری نمی‌شود. توصیه می‌کنیم برای دریافت جدیدترین رفع اشکال‌ها و زبان طراحی Android، از Material 2 به Material 3 مهاجرت کنید. همین امروز وابستگی‌هایتان را به Material 3 1.5.0 ارتقا دهید تا این مؤلفه‌های نشانگر جدید را به برنامه‌هایتان اضافه کنید. درباره همه مؤلفه‌های جدید، به‌روزرسانی‌های عملکرد، و تغییرات رفتاری در پست وبلاگ بیشتر بدانید. 

نوشتار

انتقال به BasicTextField مبتنی بر وضعیت

BasicTextField مبتنی بر مقدار و Material 2 TextField رسماً منسوخ شده‌اند. این تغییر شما را به انتقال به میاناهای برنامه‌سازی کاربردی BasicTextField  و TextFieldState مبتنی بر وضعیت که قوی‌تر هستند هدایت می‌کند.

اگر از Material 3 استفاده می‌کنید، TextField سربارهای مبتنی بر مقدار موجود شما هنوز در نسخه ۱.۵.۰ منسوخ نشده‌اند، اما توصیه می‌کنیم به سربارهای TextField و OutlinedTextField مبتنی بر وضعیت مهاجرت کنید تا از مزایای کامل وضعیت همگام، عملکرد بهبودیافته، و ویژگی‌های آینده بهره‌مند شوید. اگر هنوز از Material 2 استفاده می‌کنید، مستقیماً به فیلدهای نوشتاری مبتنی بر وضعیت Material 3 مهاجرت کنید.

با انتقال به TextFieldState، که به‌طور بومی از ذخیره و بازیابی سبک‌های قالب‌بندی‌شده پشتیبانی می‌کند، عملکرد بهبودیافته و آماده استفاده و مدل حالت همگام ایمن‌تری به‌دست می‌آورید. این نسخهٔ پخش همچنین حاشیه‌نویسی‌های آزمایشی را از سابقه واگرد/ازنو و بافرهای ردیابی تغییر حذف می‌کند. ابزارهای قدیمی مانند VisualTransformation در این نسخه منسوخ شده‌اند و جای خود را به جایگزین‌های ساده‌شده‌ای مانند OutputTransformation و InputTransformation، ازجمله فیلترهای داخلی محدودیت طول، داده‌اند.

برای کسب اطلاعات بیشتر درباره نحوه انتقال به فیلدهای نوشتاری مبتنی بر وضعیت، این سخنرانی از «نشست توسعه‌دهندگان Android» در سال ۲۰۲۶ را ببینید: 

ارتفاع خط برای هر خط 

هنگام نمایش نوشتار چندزبانه یا اندازه‌های قلم مختلط در یک پاراگراف، فاصله یکنواخت بین خطوط می‌تواند باعث شود خط‌های بلند (مانند برمه‌ای، خمر، یا تایلندی) با خطوط مجاور برخورد کنند. ‫Compose نسخه ۱.۱۳ LineHeightStyle.Mode.PerLine را معرفی می‌کند که ارتفاع خط را به‌طور مستقل برای هر خط محاسبه می‌کند. این کار به خطوطی با نویسه‌های بلندتر یا گستره‌های بزرگ‌تر اجازه می‌دهد تا به‌طور پویا گسترش یابند تا در مرزهای طبیعی خود بدون برش یا اختلال در بقیه پاراگراف قرار گیرند.

image10.png
مقایسه Mode.Fixed (پیش‌فرض، چپ) دربرابر Mode.PerLine (راست) که از تداخل نوشتار در چیدمان‌های چندزبانه جلوگیری می‌کند.

Mergeable FontVariation.Settings

‫Compose نسخه ۱.۱۳ سرریزهای ادغام را به FontVariation.Settings اضافه می‌کند و تعریف پیکربندی‌های قلم متغیر پایه و لغو پویای محورهای خاص (مانند وزن، شیب، یا عرض) را بدون تخصیص مجدد یا بازسازی کل فهرست تنظیمات آسان می‌کند.

// Define a shared base configuration for your variable font
val baseVariation = FontVariation.Settings(FontVariation.weight(400), FontVariation.width(100f))

 
// Easily override or combine specific axes inline
val boldVariation = baseVariation.merge(FontVariation.weight(700))
val condensedVariation = baseVariation.merge(FontVariation.width(85f))

عملکرد

مهارت تحلیل ایستا عملکرد

مهارت تحلیل ایستا جدیدی برای عملکرد Jetpack Compose اضافه کرده‌ایم که ممیزی و تولید کد بدون راه‌اندازی را در هفت دسته کلیدی ارائه می‌دهد: وضعیت و پایداری، چیدمان‌های تنبل، چیدمان‌ها، گرافیک، پویانمایی، جلوه‌ها و رشته‌بندی، و Modifier.Node انتقال‌ها. این مهارت به شما امکان می‌دهد تا بررسی‌های مستقل را روی هر PR، فایل، یا صفحه‌ای اجرا کنید تا با روال‌های مطلوب فعلی مطابقت داشته باشد. امروز آن را ازطریق Android CLI امتحان کنید!

مهارت عملکرد Jetpack Compose

computedStateOf

سازوکار جدیدی برای محاسبه وضعیت، computedStateOf، در نسخه ۱.۱۳ معرفی شده است. این ویژگی جایگزینی سبک برای derivedStateOf ارائه می‌دهد و برای بررسی شرایط و حالت فیلترشده محاسبه‌شده از سایر حالت‌های مکرراً درحال تغییر (مانند موقعیت پیمایش و آستانه‌های پویانمایی) درنظر گرفته شده است. با ذخیره نکردن نتایج محاسبه در حافظه نهان، سربار کمتری نسبت‌به derivedStateOf دارد—به‌ویژه زمانی که محاسبه به‌دلیل تغییر یکی از حالت‌های ارجاع‌شده آن نامعتبر می‌شود. 

هر دو نوع حالت، ترکیب‌بندی را زمانی نامعتبر می‌کنند که نتیجه محاسبه تغییر کند، نه زمانی که حالت‌های ورودی آن‌ها تغییر کند. این‌ها معمولاً برای تبدیل حالت‌های مکرراً درحال تغییر به حالت‌هایی که به‌ندرت تغییر می‌کنند اعمال می‌شوند و از نامعتبر شدن در سلسله‌مراتب ترکیب‌بندی شما برای تغییرات حالت بی‌تأثیر جلوگیری می‌کنند. باید derivedStateOf را برای محاسبات سنگین یا جایی که ذخیره موقت ضروری است رزرو کنید. به‌طور کلی، توصیه می‌کنیم برای محاسبه وضعیت، به‌جای derivedStateOf از computedStateOf استفاده کنید.

ردیابی بازترکیب در Perfetto

ردیابی بازترکیب‌بندی روش جدیدی برای تقویت ردیابی ترکیب‌بندی موجود با اطلاعات جدید درباره خواندن‌های وضعیت و نوشتن‌های وضعیت است که نمای کلی کاملی از تغییرات وضعیت که باعث بازترکیب‌بندی شده‌اند به شما ارائه می‌دهد. برای هر خواندن و نوشتن که بر ترکیب‌بندی تأثیر می‌گذارد، نمایش رشته‌ای وضعیت و ردیابی پشته را ثبت می‌کند تا خط دقیق کد را که تغییر در آن رخ داده است مشخص کند.

توجه داشته باشید که ضبط داده‌های اضافی برای ردیابی بازترکیب، سربار اضافه می‌کند، بنابراین حتماً هنگام بررسی عملکرد برنامه‌تان آن را غیرفعال کنید.

معیارهای قهرمان

Compose 1.13 با Compose 1.12.1 در همه معیارهای راه‌اندازی و پیمایش پایه ما با نرخ پرش ۰٪ در Pixel 6 مطابقت دارد. در راه‌اندازی‌های سرد، Compose 1.13 همچنان به «زمان نمایش اولیه» سریع‌تری (۱۴۷٫۶۵ میلی‌ثانیه) نسبت‌به Views (۱۵۲٫۸۷ میلی‌ثانیه) دست می‌یابد

image4_size.png

به‌دلیل تفاوت در شروع جریان داده و کار سایه‌زن GPU، نماها در «زمان نمایش کامل» سریع‌تر باقی می‌مانند (۱۸۰٫۳۲ میلی‌ثانیه درمقابل ۲۰۲٫۷۹ میلی‌ثانیه برای Compose).  مدت پیمایش قاب (P50) برای Compose برابر با ۳٫۵۱ میلی‌ثانیه و برای Views برابر با ۳٫۰۶ میلی‌ثانیه است، و عملکرد کلی در اجراهای آزمایشی معتبر پایدار و ثابت باقی می‌ماند. ما همچنان سرمایه‌گذاری زیادی روی بهبود عملکرد در همه سنجه‌های عملکرد می‌کنیم و تمرکزمان روی سنجه‌های راه‌اندازی است. برای نتایج کامل، اسناد را بررسی کنید. 

برای کسب اطلاعات بیشتر درباره عملکرد، سخنرانی «نشست توسعه‌دهندگان Android» در سال ۲۰۲۶ را بررسی کنید: 

چیدمان‌ها

FlexBox و Grid پایدار

چیدمان‌های FlexBox و Grid (اعلام‌شده در Compose 1.11) رسماً از حالت آزمایشی به حالت پایدار ارتقا می‌یابند. این میاناهای برنامه‌سازی کاربردی آماده تولید هستند و جایگزین‌هایی با عملکرد بالا برای شبکه‌های پیچیده و طراحی‌های واکنش‌گرا محسوب می‌شوند. FlexBox همچنین پیکربندی جدیدی maxItemsInEachLine دریافت می‌کند که به شما امکان می‌دهد تعداد موارد را در یک خط وقتی‌که پیچیدن فعال است محدود کنید. 

FlexBox جایگزین چیدمان‌های Flow (FlowRow و FlowColumn) می‌شود و توصیه می‌کنیم برای کد جدید، به‌جای چیدمان‌های Flow از FlexBox استفاده کنید. برای مقایسه دقیق محفظه‌های چیدمان، به محفظه‌های چیدمان مراجعه کنید.

چیدمان FlexBox به تغییرات پیکربندی صفحه پاسخ می‌دهد
چیدمان FlexBox که به تغییرات پیکربندی صفحه‌نمایش پاسخ می‌دهد.
چیدمان دوبعدی انعطاف‌پذیر و تطبیقی با Grid
چیدمان دوبعدی انعطاف‌پذیر و تطبیقی با Grid.

منسوخ شدن ConstraintLayout و MotionLayout

با معرفی ابزارهای پویانمایی و چیدمان مدرن‌تر در Compose و میاناهای برنامه‌سازی کاربردی جدید «عنصر مشترک»، رسماً ConstraintLayout و MotionLayout را در Compose (ساخته androidx.constraintlayout:constraintlayout-compose) منسوخ می‌کنیم. 

این جایگزین‌های جدیدتر راهکارهای کارآمدی ارائه می‌دهند و رویکردی ساده برای ساختن میاناهای کاربر پیچیده بومی Compose ارائه می‌دهند. توصیه می‌کنیم موارد استفاده ConstraintLayout Compose را به جایگزین‌های بالا منتقل کنید. 

Stable LazyLayoutCacheWindow

پایدارسازی LazyLayoutCacheWindow، ذخیره‌سازی قوی در حافظه نهان و واکشی پیشاپیش مبتنی بر پنجره را مستقیماً به همه خانواده‌های مجموعه تنبل اصلی (فهرست‌ها، شبکه‌ها، و شبکه‌های نامنظم) می‌آورد. این عملکرد باعث بهبود عملکرد چیدمان‌های تنبل برای ترکیب‌بندی‌های خارج از صفحه می‌شود. 

نکات برجسته کلیدی در این نسخه پخش شامل موارد زیر است:

  • پیکربندی ساده‌شده API: تنظیمات پنجره حافظه نهان از نگه‌دارنده حالت پیمایش (مثل rememberLazyListState) مستقیماً به ترکیب‌شدنی‌های چیدمان (LazyColumn، LazyVerticalGrid، و غیره) منتقل شده است، که باعث می‌شود واکشی پیشاپیش و ذخیره در حافظه نهان مستقیماً به چیدمان مربوط شود.
  • واکشی پیشاپیش مبتنی بر پنجره: واکشی پیشاپیش مبتنی بر مورد قدیمی را با موتور واکشی پیشاپیش مبتنی بر پنجره پیش‌فرض جایگزین می‌کند که به‌طور پویا پنجره پیش‌رو را براساس سنجه‌های نمای دید محاسبه می‌کند، با این گزینه که هم پنجره‌های پیش‌رو و هم پنجره‌های پشت‌سر را برای حفظ ترکیب‌بندی‌های خارج از صفحه سفارشی‌سازی کند.

با مطالعه پست وبلاگ مطالعه موردی، با نحوه بهره‌مندی Instagram Direct از LazyLayoutCacheWindow آشنا شوید و برای کسب اطلاعات بیشتر، مستندات را بررسی کنید.

پویانمایی

‫Compose 1.13‏ DeferredTransition را پایدار می‌کند و یک composable جدید، CapturedAnimatedVisibility، معرفی می‌کند. 

CapturedAnimatedVisibility

AnimatedVisibility به محتوای خروجی و حالت‌هایی نیاز دارد که باید درطول پویانمایی خروج حفظ شوند، زیرا تا زمانی که پویانمایی خروج تمام نشود، به ترکیب‌بندی محتوای خود ادامه می‌دهد. وقتی محتوا به وضعیتی بستگی دارد که قبلاً ازبین رفته است، می‌تواند باعث لرزش قابل‌مشاهده شود. برای مثال، وقتی بستن قاب جزئیات، مورد انتخاب‌شده را روی null تنظیم می‌کند، محتوای موجود چیزی برای نمایش ندارد. یا یک صفحه خالی یا لرزش در میان پویانمایی می‌بینید، یا اگر از !! استفاده کرده باشید، برنامه ازکار می‌افتد، یا باید خودتان مقدار قدیمی را نگه دارید.

Compose نسخه ۱.۱۳ CapturedAnimatedVisibility را معرفی می‌کند. این composable نیازی ندارد که تماس‌گیرنده وضعیت‌ها را درطول خروج مدیریت کند، زیرا وقتی visible نادرست می‌شود، عکس آنی آخرین قاب را ثبت می‌کند. می‌توانید وضعیت خود را فوراً پاک کنید، و پویانمایی خروج همچنان آنچه را روی صفحه بود نشان می‌دهد. 

@Composable
fun TrackDetails(track: Track?) {
    // `track` becomes null as soon as the details are closed. CapturedAnimatedVisibility
    // removes the content right away and animates a snapshot of its last frame instead.
    CapturedAnimatedVisibility(
        visible = track != null,
        enter = fadeIn() + expandVertically(),
        exit = fadeOut(tween(800)) + shrinkVertically(tween(800)),
    ) {
        if (track != null) {
            TrackCard(track)
        }
    }
}
بستن جزئیات، قطعه را روی null تنظیم می‌کند.
بستن جزئیات، دسته هدف را روی null تنظیم می‌کند. با AnimatedVisibility (سمت راست)، کارت بدون هیچ پویانمایی‌ای ناپدید می‌شود. CapturedAnimatedVisibility (راست) آخرین قاب خود را پویانمایی می‌کند.

انتشار فوری وضعیت همچنین باعث می‌شود خروج‌ها ارزان‌تر شوند: در محک‌های ما، عملکرد درطول خروج ازنظر زمان پردازش فریم  ۷ تا ۸ درصد سریع‌تر از AnimatedVisibility است. وقتی محتوای موجود باید فعال بماند، یا وقتی باید از Modifier.animateEnterExit() در فرزندان آن استفاده کنید، به استفاده از AnimatedVisibility ادامه دهید، درغیراین‌صورت CapturedAnimatedVisibility را ترجیح دهید.

مدیریت خطای سفارشی در آزمایش‌ها

اشکال‌زدایی آزمون‌های ناموفق میانای کاربر، به‌ویژه در محیط‌های CI، اغلب نیازمند بررسی وضعیت صفحه‌نمایش و سلسله‌مراتب معناشناسی دقیقاً در لحظه ناموفق شدن ادعا است. ‫Compose نسخه ۱.۱۳ خط لوله رسیدگی به خرابی بومی را ازطریق TestFailurePolicy در ComposeUiTestConfig برای خودکارسازی تشخیص خرابی آزمایش معرفی می‌کند. 

با TestFailurePolicy، می‌توانید:

  • ضبط کردن آرتیفکت‌های داخلی: screenshotCaptureMode و uiHierarchyCaptureMode را روی CaptureMode.Enabled تنظیم کنید تا هرگاه آزمایشی ناموفق بود، به‌طور خودکار یک نماگرفت بصری و درخت معناشناسی میانای کاربر را تخلیه کند.
  • اجرای گرداننده‌های خرابی سفارشی: یک یا چند نمونه TestFailureHandler را برای پردازش FailureContext ثبت کنید، که ریشه error و هرگونه artifacts تولیدشده را ارائه می‌دهد. این کار به شما امکان می‌دهد نماگرفت‌ها را بارگذاری کنید یا دورسنجی خرابی را به ابزارهای گزارش‌دهی خارجی بازارسال کنید.
  • پیکربندی ضبط‌ها در کل مجموعه آزمون: ضبط سلسله‌مراتب میانای کاربر و نماگرفت را به‌طور سراسری در build.gradle.kts ازطریق testInstrumentationRunnerArguments (androidx.compose.ui.test.failure.isScreenshotCaptureEnabled و androidx.compose.ui.test.failure.isUiHierarchyCaptureEnabled) بدون اصلاح فایل‌های آزمون تکی فعال کنید، درحالی‌که توانایی لغو آن‌ها را برای هر آزمون حفظ می‌کنید.
val customConfig = ComposeUiTestConfig(
   failurePolicy = TestFailurePolicy(
       screenshotCaptureMode = TestFailurePolicy.CaptureMode.Enabled,
       uiHierarchyCaptureMode = TestFailurePolicy.CaptureMode.Enabled,
       failureHandlers = listOf(
           TestFailureHandler { context ->
               val screenshot = context.artifacts.firstOrNull {
                   it.type == FailureArtifact.Type.Screenshot
               }
               // Process or upload the artifact and context.error
           }
       )
   )
)
@Test
fun myTest() = runComposeUiTest(config = customConfig) {
   // Test content
}

مهارت تطبیقی

از  مهارت تطبیقی به‌روزشده برای بهینه‌سازی Compose UI برای دستگاه‌های تاشو و رایانه استفاده کنید!

با ارائه محتوا در صفحه‌نمایش عمودی و قرار دادن کنترل‌ها در نیمه پایینی تخت، تجربه افقی روبه‌صورت بدون دخالت دست را در دستگاه‌های تاشو ایجاد کنید تا انگشتان دست جلوی دید را نگیرند.
این مهارت همچنین کمک می‌کند تا برنامه‌تان با میان‌برهای صفحه‌کلید، نکته‌ابزارها، و مکان‌نماهای سفارشی، به‌علاوه الگوهای اثبات‌شده برای جلوگیری از ازدست رفتن وضعیت هنگام چرخاندن یا باز کردن دستگاه توسط کاربران، در رایانه حس بومی بودن را القا کند. امروز آن را ازطریق Android CLI امتحان کنید!

مهارت تطبیقی Jetpack Compose

این گفتگوی «نشست توسعه‌دهندگان Android» را تماشا کنید تا ببینید چگونه می‌توانید پشتیبانی از دستگاه تاشو و رایانه را ارتقا دهید:

محاسبه دقیق سرعت پیمایش تودرتو 

برای برنامه‌هایی با معماری میانای کاربر ترکیبی، مشکلی را حل کردیم که در آن پیمایش سریع در Compose تودرتو در محفظه‌های پیمایش Android View (مانند ScrollView، NestedScrollView، یا CoordinatorLayout) گاهی سرعت نادرستی را محاسبه می‌کرد. انتقال سرعت اکنون به‌طور دقیق محاسبه می‌شود و از توقف‌های ناگهانی یا فیزیک پیمایش پرشی جلوگیری می‌کند و تجربه پرتاب روان و سیالی را در مرزهای View و Compose تضمین می‌کند. 

تغییر رفتار: 
Modifier.onFocusedBoundsChanged اکنون منسوخ شده است

Modifier.onFocusedBoundsChanged در Compose نسخه ۱.۱۲ منسوخ شد و در نسخه ۱.۱۳ پیاده‌سازی آن برداشته شده است، یعنی اگر اصلاح‌کننده اجرا شود، هیچ تأثیری ندارد. پیاده‌سازی قدیمی در بسیاری از موقعیت‌ها مرزهای کانونی را به‌طور قابل‌اعتمادی گزارش نمی‌کرد و مشکلات عملکردی داشت. 

محفظه‌های پیمایش داخلی مثل LazyColumn و Modifier.verticalScroll ازقبل محتوای متمرکزشده را بدون این میانای برنامه‌سازی کاربردی به نما می‌آورند، بنابراین تحت‌تأثیر قرار نمی‌گیرند. 

برای دریافت حدود عنصر متمرکزشده،  FocusTargetModifierNode.getFocusedRect() را از Modifier.Node سفارشی فراخوانی کنید. این API به‌جای گزارش کردن هر تغییر ازطریق فراخوانی برگشتی، وقتی حدود را درخواست می‌کنید آن‌ها را برمی‌گرداند. برای واکنش نشان دادن به تغییرات فوکوس، از  Modifier.onFocusChanged استفاده کنید. برای پیمایش کردن مورد دارای تمرکز به نمای ظرف سفارشی، onFocusChanged را با BringIntoViewRequester جفت کنید. 

تغییر رفتار: جلوه‌های صوتی تعامل پلاتفرم در Android 

عناصر کلیک‌کردنی پیکربندی‌شده با Modifier.clickable (یا مؤلفه‌های ساخته‌شده روی آن) اکنون به‌طور خودکار جلوه‌های صوتی تعاملی استاندارد Android را پخش می‌کنند و تنظیمات صدای سیستم کاربر را رعایت می‌کنند. قبلاً، عناصر کلیک‌کردنی Compose برای دستیابی به برابری با «نماهای» سنتی Android، به فراخوانی دستی جلوه‌های صوتی نیاز داشتند. این به‌روزرسانی تضمین می‌کند که عناصر تعاملی بازخورد صوتی فوری ارائه دهند و به‌طور پیش‌فرض در پلاتفرم Android بومی به‌نظر برسند. 

به‌روزرسانی درباره «سبک‌ها»

در Google I/O، روش جدیدی را برای سفارشی‌سازی مؤلفه‌ها بدون انشعاب کد منبع پیش‌نمایش کردیم. در Compose 1.13، این معماری بنیادی به یک موتور سبک‌بندی بی‌طرف تبدیل شده است. به‌جای اینکه چارچوب ویژگی‌های دیداری را به‌صورت کد ثابت تعریف کند، تعاریف ویژگی‌ها به لایه سیستم طراحی منتقل شده‌اند—این امر به تیم‌ها امکان می‌دهد تا نشان‌های نمانام سفارشی (stylePropertyOf / styleLocalOf) را با استقلال کامل اعلام کنند.

به‌دلیل این تغییر معماری، Styles API در Compose 1.13 همچنان آزمایشی است. ما به‌طور فعال با شرکا و Material 3 کار می‌کنیم تا ادغام سبک و ارگونومی توسعه‌دهنده را قبل‌از دردسترس قرار گرفتن عمومی اصلاح کنیم. درطول این مرحله گذار، اسناد و مهارت مربوط به «سبک‌ها» را برداشته‌ایم. 

کتابخانه جدید Compose Web برای انتقال آسان‌تر WebView (آلفا)

جاسازی محتوای وب در Compose یکی از آخرین نقاط اصطکاک انتقال برای برنامه‌ها است. پیاده‌سازی‌های قدیمی بااستفاده از AndroidView می‌تواند باعث لکنت پیمایش، ازدست رفتن وضعیت درطول تغییرات پیکربندی یا پیمایش، و سربار پردازش تعامل‌پذیری شود.

برای ازبین بردن این اصطکاک، درحال راه‌اندازی دو کتابخانه هستیم که بر دو عنصر پایه مکمل در سراسر androidx.web ساخته شده‌اند:

  • WebContent (اکنون در androidx.web:web:1.0.0-alpha01 دردسترس است): نگه‌دارنده حالتی که حالت وب (ازجمله موقعیت پیمایش، ورودی‌های فرم، سابقه پیمایش، و حالت جاوا اسکریپت) را از سلسله‌مراتب نما جدا می‌کند تا بدون لو رفتن Activity شما، بیشتر از تغییرات پیکربندی و پیمایش دوام بیاورد.
@Composable
// Assumes `webContent` is already created and retained (e.g., in a ViewModel or via `retain`)
fun WebContentPage(webContent: WebContent, startUrl: String, modifier: Modifier = Modifier) {
   key(webContent) {
       AndroidView(
           factory = { context ->
               webContent.attach(context, ::WebContentView).apply {
                   settings.javaScriptEnabled = true
                   if (url == null) loadUrl(startUrl)
               }
           },
           modifier = modifier,
           onRelease = { view ->
               // The view must leave the hierarchy before WebContent is detached.
               (view.parent as? ViewGroup)?.removeView(view)
               webContent.detach()
           },
       )
   }
}
  • WebSurface (به‌زودی دردسترس قرار می‌گیرد): یک ترکیب‌پذیر اختصاصی بهینه‌شده برای WebContent که سربار تعامل‌پذیری AndroidView را دور می‌زند.

با وارد کردن androidx.web:web:1.0.0-alpha01، همین امروز میاناهای برنامه‌سازی کاربردی را امتحان کنید و منتظر انتشار نسخه آلفای WebSurface در آینده نزدیک باشید.

پردازنده جدید Jetpack Compose A2UI

پاسخ‌های LLM زمان اجرا نباید به نوشتار ساده محدود شود. ‫Jetpack Compose A2UI Renderer جدید پروتکل Agent-to-UI (A2UI) باز را پیاده‌سازی می‌کند. 

implementation("androidx.compose.material3:material3-a2ui:1.0.0-alpha02")

عوامل هوش مصنوعی می‌توانند میاناهای کاربر غنی و تعاملی را در زمان اجرا ایجاد کنند که به‌عنوان مؤلفه‌های Compose بومی بدون اجرای کد دلخواه ارائه می‌شوند. پردازنده تجزیه پیام و اعتبارسنجی طرحواره را انجام می‌دهد و داده‌های نماینده را به حالت عکس آنی Compose وارد می‌کند. از «کاتالوگ پایه» آماده استفاده کنید یا اجزای قابل‌ترکیب و سیستم طراحی خودتان را متصل کنید. با اسناد شروع کنید یا گفتگوی Android DevSummit را بررسی کنید. 

به‌روزرسانی‌های اسناد

اسناد جدیدی دردسترس داریم که شامل کشیدنی لنگردار، پیوندهای عمیق Navigation3، و AppState می‌شود.

آهنگ‌سازی خوش بگذرد!

‫Compose نسخه ۱.۱۳ با به‌روزرسانی‌های نوشتار، گرافیک، چیدمان، عملکرد، و غیره، توسعه برنامه را آسان‌تر و گویاتر از همیشه می‌کند! برای دیدن مجموعه کامل تغییرات بین نسخه‌های BOM، به ابزار مقایسه BOM نگاهی بیندازید تا تفاوت را ببینید.

برای کسب اطلاعات بیشتر درباره موارد جدید Compose، جدیدترین گفتگوها را در نشست توسعه‌دهندگان Android تماشا کنید.

مثل همیشه، نظرات شما برای ما ارزشمند است، بنابراین لطفاً بازخورد خود را درباره این تغییرات یا آنچه می‌خواهید در آینده ببینید، در ردیاب مشکل ما هم‌رسانی کنید. از نوشتن لذت ببرید!

نویسنده:
ادامه خواندن