تلویزیون

قابلیت‌های طراحی Compose و Material را برای توسعه‌دهندگان فراهم می‌کند تا بتوانند برنامه‌هایی برای تلویزیون بنویسند.
آخرین به‌روزرسانی انتشار پایدار کاندیدای انتشار انتشار بتا انتشار آلفا
۱۱ مارس ۲۰۲۶ ۱.۰.۱ - ۱.۱.۰-بتا۰۱ -

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

برای افزودن وابستگی‌ها به tv-foundation و tv-material، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Google's Maven را مطالعه کنید.

وابستگی‌های مربوط به مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:

شیار 

dependencies {
    implementation "androidx.tv:tv-foundation:1.0.0-beta01"
    implementation "androidx.tv:tv-material:1.1.0-beta01"
}

کاتلین 

dependencies {
    implementation("androidx.tv:tv-foundation:1.0.0-beta01")
    implementation("androidx.tv:tv-material:1.1.0-beta01")
}

برای اطلاعات بیشتر در مورد وابستگی‌ها، به «افزودن وابستگی‌های ساخت» مراجعه کنید.

بازخورد

بازخورد شما به بهبود Jetpack کمک می‌کند. اگر مشکلات جدیدی کشف کردید یا ایده‌هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد یک کتابخانه جدید، نگاهی به مشکلات موجود در این کتابخانه بیندازید. می‌توانید با کلیک بر روی دکمه ستاره، رأی خود را به یک مشکل موجود اضافه کنید.

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

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

هیچ یادداشت انتشاری برای این مصنوع وجود ندارد.

نسخه ۱.۱ تی‌وی-مادی

نسخه ۱.۱.۰-بتا۰۱

۱۱ مارس ۲۰۲۶

androidx.tv:tv-material:1.1.0-beta01 منتشر شد. نسخه 1.1.0-beta01 شامل این کامیت‌ها است.

تغییرات API

  • پروژه‌های منتشر شده با کاتلین ۲.۰ برای استفاده به KGP 2.0.0 یا جدیدتر نیاز دارند ( Idb6b5 ، b/344563182 )

مشارکت خارجی

  • نام مستعار androidx.compose.ui.graphics.NativePaint منسوخ شده است، به جای آن مستقیماً android.graphics.Paint استفاده کنید ( I6303c ، b/477394763 )
  • برای جلوگیری از افشای نوع پلتفرم در مجموعه منابع commonMain از طریق typealias ( I6303c ، b/477394763 ) Paint.asFrameworkPaint() را با افزونه Paint.nativePaint جایگزین کنید.

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

۱۵ ژانویه ۲۰۲۵

androidx.tv:tv-material:1.1.0-alpha01 منتشر شد. نسخه 1.1.0-alpha01 شامل این کامیت‌ها است.

تغییرات API

  • تغییر FocusEnterExitScope.cancelFocus() به cancelFocusChange() ( I89959 )
  • FocusProperties.enter و FocusProperties.exit به ترتیب با onEnter و onExit جایگزین شده‌اند و به جای پارامتر FocusDirection از یک دامنه گیرنده استفاده می‌کنند. ( I6e667 )

رفع اشکالات

  • برای رفع مشکل لرزش متن هنگام مقیاس‌بندی، CompositingStrategy.OffScreen از Surface به Text منتقل شد. ( I92b15f17 )
  • رفع مشکل مدیریت فوکوس ناقص در Carousel ( Ie508b721375 )
  • سطح (غیر تعاملی) در مقایسه با نمونه‌های تعاملی، پیاده‌سازی ساده‌تری دارد. ( I7ea545150 )

نسخه ۱.۰ تی‌وی-مادی

نسخه ۱.۰.۱

۱۶ ژوئیه ۲۰۲۵

androidx.tv:tv-material:1.0.1 منتشر شد. نسخه ۱.۰.۱ شامل این کامیت‌ها است.

رفع اشکالات

  • ارتفاع NavigationDrawerItem برای مطابقت با مشخصات به‌روزرسانی شد. ( cf9a3ce )
  • پیکربندی استراتژی ترکیب‌بندی از Surface composable به Text composable منتقل شد. این کار اشکالی را که باعث می‌شد Exoplayer در نسخه‌های پایین‌تر API اندروید روی Surface composables رندر نشود، برطرف می‌کند. ( 9858ffb )

نسخه ۱.۰.۰

۲۱ آگوست ۲۰۲۴

androidx.tv:tv-material:1.0.0 منتشر شد. نسخه ۱.۰.۰ اولین نسخه پایدار androidx.tv:tv-material است.

نسخه ۱.۰.۰-rc02

۷ آگوست ۲۰۲۴

androidx.tv:tv-material:1.0.0-rc02 منتشر شد. نسخه 1.0.0-rc02 شامل این کامیت‌ها است.

رفع اشکالات

  • مشکل انیمیشن متن نامنظم در Surface composable برطرف شد. ( 3163319 )

نسخه ۱.۰.۰-rc01

۱۰ ژوئیه ۲۰۲۴

androidx.tv:tv-material:1.0.0-rc01 منتشر شد. نسخه 1.0.0-rc01 شامل این کامیت‌ها است.

نسخه ۱.۰.۰-بتا۰۱

۱ مه ۲۰۲۴

androidx.tv:tv-material:1.0.0-beta01 منتشر شد. نسخه 1.0.0-beta01 شامل این کامیت‌ها است.

تغییرات API

  • ColorScheme و توابع کاربردی آن اکنون پایدار هستند. ( If34fa )
  • LocalContentColor اکنون پایدار است ( I60ee2 )
  • API Typography اکنون پایدار است ( I088d6 )
  • APIهای شکل‌ها اکنون پایدار هستند ( I0f5f4 )
  • رابط برنامه‌نویسی کاربردی حاشیه اکنون پایدار است ( I69281 )
  • رابط برنامه‌نویسی کاربردی Glow اکنون پایدار است ( Iea5f1 )
  • کامپوننت آیکون اکنون پایدار است ( I62c2d )
  • API LocalTextStyles اکنون پایدار است ( Iaded8 )
  • API MaterialTheme اکنون پایدار است ( I2f541 )
  • کامپوننت متن اکنون پایدار است ( Ib9e31 )
  • کامپوننت RadioButton اکنون پایدار است ( Ia03c8 )
  • کامپوننت سوئیچ اکنون پایدار است ( I6cea3 )
  • اجزای Checkbox اکنون پایدار هستند ( I7eafc )
  • اجزای سطحی اکنون پایدار هستند ( I58758 ، I04aca )
  • نام NonInteractiveSurfaceDefaults به SurfaceDefaults و NonInteractiveSurfaceColors به SurfaceColors ( I0812e ) تغییر یافت.
  • سطح قابل انتخاب اکنون به جای «بررسی» از اصطلاح «انتخاب» استفاده می‌کند زیرا هر دو معنای متفاوتی دارند ( I5a206 )
  • NavigationDrawer و NavigationDrawerScope اکنون پایدار هستند ( I249c1 )
  • کامپوننت NavigationDrawerItem اکنون پایدار است ( ID6986 )
  • اجزای Tab و TabRow اکنون پایدار هستند ( I92d92 )
  • کامپوننت‌های Button ، OutlinedButton ، IconButton ، OutlinedIconButton و WideButton اکنون پایدار هستند ( Ib4de8 )
  • کامپوننت‌های Card ، ClassicCard ، CompactCard ، WideClassicCard ، StandardCardContainer و WideCardContainer اکنون پایدار هستند ( I34390 )
  • تغییر نام StandardCardLayout به StandardCardContainer و WideCardLayout به WideCardContainer ( I08883 )
  • CardContainerDefaults.ImageCard حذف شده و CardDefaults.ContainerGradient به CardDefaults.ScrimBrush تغییر نام داده شده است ( I6adfe ). می‌توانید از Card به جای CardContainerDefaults.ImageCard در کانتینرهای کارت خود استفاده کنید.
  • ListItem و DenseListItem اکنون پایدار هستند ( Idebd9 )
  • ListItemDefaults.ListItemShape ، ListItemDefaults.FocusedDisabledBorder و ListItemDefaults.SelectedContainerColorOpacity اکنون خصوصی هستند ( I5d533 )
  • پارامترهای ListItem را دوباره مرتب کرده و ListItemDefaults.ListItemElevation به ListItemDefaults.TonalElevation ( با شناسه Id6841 ) تغییر نام داده است. پارامتر headlineContent به بالای composable منتقل شده است. پیش از این، می‌توانستید از سینتکس لامبدا انتهایی کاتلین برای ارسال headlineContent استفاده کنید. اکنون، باید از سینتکس پارامتر نامگذاری شده برای ارائه headlineContent استفاده کنید.
  • LocalAbsoluteTonalElevation اکنون داخلی است ( Ibfc65 )
  • کامپوننت ImmersiveList حذف شده است. برای یادگیری نحوه ساخت آن توسط خودتان، این نمونه را بررسی کنید. ( Id48da )
  • کامپوننت‌های tv-material که در API خود یک MutableInteractionSource نمایش می‌دهند، به‌روزرسانی شده‌اند تا اکنون یک MutableInteractionSource تهی‌پذیر را نمایش دهند که مقدار پیش‌فرض آن null است. در اینجا هیچ تغییر معنایی وجود ندارد: ارسال null به این معنی است که شما نمی‌خواهید MutableInteractionSource را بالا ببرید و در صورت نیاز، درون کامپوننت ایجاد می‌شود. تغییر به null به برخی از کامپوننت‌ها اجازه می‌دهد هرگز MutableInteractionSource را اختصاص ندهند و به سایر کامپوننت‌ها اجازه می‌دهد فقط در صورت نیاز، نمونه‌ای را به صورت تنبل ایجاد کنند که این امر عملکرد را در این کامپوننت‌ها بهبود می‌بخشد. اگر از MutableInteractionSource که به این کامپوننت‌ها ارسال می‌کنید استفاده نمی‌کنید، توصیه می‌شود به جای آن null را ارسال کنید. همچنین توصیه می‌شود تغییرات مشابهی را در کامپوننت‌های خود ایجاد کنید. ( I309b4 , b/298048146 )
  • پارامتر TextAlign کامپوننت TV Text اکنون غیر تهی است ( Ib73b1 ، b/299490814 )
  • یک مقدار نامشخص ویژه برای فیلدهای TextAlign ، TextDirection ، Hyphens و LineBreak از ParagraphTextStyle برای جایگزینی معرفی شد ( I4197e ، b/299490814 )

تغییرات رفتاری

  • مقدار پیش‌فرض پارامتر shape برای Surface غیرتعاملی به RectangleShape ( I1b859cb ) تغییر یافته است.
  • برخی از ویژگی‌های چرخ فلک به دلیل آزمایشی بودن APIهای لازم ( I0e755d4 ) برای نسخه بتا حذف شده‌اند.
  • تغییر contentColor در Surface دیگر بین حالت‌ها انیمیشن ایجاد نمی‌کند ( I436e794f )

نسخه ۱.۰.۰

نسخه ۱.۰.۰-بتا۰۱

۱۱ مارس ۲۰۲۶

androidx.tv:tv-foundation:1.0.0-beta01 منتشر شد. نسخه 1.0.0-beta01 شامل این کامیت‌ها است.

تغییرات API

  • پروژه‌های منتشر شده با کاتلین ۲.۰ برای استفاده به KGP 2.0.0 یا جدیدتر نیاز دارند ( Idb6b5 ، b/344563182 )

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

۱۵ ژانویه ۲۰۲۵

androidx.tv:tv-foundation:1.0.0-alpha12 منتشر شد. نسخه 1.0.0-alpha12 شامل این کامیت‌ها است.

تغییرات API

  • طرح‌بندی‌های تنبل (lazy layouts) را از tv-foundation پاک کنید. برای مهاجرت از طرح‌بندی‌های تنبل tv-foundation به یادداشت‌های انتشار ۱.۰.۰-alpha11 مراجعه کنید. ( I2fdd3 ، b/358913893 )

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

۱۰ ژوئیه ۲۰۲۴

androidx.tv:tv-foundation:1.0.0-alpha11 منتشر شد. نسخه 1.0.0-alpha11 شامل این کامیت‌ها است.

تغییرات API

  • طرح‌بندی‌های تنبل تلویزیون (Tv Lazy Layout) از کتابخانه tv-foundation منسوخ شده‌اند. برای یادگیری نحوه مهاجرت از طرح‌بندی‌های تنبل تلویزیون به این تیکت مراجعه کنید. ( I0855f , b/332674072 )
  • PlatformImeOptions اکنون به جای یک رابط، یک کلاس عینی است. ( If40a4 )

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

۴ اکتبر ۲۰۲۳

androidx.tv:tv-foundation:1.0.0-alpha10 و androidx.tv:tv-material:1.0.0-alpha10 منتشر شدند. نسخه 1.0.0-alpha10 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • NavigationDrawerItem برای استفاده در NavigationDrawer و ModalNavigationDrawer معرفی شد. ( I4b491 )
  • نمایه پایه را به کتابخانه tv-foundation اضافه کنید. ( 2b57fd7 )
  • نمایه پایه را به کتابخانه tv-material اضافه کنید. ( 1711ff5 )

تغییرات API

  • نام NavigationDrawerScope.doesTabRowHaveFocus به NavigationDrawerScope.hasFocus تغییر یافت ( I8286b ).
  • تغییر نام TabRowScope.isActivated به TabRowScope.hasFocus ( Ic4273 )

رفع اشکالات

  • رفع مشکل سازگاری Carousel با آیتم‌های مجاور که از APIهای بازیابی فوکوس استفاده می‌کنند. ( 7b2a7a4 )
  • نشانگر درخشش را برای API_LEVEL زیر ۲۸ غیرفعال کنید زیرا توسط سیستم عامل پشتیبانی نمی‌شود. ( 6d3616f )
  • رفع مشکل کرش کردن ANR که به دلیل قرار دادن نادرست آیتم‌ها در lazy containers هنگام اسکرول سریع در جهت معکوس ایجاد می‌شد. ( 642d65c )
  • فاصله‌گذاری پس‌زمینه در منوی ناوبری مودال حذف شد. ( 69965b2 )
  • رفع مشکل رسم خط و خش در کشوی ناوبری به جای پشت محتوای پس‌زمینه، بالای آن رسم شود ( d4bbefb )

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

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

androidx.tv:tv-foundation:1.0.0-alpha09 و androidx.tv:tv-material:1.0.0-alpha09 منتشر شدند. نسخه 1.0.0-alpha09 شامل این کامیت‌ها است.

تغییرات API

  • رابط ReusableComposition را برای مدیریت چرخه حیات و استفاده مجدد از زیرترکیب‌ها اضافه کنید. ( I812d1 , b/252846775 )
  • همگام‌سازی انشعاب tv-foundation با compose-foundation. ( I737c3 ، b/287011882 )
  • سربارگذاری LazyLayout اضافه شده است، یک لامبدا از LazyLayoutItemProvider را می‌پذیرد، نه یک شیء ساده مانند قبل. سربارگذاری قبلی منسوخ شده است. ( I42a5a )
  • TvKeyboardAlignment را اضافه کنید تا به توسعه‌دهنده اجازه دهید موقعیت صفحه‌کلید روی صفحه را از طریق AndroidImeOptions پیکربندی کند. ( Idb772 )
  • برای ذخیره CarouselState با استفاده از Saver to TV Compose Material، rememberCarouselState را اضافه کنید. ( شناسه ۷۲۷۵ )
  • تغییر پارامتر scrimColor: Color به پارامتر scrimBrush:Brush برای اینکه کاربران بتوانند به اسکریم گرادیان اضافه کنند. ( I254d4 )

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

۲۶ ژوئیه ۲۰۲۳

androidx.tv:tv-foundation:1.0.0-alpha08 و androidx.tv:tv-material:1.0.0-alpha08 منتشر شدند. نسخه 1.0.0-alpha08 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • معرفی قطعات تراشه برای Compose برای محتوای تلویزیونی. ( I86da4 )
  • کامپوننت ListItem را به TV Compose Material اضافه کنید. ( I3f0b3 )
  • کامپوننت DenseListItem را به TV Compose Material اضافه کنید. ( I536bf )

تغییرات API

  • APIهای مربوط به محتوای تلویزیونی عمومی به عنوان آزمایشی علامت‌گذاری شدند. ( I632e7 )
  • TabRowScope برای اشتراک‌گذاری حالت از TabRow composable با Tab composable معرفی شد و ویژگی‌های TabColors به ​​آن تغییر نام داد. ( Ief587 )

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

۷ ژوئن ۲۰۲۳

androidx.tv:tv-foundation:1.0.0-alpha07 و androidx.tv:tv-material:1.0.0-alpha07 منتشر شدند. نسخه 1.0.0-alpha07 شامل این کامیت‌ها است.

تغییرات API

  • نشانگرهای مقیاس اجزا اکنون شامل None برای غیرفعال کردن مقیاس‌بندی هستند. ( I50df5 )
  • پشتیبانی از کلیک طولانی برای سطح متریال تلویزیون، کارت‌ها و دکمه‌ها اضافه شد. ( Id2b89 )
  • CarouselItem و CarouselScope حذف شده‌اند. انیمیشن محتوای پیش‌زمینه را می‌توان با استفاده از Modifier.animateEnterExit از AnimatedContentScope در اسلاید ایجاد کرد. ( Ic038e )
  • پارامترهای color و contentColor به عنوان colors برای سطح مواد تلویزیون ادغام شدند. ( Ie69eb )
  • قابلیت ترکیب RadioButton در TV Material معرفی شد. ( I08690 )
  • قابلیت ترکیب Switch در محتوای تلویزیونی معرفی شد. ( I45e29 )
  • قابلیت ساخت Checkbox در TV Material معرفی شد. ( I6a45a )
  • سطح غیر قابل تعامل در مواد تلویزیون معرفی شد. ( Ic5f85 )
  • نشانه‌ها را داخلی کنید. ( Ibff82 )

نسخه ۱.۰.۰-alpha06

۱۹ آوریل ۲۰۲۳

androidx.tv:tv-foundation:1.0.0-alpha06 و androidx.tv:tv-material:1.0.0-alpha06 منتشر شدند. نسخه 1.0.0-alpha06 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • پیاده‌سازی‌های کارت Material 3 بهینه شده برای تلویزیون را اضافه کنید.
    • کارت پایه ( I5b701 )
    • ClassicCard ، CompactCard و WideClassicCard ( I70471 )
    • StandardCardLayout و WideCardLayout ( I33fae )
  • پیاده‌سازی دکمه‌های Material 3 که برای تلویزیون بهینه شده‌اند را اضافه کنید.
    • دکمه پایه ( I69c11 )
    • IconButton و OutlinedIconButton ( Ib504c )
    • WideButton ( I4cecf )

تغییرات API

  • نام CarouselSlide و slideCount در Carousel به CarouselItem و itemCount تغییر یافت. ( Ie554c )
  • نام ContentTransforms forward و backward به StartToEnd و EndToStart تغییر یافت. ( Ie554c )

رفع اشکالات

  • دکمه DPAD را هنگام فوکوس روی NavigationDrawer به عقب برگردانید. ( d654f4 )

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

۲۲ مارس ۲۰۲۳

androidx.tv:tv-foundation:1.0.0-alpha05 و androidx.tv:tv-material:1.0.0-alpha05 منتشر شدند. نسخه 1.0.0-alpha05 شامل این کامیت‌ها است.

تغییرات API

  • معرفی کشوی ناوبری جانبی قابل ترکیب در tv-material . برای یادگیری نحوه استفاده از این ترکیب، لطفاً به نمونه‌ها مراجعه کنید. ( I12c08 )
  • معرفی آیکون قابل ترکیب در TV Material 3 ( I72db9 )
  • معرفی Surface Composable to tv-material با نشانه‌هایی مانند Border، Glow و Scale که می‌توانند برای ساخت اجزایی که به وضوح عنصر مورد نظر را روی صفحه تلویزیون برجسته می‌کنند، استفاده شوند. ( I4a6d8 ), ( Iceea1 ), ( Iee4d4 ), ( I79edf ), ( Icb376 )
  • CarouselItem به CarouselSlide به‌روزرسانی کنید تا با نام پارامتر slideCount در API مربوط به 'Carousel' ( Ic4299 ) مطابقت داشته باشد.

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

۸ فوریه ۲۰۲۳

androidx.tv:tv-foundation:1.0.0-alpha04 و androidx.tv:tv-material:1.0.0-alpha04 منتشر شدند. نسخه 1.0.0-alpha04 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • در ردیف‌ها، ستون‌ها و شبکه‌های تنبل، در صورت لزوم، محور (pivot) لغو می‌شود تا از نمایش کل آیتم اطمینان حاصل شود. ( 11d7e40 )
  • سفارشی‌سازی رنگ تب‌ها در حالت‌های مختلف اضافه شد. ( 21b2925 )
  • چرخ فلک اکنون انیمیشن‌های سفارشی را برای پیمایش دستی به جلو و عقب می‌پذیرد. ( 431494a )

تغییرات API

  • تغییر نام androidx.tv.material به androidx.tv.material3 و مسطح‌سازی ساختار بسته تحت androidx.tv.material3 ( I6ca52 )
  • نشانگر درون ردیف نشانگر چرخ فلک اکنون یک جایگاه است که می‌تواند توسط توسعه‌دهنده سفارشی‌سازی شود. ( 268af2a )
  • نام focusableItem به immersiveListItem تغییر یافت. کاربران باید به صورت دستی اصلاح‌کننده‌های focusable() یا clickable() را به همراه immersiveListItem اضافه کنند ( 5dd5078 )( b/263061052 )
  • نام timeToDisplayMillis در کامپوننت Carousel به autoScrollDurationMillis تغییر یافت. ( 431494a )
  • اکنون استفاده از CarouselItem در Carousel محدود شده است. ( 431494a )
  • اکنون Carousel به جای EnterTransition و ExitTransitions ContentTransforms به عنوان تعریف انیمیشن می‌پذیرد. ( 431494a )
  • API PinnableContainer معرفی شد که توسط لیست‌های تنبل از طریق یک ترکیب محلی منتشر می‌شود و امکان پین کردن آیتم فعلی را فراهم می‌کند. ( Ib8881 ، b/259274257 ، b/195049010 )
  • ویژگی mainAxisItemSpacing به TvLazyListLayoutInfo و TvLazyGridLayoutInfo ( I37765 ) اضافه شد.

رفع اشکالات

  • ردیف برگه‌ها را به‌روزرسانی کنید تا مطمئن شوید که تعداد برگه‌های ۰ یا ۱ را به درستی مدیریت می‌کند. ( I44009 ), ( 1c01525 ), ( b/264018028 )
  • رفع مشکل از کار افتادن focus-search وقتی که TvLazyColumn حاوی TvLazyRow خالی بود. ( e11b4fe )، ( b/260299091 )
  • اصلاح‌کننده‌ی clickable اکنون با ImmersiveList کار می‌کند. ( 5dd5078 )، ( b/263061052 )
  • کلید برگشت اکنون مدیریت می‌شود و برای خروج از چرخ فلک ویژه استفاده می‌شود. ( 84c138c )
  • چرخ فلک با فشردن سریع چندین کلید، فوکوس را از دست نمی‌دهد. ( 799489f )
  • چرخ فلک با فشردن طولانی کلیدها فوکوس را از دست نمی‌دهد. ( b2cf37e )
  • رفع مشکل از کار افتادن صفحه هنگام تغییر تعداد اسلایدهای چرخ فلک ( b261247 )

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

۷ دسامبر ۲۰۲۲

androidx.tv:tv-foundation:1.0.0-alpha03 و androidx.tv:tv-material:1.0.0-alpha03 منتشر شدند. نسخه 1.0.0-alpha03 شامل این کامیت‌ها است.

ویژگی‌های جدید

  • TabRow اکنون به عنوان یک API آزمایشی در دسترس است که به کاربران امکان می‌دهد نوارهای ناوبری بالایی را به برنامه‌های خود اضافه کنند. به طور کلی، دستگاه‌های تلویزیون انتظار دارند که تب‌ها زمانی بارگذاری شوند که عنوان تب در ردیف تب‌ها مشخص باشد.
  • نشانگرهای مخصوص تلویزیون مانند نشانگر زیرخط و نشانگر قرص به صورت پیش‌فرض ارائه می‌شوند. نمونه‌هایی از کاربرد آنها را می‌توانید در نمونه‌های تلویزیون پیدا کنید.

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

۹ نوامبر ۲۰۲۲

androidx.tv:tv-foundation:1.0.0-alpha02 و androidx.tv:tv-material:1.0.0-alpha02 منتشر شدند. نسخه 1.0.0-alpha02 شامل این کامیت‌ها است.

رفع اشکالات

  • با کاهش فضای جستجوی فوکوس، عملکرد پیمایش هنگام پیمایش مجموعه‌ای از TvLazyRows/TvLazyColumns بهبود یافت. ( I723a3 )

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

۵ اکتبر ۲۰۲۲

androidx.tv:tv-foundation:1.0.0-alpha01 و androidx.tv:tv-material:1.0.0-alpha01 منتشر شدند. نسخه 1.0.0-alpha01 شامل این کامیت‌ها است.

ویژگی‌های جدید

اولین نسخه آلفا شامل پیاده‌سازی‌های پیش‌نمایش اولیه از مؤلفه‌ها برای موارد استفاده در تلویزیون است، از جمله:

  • اضافه کردن اصلاح‌کننده scrollableWithPivot برای اینکه به کانتینرهای پیمایش غیر تنبل مانند Row، Column، Grid اجازه داده شود که کانتینر پیمایش، محتوا را پیمایش کند تا آیتم مورد نظر در همان موقعیت روی صفحه تلویزیون باقی بماند.
  • با افزودن ترکیب‌های TvLazyRow ، TvLazyColumn ، TvLazyHorizontalGrid و TvLazyVerticalGrid ، کانتینر پیمایش، محتوا را پیمایش می‌کند تا آیتم مورد نظر در همان موقعیت روی صفحه تلویزیون باقی بماند.
  • اضافه کردن چرخ فلک ویژه قابل ترکیب برای تلویزیون که به کاربر اجازه می‌دهد یک چرخ فلک بنر با پیمایش خودکار ایجاد کند.
  • اضافه شدن فهرست فراگیر قابل ترکیب برای تلویزیون که به کاربر اجازه می‌دهد یک سطر/ستون/شبکه ​​فراگیر ایجاد کند که پس‌زمینه را بر اساس آیتم لیست که در فوکوس قرار دارد تغییر می‌دهد.

مشکلات شناخته شده

  • وقتی عنصر پیمایشی فوکوس را به دست می‌آورد، عنصر اول به طور پیش‌فرض فوکوس را به دست نمی‌آورد.
  • تمرکز روی یک TextField همیشه صفحه کلید را باز نمی‌کند یا می‌تواند مانع از حرکت تمرکز به فیلدهای دیگر شود.
  • پیمایش عمودی در یک LazyColumn حاوی LazyRows عملکرد ضعیفی دارد.