تلویزیون
| آخرین به روز رسانی | انتشار پایدار | کاندید را آزاد کنید | نسخه بتا | انتشار آلفا |
|---|---|---|---|---|
| 16 جولای 2025 | 1.0.1 | - | - | 1.1.0-alpha01 |
اعلام وابستگی ها
برای افزودن وابستگی به tv-fondation و tv-material، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Maven Google را بخوانید.
وابستگیهای مصنوعات مورد نیاز خود را در فایل build.gradle برای برنامه یا ماژول خود اضافه کنید:
شیار
dependencies { implementation "androidx.tv:tv-foundation:1.0.0-alpha12" implementation "androidx.tv:tv-material:1.1.0-alpha01" }
کاتلین
dependencies { implementation("androidx.tv:tv-foundation:1.0.0-alpha12") implementation("androidx.tv:tv-material:1.1.0-alpha01") }
برای اطلاعات بیشتر درباره وابستگیها، به افزودن وابستگیهای ساخت نگاه کنید.
بازخورد
بازخورد شما به بهتر شدن Jetpack کمک می کند. اگر مسائل جدیدی کشف کردید یا ایده هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد کتابخانه جدید، به مسائل موجود در این کتابخانه نگاهی بیندازید. با کلیک کردن روی دکمه ستاره می توانید رای خود را به یک موضوع موجود اضافه کنید.
برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.
هیچ یادداشت انتشار برای این مصنوع وجود ندارد.
Tv-Material نسخه 1.1
نسخه 1.1.0-alpha01
15 ژانویه 2025
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را از سطح به متن منتقل کرد تا متن لرزان را در حین مقیاسگذاری برطرف کند. ( I92b15f17 ) - رفع مشکل مدیریت فوکوس شکسته در چرخ فلک ( Ie508b721375 )
- سطح (غیر تعاملی) در مقایسه با موارد تعاملی، پیاده سازی ساده شده ای دارد. ( I7ea545150 )
Tv-Material نسخه 1.0
نسخه 1.0.1
16 جولای 2025
androidx.tv:tv-material:1.0.1 منتشر شد. نسخه 1.0.1 شامل این commit ها است.
رفع اشکال
- ارتفاع
NavigationDrawerItemرا برای مطابقت با مشخصات به روز کرد. ( cf9a3ce ) - پیکربندی استراتژی ترکیببندی را از Surface composable به Text composable منتقل کرد. با این کار مشکلی که Exoplayer در نسخههای پایینتر API Android در Surface composableها رندر نمیکرد، برطرف میکند. ( 9858ffb )
نسخه 1.0.0
21 آگوست 2024
androidx.tv:tv-material:1.0.0 منتشر شد. نسخه 1.0.0 اولین نسخه پایدار androidx.tv:tv-material است.
نسخه 1.0.0-rc02
7 آگوست 2024
androidx.tv:tv-material:1.0.0-rc02 منتشر شد. نسخه 1.0.0-rc02 حاوی این commit ها است.
رفع اشکال
- انیمیشن متن Jittery ثابت در Surface composable. ( 3163319 )
نسخه 1.0.0-rc01
10 جولای 2024
androidx.tv:tv-material:1.0.0-rc01 منتشر شد. نسخه 1.0.0-rc01 حاوی این commit ها است.
نسخه 1.0.0-beta01
1 مه 2024
androidx.tv:tv-material:1.0.0-beta01 منتشر شد. نسخه 1.0.0-beta01 حاوی این تعهدات است.
تغییرات API
-
ColorSchemeو توابع کاربردی آن اکنون پایدار هستند. ( If34fa ) -
LocalContentColorاکنون پایدار است ( I60ee2 ) -
TypographyAPI اکنون پایدار است ( I088d6 ) - APIهای Shapes اکنون پایدار هستند ( I0f5f4 )
- Border API اکنون پایدار است ( I69281 )
- Glow API اکنون پایدار است ( Iea5f1 )
- مؤلفه نماد اکنون پایدار است ( I62c2d )
-
LocalTextStylesAPI اکنون پایدار است ( Iaded8 ) -
MaterialThemeAPI اکنون پایدار است ( I2f541 ) - مؤلفه متن اکنون پایدار است ( Ib9e31 )
- مؤلفه
RadioButtonاکنون پایدار است ( Ia03c8 ) - جزء سوئیچ اکنون پایدار است ( I6cea3 )
- اجزای
Checkboxاکنون پایدار هستند ( I7eafc ) - اجزای سطح اکنون پایدار هستند ( I58758 , I04aca )
- تغییر نام
NonInteractiveSurfaceDefaultsبهSurfaceDefaultsوNonInteractiveSurfaceColorsبهSurfaceColors( I0812e ) - Selectable Surface اکنون از اصطلاح "انتخاب" به جای "بررسی" استفاده می کند زیرا هر دو معنای معنایی متفاوتی دارند ( 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 که یک
MutableInteractionSourceرا در API خود نشان میدهند، بهروزرسانی شدهاند تا اکنون یک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 )
نسخه 1.0.0
نسخه 1.0.0-alpha12
15 ژانویه 2025
androidx.tv:tv-foundation:1.0.0-alpha12 منتشر شد. نسخه 1.0.0-alpha12 حاوی این تعهدات است.
تغییرات API
- طرحبندیهای تنبل را از tv-foundation پاک کنید. به یادداشتهای انتشار 1.0.0-alpha11 مراجعه کنید تا از طرحبندیهای تنبل بنیاد تلویزیون دور شوید. ( I2fdd3 , b/358913893 )
نسخه 1.0.0-alpha11
10 جولای 2024
androidx.tv:tv-foundation:1.0.0-alpha11 منتشر شد. نسخه 1.0.0-alpha11 حاوی این تعهدات است.
تغییرات API
- طرحبندیهای تنبل تلویزیون از کتابخانه بنیاد تلویزیون منسوخ شدهاند. برای یادگیری نحوه مهاجرت به دور از طرحبندیهای تنبل تلویزیون، به این بلیط مراجعه کنید. ( I0855f , b/332674072 )
-
PlatformImeOptionsاکنون یک کلاس مشخص به جای یک رابط است. ( If40a4 )
نسخه 1.0.0-alpha10
4 اکتبر 2023
androidx.tv:tv-foundation:1.0.0-alpha10 و androidx.tv:tv-material:1.0.0-alpha10 منتشر شد. نسخه 1.0.0-alpha10 حاوی این commit ها است.
ویژگی های جدید
-
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 زیر 28 غیرفعال کنید زیرا توسط سیستم عامل پشتیبانی نمیشود. ( 6d3616f )
- خرابی ANR ناشی از قرارگیری نامناسب مورد در ظروف تنبل هنگام پیمایش سریع در جهت معکوس را برطرف کنید. ( 642d65c )
- بالشتک پسزمینه در کشو ناوبری معین حذف شد. ( 69965b2 )
- Scrim را در کشو ناوبری ثابت کنید تا به جای پشت آن، بالای محتوای پسزمینه کشیده شود. ( d4bbefb )
نسخه 1.0.0-alpha09
6 سپتامبر 2023
androidx.tv:tv-foundation:1.0.0-alpha09 و androidx.tv:tv-material:1.0.0-alpha09 منتشر شد. نسخه 1.0.0-alpha09 حاوی این commit ها است.
تغییرات API
- افزودن رابط کاربری
ReusableCompositionبرای مدیریت چرخه عمر و استفاده مجدد از ترکیبات فرعی. ( I812d1 , b/252846775 ) - همگام سازی فونداسیون تلویزیون با فونداسیون آهنگسازی. ( I737c3 , b/287011882 )
- اضافه بار
LazyLayoutاضافه شده است، یک لامبدا ازLazyLayoutItemProviderرا می پذیرد، نه یک شی ساده را مانند قبل. اضافه بار قبلی منسوخ شده است. ( I42a5a ) -
TvKeyboardAlignmentاضافه کنید تا به توسعه دهنده اجازه دهید موقعیت صفحه کلید روی صفحه را از طریقAndroidImeOptionsپیکربندی کند. ( Idb772 ) - برای به خاطر سپردن
CarouselStateباSaverبه TV Compose MaterialrememberCarouselStateرا اضافه کنید. ( ID7275 ) - تغییر
scrimColor: ColorبهscrimBrush:Brushپارامتر به کاربران اجازه می دهد تا شیب هایی را به scrim اضافه کنند. ( I254d4 )
نسخه 1.0.0-alpha08
26 جولای 2023
androidx.tv:tv-foundation:1.0.0-alpha08 و androidx.tv:tv-material:1.0.0-alpha08 منتشر شد. نسخه 1.0.0-alpha08 حاوی این commit ها است.
ویژگی های جدید
- اجزای تراشه را برای Compose برای مواد تلویزیونی معرفی کنید. ( I86da4 )
- جزء
ListItemرا به TV Compose Material اضافه کنید. ( I3f0b3 ) - جزء
DenseListItemرا به TV Compose Material اضافه کنید. ( I536bf )
تغییرات API
- APIهای عمومی tv-material به عنوان آزمایشی علامتگذاری شدند. ( I632e7 )
-
TabRowScopeبرای به اشتراک گذاشتن حالت ازTabRowcomposable با Tab composable معرفی کرد و ویژگیTabColorsتغییر نام داد. ( Ief587 )
نسخه 1.0.0-alpha07
7 ژوئن 2023
androidx.tv:tv-foundation:1.0.0-alpha07 و androidx.tv:tv-material:1.0.0-alpha07 منتشر شد. نسخه 1.0.0-alpha07 حاوی این commit ها است.
تغییرات API
- نشانههای مقیاس مؤلفهها اکنون شامل None برای غیرفعال کردن مقیاسبندی میشود. ( I50df5 )
- اضافه شدن پشتیبانی از کلیک طولانی برای سطح متریال تلویزیون، کارت ها و دکمه ها. ( ID2b89 )
-
CarouselItemوCarouselScopeحذف شده اند. انیمیشن محتوای پیش زمینه را می توان با استفاده ازModifier.animateEnterExitازAnimatedContentScopeدر اسلاید به دست آورد. ( IC038e ) - پارامترهای
colorوcontentColorبه عنوانcolorsبرای سطح مواد تلویزیون ادغام شدند. ( Ie69eb ) -
RadioButtonقابل ترکیب در مواد تلویزیونی را معرفی کرد. ( I08690 ) -
Switchقابل ترکیب در تلویزیون متریال معرفی شد. ( I45e29 ) -
Checkboxقابل ترکیب در تلویزیون متریال معرفی شد. ( I6a45a ) - سطح غیر قابل تعامل در متریال تلویزیون معرفی شد. ( IC5f85 )
- نشانه ها را درونی کنید. ( Ibff82 )
نسخه 1.0.0-alpha06
19 آوریل 2023
androidx.tv:tv-foundation:1.0.0-alpha06 و androidx.tv:tv-material:1.0.0-alpha06 منتشر شد. نسخه 1.0.0-alpha06 حاوی این commit ها است.
ویژگی های جدید
- پیاده سازی های کارت Material 3 را بهینه سازی شده برای تلویزیون اضافه کنید.
- افزودن مواد 3 اجرای دکمه بهینه سازی شده برای تلویزیون.
تغییرات API
-
CarouselSlideوslideCountدرCarouselبهCarouselItemanditemCountتغییر نام داد. ( Ie554c ) - تغییر نام
ContentTransformsforwardوbackwardبهStartToEndوEndToStartتبدیل می شود. ( Ie554c )
رفع اشکال
- هنگامی که روی
NavigationDrawerتمرکز می کنید، دکمه DPAD را به عقب برگردانید. ( d654f4 )
نسخه 1.0.0-alpha05
22 مارس 2023
androidx.tv:tv-foundation:1.0.0-alpha05 و androidx.tv:tv-material:1.0.0-alpha05 منتشر شد. نسخه 1.0.0-alpha05 حاوی این commit ها است.
تغییرات API
- معرفی کشو ناوبری جانبی قابل ترکیب در
tv-material. برای یادگیری نحوه استفاده از این ترکیب، لطفا به نمونه ها مراجعه کنید. ( I12c08 ) - معرفی Icon composable در TV Material 3 ( I72db9 )
- معرفی Surface قابل ترکیب برای
tv-materialبا نشانه هایی مانند Border، Glow و Scale، که می تواند برای ساخت اجزایی استفاده شود که به وضوح عنصر متمرکز روی صفحه تلویزیون را برجسته می کند. ( I4a6d8 )، ( Iceea1 )، ( Iee4d4 )، ( I79edf )، ( Icb376 ) -
CarouselItemبهCarouselSlideبهروزرسانی کنید تا با نام پارامترslideCountدر «Carousel» API مطابقت داشته باشد ( Ic4299 )
نسخه 1.0.0-alpha04
8 فوریه 2023
androidx.tv:tv-foundation:1.0.0-alpha04 و androidx.tv:tv-material:1.0.0-alpha04 منتشر شد. نسخه 1.0.0-alpha04 حاوی این commit ها است.
ویژگی های جدید
- در ردیفها، ستونها و شبکههای تنبل، در صورت لزوم، برای اطمینان از اینکه کل آیتم در معرض دید قرار میگیرد، محور اصلی لغو میشود. ( 11d7e40 )
- سفارشی سازی رنگ برگه ها را در حالت های مختلف اضافه کنید. ( 21b2925 )
- Carousel اکنون انیمیشن های سفارشی را برای اسکرول دستی به جلو و عقب می پذیرد. ( 431494a )
تغییرات API
- تغییر نام
androidx.tv.materialبهandroidx.tv.material3و صاف کردن ساختار بسته تحتandroidx.tv.material3. ( I6ca52 ) - نشانگر در ردیف نشانگر چرخ فلک اکنون یک شکاف است که می تواند توسط توسعه دهنده سفارشی شود. ( 268af2a )
-
focusableItemبهimmersiveListItemتغییر نام داد. کاربران باید به صورت دستی اصلاح کنندهfocusable()یاclickable()را به همراهimmersiveListItem( 5dd5078 ) ( b/263061052 ) اضافه کنند. - تغییر نام
timeToDisplayMillisبهautoScrollDurationMillisدر جزء چرخ فلک. ( 431494a ) -
CarouselItemاکنون برای استفاده درCarousel's محدود شده است. ( 431494a ) - Carousel اکنون
ContentTransformsبه عنوان تعریف انیمیشن به جایEnterTransitionوExitTransitionsمی پذیرد. ( 431494a ) - Api
PinnableContainerمعرفی شد که توسط لیستهای تنبل از طریق یک ترکیب محلی منتشر میشود که امکان پین کردن آیتم فعلی را فراهم میکند. ( Ib8881 , b/259274257 , b/195049010 ) - ویژگی
mainAxisItemSpacingبهTvLazyListLayoutInfoوTvLazyGridLayoutInfo( I37765 ) اضافه شد
رفع اشکال
- ردیف برگه را به روز کنید تا مطمئن شوید که تعداد برگه های 0 یا 1 را به درستی مدیریت می کند. ( I44009 )، ( 1c01525 )، ( b/264018028 )
- وقتی
TvLazyColumnحاویTvLazyRowخالی است، خرابی فوکوس جستجو را برطرف کنید. ( e11b4fe )، ( b/260299091 ) - اصلاح کننده
clickableاکنون باImmersiveListکار می کند. ( 5dd5078 )، ( b/263061052 ) - اکنون کلید برگشت کنترل می شود و برای خروج از چرخ فلک ویژه استفاده می شود. ( 84c138c )
- چرخ فلک تمرکز خود را روی فشار دادن چند کلید سریع از دست نمی دهد. ( 799489f )
- چرخ فلک تمرکز خود را روی فشار دادن طولانی کلیدها از دست نمی دهد. ( b2cf37e )
- وقتی تعداد اسلاید چرخ فلک تغییر می کند، خرابی ها برطرف می شود. ( b261247 )
نسخه 1.0.0-alpha03
7 دسامبر 2022
androidx.tv:tv-foundation:1.0.0-alpha03 و androidx.tv:tv-material:1.0.0-alpha03 منتشر شد. نسخه 1.0.0-alpha03 حاوی این commit ها است.
ویژگی های جدید
-
TabRowاکنون به عنوان یک API آزمایشی در دسترس است که به کاربران امکان می دهد نوارهای پیمایش برتر را به برنامه های خود اضافه کنند. به طور کلی، دستگاههای تلویزیون انتظار دارند زمانی که عنوان برگه در ردیف برگه متمرکز شده است، برگهها بارگیری شوند. - نشانگرهای خاص تلویزیون مانند نشانگر زیر خط و نشانگر قرص خارج از جعبه ارائه می شوند. کاربردهای نمونه را می توان در نمونه های تلویزیونی یافت
نسخه 1.0.0-alpha02
9 نوامبر 2022
androidx.tv:tv-foundation:1.0.0-alpha02 و androidx.tv:tv-material:1.0.0-alpha02 منتشر شد. نسخه 1.0.0-alpha02 حاوی این commit ها است.
رفع اشکال
- بهبود عملکرد پیمایش هنگام پیمایش در مجموعهای از
TvLazyRows/TvLazyColumnsبا کاهش فضای جستجوی فوکوس. ( I723a3 )
نسخه 1.0.0-alpha01
5 اکتبر 2022
androidx.tv:tv-foundation:1.0.0-alpha01 و androidx.tv:tv-material:1.0.0-alpha01 منتشر شد. نسخه 1.0.0-alpha01 حاوی این commit ها است.
ویژگی های جدید
آلفای اول شامل اجرای پیشنمایش اولیه مؤلفهها برای موارد استفاده از تلویزیون است، از جمله:
- افزودن اصلاحکننده
scrollableWithPivotبرای اینکه به محفظههای پیمایشی غیرتنبل مانند Row، Column، Grid اجازه داده شود تا محفظه پیمایش محتوا را بچرخاند تا مورد در فوکوس در همان موقعیت در صفحه تلویزیون باقی بماند. - افزودن ترکیبهای
TvLazyRow،TvLazyColumn،TvLazyHorizontalGrid،TvLazyVerticalGridبرای اینکه محفظه پیمایش محتوا را بچرخاند تا مورد در فوکوس در همان موقعیت در صفحه تلویزیون باقی بماند. - افزودن چرخ فلک ویژه قابل ساخت برای تلویزیون که به کاربر امکان می دهد یک چرخ فلک بنر پیمایش خودکار ایجاد کند.
- افزودن فهرست همه جانبه قابل ساخت برای تلویزیون که به کاربر امکان می دهد یک ردیف/ستون/شبکه همه جانبه ایجاد کند که پس زمینه را بر اساس آیتم فهرست در فوکوس تغییر می دهد.
مسائل شناخته شده
- وقتی ظرف پیمایش فوکوس پیدا می کند، عنصر اول به طور پیش فرض فوکوس نمی کند.
- فوکوس بر روی یک
TextFieldهمیشه صفحه کلید را باز نمی کند یا می تواند مانع از انتقال فوکوس به قسمت های دیگر شود. - پیمایش عمودی در
LazyColumnحاویLazyRowsعملکرد ضعیفی دارد.