بپوشید
androidx.wear.activity
androidx.wear.ambient
androidx.wear.input
androidx.wear.utils
androidx.wear.widget
androidx.wear.widget.drawer
( به refdocs برای همه بستههای پوشیدنی مراجعه کنید )
این جدول تمام مصنوعات گروه androidx.wear
را فهرست می کند.
مصنوع | انتشار پایدار | کاندید را آزاد کنید | نسخه بتا | انتشار آلفا |
---|---|---|---|---|
پوشیدن | 1.3.0 | - | - | 1.4.0-alpha01 |
ورودی سایش | 1.1.0 | - | - | 1.2.0-alpha02 |
تست ورودی-سایشی | 1.1.0 | - | - | 1.2.0-alpha02 |
مستمر | 1.0.0 | - | - | 1.1.0-alpha01 |
پوشیدن-تلفن-تعاملات | 1.0.1 | - | - | 1.1.0-alpha04 |
سایش-کنش های راه دور | 1.0.0 | 1.1.0-rc01 | - | - |
اعلام وابستگی ها
برای افزودن وابستگی به Wear، باید مخزن Google Maven را به پروژه خود اضافه کنید. برای اطلاعات بیشتر، مخزن Maven Google را بخوانید.
وابستگیهای مصنوعات مورد نیاز خود را در فایل build.gradle
برای برنامه یا ماژول خود اضافه کنید:
شیار
dependencies { implementation "androidx.wear:wear:1.3.0" // Add support for wearable specific inputs implementation "androidx.wear:wear-input:1.1.0" implementation "androidx.wear:wear-input-testing:1.1.0" // Use to implement wear ongoing activities implementation "androidx.wear:wear-ongoing:1.0.0" // Use to implement support for interactions from the Wearables to Phones implementation "androidx.wear:wear-phone-interactions:1.0.1" // Use to implement support for interactions between the Wearables and Phones implementation "androidx.wear:wear-remote-interactions:1.0.0" }
کاتلین
dependencies { implementation("androidx.wear:wear:1.3.0") // Add support for wearable specific inputs implementation("androidx.wear:wear-input:1.1.0") implementation("androidx.wear:wear-input-testing:1.1.0") // Use to implement wear ongoing activities implementation("androidx.wear:wear-ongoing:1.0.0") // Use to implement support for interactions from the Wearables to Phones implementation("androidx.wear:wear-phone-interactions:1.0.1") // Use to implement support for interactions between the Wearables and Phones implementation("androidx.wear:wear-remote-interactions:1.0.0") }
برای اطلاعات بیشتر درباره وابستگیها، به افزودن وابستگیهای ساخت نگاه کنید.
بازخورد
بازخورد شما به بهتر شدن Jetpack کمک می کند. اگر مسائل جدیدی کشف کردید یا ایده هایی برای بهبود این کتابخانه دارید، به ما اطلاع دهید. لطفاً قبل از ایجاد کتابخانه جدید، به مسائل موجود در این کتابخانه نگاهی بیندازید. با کلیک کردن روی دکمه ستاره می توانید رای خود را به یک موضوع موجود اضافه کنید.
برای اطلاعات بیشتر به مستندات ردیاب مشکل مراجعه کنید.
Wear Core نسخه 1.0
نسخه 1.0.0-alpha01
29 مه 2024
androidx.wear:wear-core:1.0.0-alpha01
منتشر شد. نسخه 1.0.0-alpha01 حاوی این تعهدات است.
تغییرات API
- یک کلاس جدید
WearApiVersionhelper
اضافه کرد تا به بررسی سازگاری API در زمان اجرا در Wear کمک کند. کلاینت ها می توانند از این کلاس کمکی ثابت و روش ارائه شده (#isApiVersionAtLeast(VERSION)
) برای بررسی سازگاری استفاده کنند.
Wear Tooling Preview نسخه 1.0
نسخه 1.0.0
29 نوامبر 2023
androidx.wear:wear-tooling-preview:1.0.0
منتشر شد. نسخه 1.0.0 حاوی این commit ها است.
ویژگی های 1.0.0
-
WearDevices
به لیست دستگاههای پوشیدنی معتبری که میتوان برای پیشنمایش رابط کاربری استفاده کرد، اضافه کنید.
نسخه 1.0.0-rc01
15 نوامبر 2023
androidx.wear:wear-tooling-preview:1.0.0-rc01
بدون هیچ تغییری منتشر شد. نسخه 1.0.0-rc01 حاوی این commit ها است.
نسخه 1.0.0-beta01
18 اکتبر 2023
androidx.wear:wear-tooling-preview:1.0.0-beta01
بدون هیچ تغییری منتشر شد. نسخه 1.0.0-beta01 حاوی این تعهدات است.
نسخه 1.0.0-alpha01
23 آگوست 2023
androidx.wear:wear-tooling-preview:1.0.0-alpha01
منتشر شد. نسخه 1.0.0-alpha01 حاوی این commit ها است.
تغییرات API
-
WearDevices
به لیست دستگاههای پوشیدنی معتبری که میتوان برای پیشنمایش رابط کاربری استفاده کرد اضافه کنید ( Ib036e )
Wear نسخه 1.4
نسخه 1.4.0-alpha01
15 نوامبر 2023
androidx.wear:wear:1.4.0-alpha01
منتشر شد. نسخه 1.4.0-alpha01 حاوی این commit ها است.
رفع اشکال
- وقتی پیامی وجود ندارد، نماد
ConfirmationOverlay
در مرکز قرار دهید. ( I496d8 )
Wear نسخه 1.3
نسخه 1.3.0
9 آگوست 2023
androidx.wear:wear:1.3.0
بدون تغییر از 1.3.0-rc01
منتشر شده است. نسخه 1.3.0 حاوی این commit ها است.
تغییرات مهم از 1.2.0
- برای استفاده از
LifecycleObserver
ازAmbientModeSupport
مهاجرت کنید.AmbientModeSupport
به نفع کلاسهای جدید از چرخه حیات منسوخ کنید. - بهروزرسانی
ConfirmationOverlay
با نمادها/طرحبندی، فونتها و معیارهای فونت جدید -
SwipeDismissTransitionHelper
برای استفاده از پسزمینه قابل ترسیم بهجایView
دوم برای تصحیح خطاها هنگام استفاده ازFragmentContainerView
بهروزرسانی شد. - انیمیشن
SwipeDismissFrameLayout
بهروزرسانی شد تا با پلتفرم Wear و پیادهسازی Wear Compose سازگار باشد. - رفع اشکال
SwipeDismissFrameLayout
برای جلوگیری از حذف تصادفی قطعات با پرتاب عمودی -
ArcLayout
اکنون از وزنهای توسعه پشتیبانی میکند که به روشی مشابه وزنهای Layout معمولی عمل میکنند. - پشتیبانی از
layoutDirection
درArcLayout
نسخه 1.3.0-rc01
21 ژوئن 2023
androidx.wear:wear:1.3.0-rc01
بدون تغییر از 1.3.0-beta01
منتشر شده است. نسخه 1.3.0-rc01 حاوی این commit ها است.
نسخه 1.3.0-beta01
7 ژوئن 2023
androidx.wear:wear:1.3.0-beta01
منتشر شد. نسخه 1.3.0-beta01 حاوی این تعهدات است.
تغییرات API
- پس از بازخورد،
AmbientLifecycleObserver
به روز شد.AmbientLifecycleObserverInterface
بهAmbientLifecycleObserver
تغییر نام داده است و با فراخوانیAmbientLifecycleObserver(...)
می توان یک نمونه را بدست آورد.isAmbient
به جای متد به یک فیلد منتقل شده است. ( I84b4f )
رفع اشکال
- افزودن بررسیهای تهی برای رسیدگی به مواردی که نمای والد در هنگام بازنشانی آلفا و ترجمه در
SwipeToDismiss
خالی است. ( Ib0ec7 )
نسخه 1.3.0-alpha05
19 آوریل 2023
androidx.wear:wear:1.3.0-alpha05
منتشر شد. نسخه 1.3.0-alpha05 حاوی این commit ها است.
تغییرات API
- برای استفاده از
LifecycleObserver
ازAmbientModeSupport
مهاجرت کنید.AmbientModeSupport
به نفع کلاسهای جدید از چرخه حیات منسوخ کنید. ( I1593b )
رفع اشکال
- روش
SwipeDismissTransitionHelper
پسزمینه scrim را بهروزرسانی کنید تا در هنگام استفاده ازFragmentContainerView
به جای افزودن نمای برای رفع خطاها، از ترسیمها استفاده کنید. ( I851cd )
نسخه 1.3.0-alpha04
25 ژانویه 2023
androidx.wear:wear:1.3.0-alpha04
منتشر شد. نسخه 1.3.0-alpha04 حاوی این commit ها است.
رفع اشکال
- ما انیمیشن را در
SwipeDismissFrameLayout
بهروزرسانی کردهایم تا با پلتفرم Wear و اجرای Wear Compose سازگار باشد. ( I7261b )
نسخه 1.3.0-alpha03
24 آگوست 2022
androidx.wear:wear:1.3.0-alpha03
منتشر شد. نسخه 1.3.0-alpha03 حاوی این commit ها است.
ویژگی های جدید
-
ArcLayout
اکنون از وزنهای توسعه پشتیبانی میکند که به روشی مشابه وزنهای Layout معمولی عمل میکنند. این بدان معنی است که شما می توانید اندازه نسبی عناصر فرزند را بدون نیاز به محاسبه مستقیم زاویه آنها مشخص کنید. ما همچنین بهترین تلاشMaxAngleDegrees
را اضافه کردهایم که در هنگام گسترش عناصر کودک با وزن مورد احترام قرار میگیرد. به عنوان مثال می توانید قوس را با چند کودک با وزنه تا 90 درجه ببندید، این کار به فضای اشغال شده توسط عناصر غیر منبسط شده نیز احترام می گذارد.
تغییرات API
- ما وزنی را به
ArcLayout.LayoutParams
اضافه کردهایم که به ویجت اجازه میدهد فضای موجود را پر کند، اگر بیش از یک ویجت وجود داشته باشد، سهم آنها از فضای موجود متناسب با وزن آنها است. علاوه بر این،ArcLayout.setMaxAngleDegrees
اضافه کردهایم تا بتوانید برای مثال بسط را در 90 درجه محدود کنید (توجه داشته باشید که این روی چیدمان هیچ ابزارک با اندازه ثابت تأثیر نمیگذارد). در نهایتArcLayout.Widget
اکنون دارایsetSweepAngleDegrees
است که بهArcLayout
اجازه می دهد تا ویجتی را با وزن غیر صفر اندازه آن اطلاع دهد. ( I75f24 ) - پوچ پذیری به روز شده
setColorFilter
( I99ddf , b/236498063 )
نسخه 1.3.0-alpha02
23 فوریه 2022
androidx.wear:wear:1.3.0-alpha02
منتشر شد. نسخه 1.3.0-alpha02 حاوی این commit ها است.
ویژگی های جدید
- پشتیبانی از
layoutDirection
درArcLayout
( I14d49 ) - پیام توضیح محتوای بهبود یافته برای ConfirmationOverlay ( I0fdf8 )
-
ConfirmationOverlay
با نمادها/طرح بندی جدید به روز کنید. ( If5b54 )
رفع اشکال
- قوانین ProGuard اضافه شد تا اطمینان حاصل شود که کدهای مربوط به محیط حفظ می شود ( Idaa10 )
- از رد تصادفی قطعات در SwipeDismissFrameLayout با پرتاب عمودی خودداری کنید ( Idb6d8 )
- رفع ConfirmationOverlay زمانی که پیامی ندارد ( I63e6f )
مشارکت خارجی
- Dae Gyu LEE (سامسونگ) - از حذف تصادفی قطعات در SwipeDismissFrameLayout با پرتاب عمودی خودداری کنید ( Idb6d8 )
نسخه 1.3.0-alpha01
29 سپتامبر 2021
androidx.wear:wear:1.3.0-alpha01
منتشر شد. نسخه 1.3.0-alpha01 حاوی این commit ها است.
رفع اشکال
-
ConfirmationOverlay
اکنون نماد را به سمت بالا فشار می دهد تا پیام های طولانی تر را در خود جای دهد، بدون اینکه پیام وارد قاب دستگاه (یا خارج از صفحه) شود. ( I54bff )
Wear Congoing & Interactions نسخه 1.1.0
نسخه 1.1.0-rc01
16 اکتبر 2024
androidx.wear:wear-remote-interactions:1.1.0-rc01
بدون تغییر از 1.1.0-beta01
منتشر شده است. نسخه 1.1.0-rc01 حاوی این commit ها است.
نسخه 1.1.0-beta01
24 جولای 2024
androidx.wear:wear-remote-interactions:1.1.0-beta01
منتشر شد. نسخه 1.1.0-beta01 حاوی این تعهدات است. نسخه 1.3.0-beta01 Wear Remote Interactions نشان میدهد که این نسخه از کتابخانه کامل شده است و API قفل شده است (به جز مواردی که به عنوان آزمایشی علامتگذاری شدهاند).
نسخه 1.1.0-alpha04
10 ژانویه 2024
androidx.wear:wear-phone-interactions:1.1.0-alpha04
منتشر شد. نسخه 1.1.0-alpha04 حاوی این commit ها است.
تغییرات API
- ما
RemoteAuthClient.isRemoteAuthAvailable
اضافه کرده ایم که بررسی می کند آیا احراز هویت از راه دور در دسترس است یا خیر. ( IBC10c )
نسخه 1.1.0-alpha02
10 ژانویه 2024
androidx.wear:wear-remote-interactions:1.1.0-alpha02
منتشر شد. نسخه 1.1.0-alpha02 حاوی این commit ها است.
تغییرات API
- ما
RemoteActivityHelper.isRemoteActivityHelperAvailable
را اضافه کردهایم که به بررسی اینکه آیا عملکرد راهاندازی یک فعالیت راه دور در دسترس است یا خیر کمک میکند. ( I107a9 ) - ما سازنده
RemoteActivityHelper
را برای داشتن پارامتر اختیاری سازگار با جاوا به روز کرده ایم. ( I75554 )
نسخه 1.1.0-alpha01
21 ژوئن 2023
androidx.wear:wear-remote-interactions:1.1.0-alpha01
منتشر شد. نسخه 1.1.0-alpha01 حاوی این commit ها است.
رفع اشکال
- بهبود نحوه تکمیل و مدیریت خطا در
RemoteActivityHelper
. ( I60d60 )
مشارکت خارجی
- وابستگی گواوا را از
wear-remote-interactions
حذف کنید و از جایگزین های کوچکتر استفاده کنید.
Wear-Phone-Interactions نسخه 1.1.0-alpha03
9 مارس 2022
androidx.wear:wear-phone-interactions:1.1.0-alpha03
منتشر شد. نسخه 1.1.0-alpha03 حاوی این commit ها است.
رفع اشکال
-
redirectUrl
ازOAuthRequest
اکنون اگر URL تغییر مسیر در URL درخواست داده شده تنظیم نشده باشد، یک رشته خالی برمی گرداند. ( I44242 )
Wear-Phone-Interactions نسخه 1.1.0-alpha02
15 دسامبر 2021
androidx.wear:wear-phone-interactions:1.1.0-alpha02
منتشر شد. نسخه 1.1.0-alpha02 حاوی این commit ها است.
رفع اشکال
- رفع خطاهای موجود در اسناد
RemoteAuthClient
، از جمله خطا در قطعه نمونه کد و پیوند مرده بهErrorCode
( I260e8 )
Wear-Phone-Interactions نسخه 1.1.0-alpha01
15 سپتامبر 2021
androidx.wear:wear-phone-interactions:1.1.0-alpha01
منتشر شد. نسخه 1.1.0-alpha01 حاوی این commit ها است.
تغییرات API
Wear Congoing & Interactions نسخه 1.0.0
Wear-Phone-Interactions نسخه 1.0.1
15 دسامبر 2021
androidx.wear:wear-phone-interactions:1.0.1
منتشر شد. نسخه 1.0.1 حاوی این commit ها است.
رفع اشکال
- هنگام تلاش برای غیرفعال کردن اعلانهای پل زدن بدون
excludedTags
، استثنا ثابت ازBridgingManager
پرتاب شد.
Wear-Phone-Interactions Wear-Remote-Interactions نسخه 1.0.0
15 سپتامبر 2021
androidx.wear:wear-phone-interactions:1.0.0
و androidx.wear:wear-remote-interactions:1.0.0
منتشر شدند. نسخه 1.0.0 حاوی این commit ها است.
ویژگی های اصلی 1.0.0
کتابخانه تعامل تلفن حاوی APIهایی برای تعامل از ابزارهای پوشیدنی به تلفنها است. این شامل موارد زیر است:
-
PhoneDeviceType
، روشهای کمکی را برای تعیین نوع تلفنی که ساعت کنونی با آن جفت میشود، ارائه میکند، فقط برای استفاده در دستگاههای پوشیدنی. - APIهای
BridgingManager
،BridgingManagerService
وBridgingConfig
برای فعال/غیرفعال کردن اعلانها در زمان اجرا و تنظیم تگهای اختیاری برای اعلانهایی که از حالت پل زدن معاف هستند. -
RemoteAuthClient
، پشتیبانی از احراز هویت از راه دور در Wearables همراه با پشتیبانی از افزودن برنامه افزودنی OAuth PKCE. کنترلرها و کلاس های کمکی اضافی برای ارتباط ارائه شده است.
کتابخانه تعامل از راه دور حاوی APIهایی برای تعامل بین ابزارهای پوشیدنی و تلفنها است. این شامل موارد زیر است:
-
WatchFaceConfigIntentHelper
، عملکردهای کمکی را برای تعیین شناسه و نام مؤلفه در فعالیتهای پیکربندی چهره ساعت برای همراه در تلفن ارائه میکند. - کلاس
RemoteActivityHelper
که می تواند برای باز کردن intent در دستگاه های دیگر (یعنی از ساعت به تلفن) استفاده شود.
Wear-Phone-Interactions Wear-Remote-Interactions نسخه 1.0.0-rc01
1 سپتامبر 2021
androidx.wear:wear-phone-interactions:1.0.0-rc01
و androidx.wear:wear-remote-interactions:1.0.0-rc01
منتشر شد. نسخه 1.0.0-rc01 حاوی این commit ها است.
رفع اشکال
- رفع اشکال جلوگیری از انتشار خطاهای ایجاد شده در سرویسهای Google Play به تماسگیرنده هنگام استفاده از RemoteActivityHelper ( I60d60 )
- رفع اشکالی که RemoteActivityHelper هرگز آینده خود را برآورده نمیکند، اگر گرههای متصلی وجود نداشته باشد، یا اگر nodeId درخواستی پیدا نشود ( I60d60 )
Wear-Ongoing نسخه 1.1
نسخه 1.1.0-alpha01
23 آگوست 2023
androidx.wear:wear-ongoing:1.1.0-alpha01
منتشر شد. نسخه 1.1.0-alpha01 حاوی این commit ها است.
تغییرات API
- فیلد توضیحات محتوا را به فعالیت در حال انجام اضافه کنید. این توسط سرویسهای دسترسپذیری برای توصیف فعالیت در حال انجام استفاده خواهد شد. ( I79fc6 )
رفع اشکال
-
@RequiresPermission
به APIهایی که نیاز به اعطای مجوزPOST_NOTIFICATIONS
در SDK 33 و بالاتر دارند اضافه شد. ( Ie542e , b/238790278 )
Wear-Ongoing نسخه 1.0.0
1 سپتامبر 2021
androidx.wear:wear-ongoing:1.0.0
منتشر شد. نسخه 1.0.0 حاوی این commit ها است.
ویژگی های اصلی 1.0.0
- Wear Congoing Activities API یک API برای توسعه دهندگان از جمله توسعه دهندگان شخص ثالث است که برای علامت گذاری فعالیت آنها به عنوان "فعالیت در حال انجام" و ارائه اطلاعات مورد نیاز استفاده می شود.
- فعالیتهای مداوم به فعالیتهایی اشاره دارد که میتوانند در پسزمینه ساعت اجرا شوند (مانند تمرین، تماس و رسانه). در Wear 3، فعالیتی که بهعنوان در حال انجام اعلام میشود، از طریق نماد پوشش اختصاصی روی صفحه ساعت و یک رندر متفاوت در راهانداز برنامه برجستهتر میشود.
- برای اطلاعات بیشتر، به راهنمای فعالیت مداوم پوشیدن مراجعه کنید
Wear-Phone-Interactions Wear-Remote-Interactions نسخه 1.0.0-beta01
18 آگوست 2021
androidx.wear:wear-phone-interactions:1.0.0-beta01
و androidx.wear:wear-remote-interactions:1.0.0-beta01
منتشر شد. نسخه 1.0.0-beta01 حاوی این تعهدات است.
تغییرات API
- کلاس
RemoteIntentHelper
بهRemoteActivityHelper
تغییر نام داد. توابعRemoteIntentHelper#getRemoteIntentExtraIntent
وRemoteIntentHelper#getRemoteIntentNodeId
به ترتیب بهRemoteActivityHelper#getTargetIntent
وRemoteActivityHelper#getTargetNodeId
تغییر نام دادند. ( ID2042 )
Wear-Ongoing نسخه 1.0.0-rc01
18 آگوست 2021
androidx.wear:wear-ongoing:1.0.0-rc01
بدون تغییر از 1.0.0-beta01
منتشر شده است. نسخه 1.0.0-rc01 حاوی این commit ها است.
Wear-Ongoing نسخه 1.0.0-beta01
4 آگوست 2021
androidx.wear:wear-ongoing:1.0.0-beta01
منتشر شد. نسخه 1.0.0-beta01 حاوی این تعهدات است.
تغییرات API
- برخی از تنظیمکنندهها در OngoingActivity.Builder اکنون یک آرگومان تهی را میپذیرند تا به تنظیمکنندهها و دریافتکنندهها تقارن و سازگاری بدهند ( I17ee5 )
Wear-Phone-Interactions نسخه 1.0.0-alpha07
4 آگوست 2021
androidx.wear:wear-phone-interactions:1.0.0-alpha07
منتشر شد. نسخه 1.0.0-alpha07 حاوی این commit ها است.
تغییرات API
-
WearTypeHelper.isChinaDevice
بهWearTypeHelper.isChinaBuild
تغییر نام داد. ( I47302 ) - کتابخانه RemoteAuthClient را برای انتخاب خودکار redirect_uri بر اساس نوع دستگاه (RoW/China) بهروزرسانی کردهایم. ( I38866 )
- رفع اشکالی که باعث شد تبدیل BridgingConfig به/از Bundle با ClassCastException با شکست مواجه شود. تست های واحد برای کلاس BridgeManagerService اضافه شد. ( I68ecb )
Wear-Remote-Interactions نسخه 1.0.0-alpha06
4 آگوست 2021
androidx.wear:wear-remote-interactions:1.0.0-alpha06
منتشر شد. نسخه 1.0.0-alpha06 حاوی این commit ها است.
Wear-Phone-Interactions نسخه 1.0.0-alpha06
21 جولای 2021
androidx.wear:wear-phone-interactions:1.0.0-alpha06
منتشر شد. نسخه 1.0.0-alpha06 حاوی این commit ها است.
تغییرات API
- کلاس
BridgingManagerSeviceBinder
اکنون یک زیر کلاس سرویس است و به BridgingManagerSevice تغییر نام داده است. ( I9fca2 ) - روش
RemoteAuthClient.Callback.onAuthorizationError
برای شامل پارامتر OAuthRequest تغییر کرده است. روشهایی که اکنون به پاسخ به تماس نیاز دارند نیز به یک مجری برای اجرای تماس مجدد نیاز دارند. ( I35e11 )
رفع اشکال
- ما API احراز هویت را با پارامترهای مستندتر و با استفاده از خصوصیات در صورت امکان واضح تر کرده ایم. ( I12287 )
Wear-Phone-Interactions نسخه 1.0.0-alpha05
30 ژوئن 2021
androidx.wear:wear-phone-interactions:1.0.0-alpha05
منتشر شد. نسخه 1.0.0-alpha05 حاوی این commit ها است.
رفع اشکال
- پارامترهای مستندی که باید در سازنده برای
BridgingConfig.Builder
ارسال شوند.
Wear-Ongoing نسخه 1.0.0-alpha06
2 ژوئن 2021
androidx.wear:wear-ongoing:1.0.0-alpha06
منتشر شد. نسخه 1.0.0-alpha06 حاوی این commit ها است.
تغییرات API
- فیلد عنوان را به فعالیت در حال انجام اضافه کنید. ( I7a405 )
رفع اشکال
-
SerializationHelper.copy()
اکنون یک کپی دفاعی از اطلاعات انجام می دهد ( I8b276 ) - اسناد بهبود یافته setCategory ( Iff01f )
Wear-Ongoing نسخه 1.0.0-alpha05
18 مه 2021
androidx.wear:wear-ongoing:1.0.0-alpha05
منتشر شد. نسخه 1.0.0-alpha05 حاوی این commit ها است.
تغییرات API
OngoingActivity
اکنون دریافتکنندههایی برای بازیابی همه مقادیر تنظیمشده مستقیماً از طریق سازنده (یا پیشفرضهای گرفتهشده از Notification مربوطه) دارد. ( ID8ac8 )- کلاس جدید
Status
اکنون برای ایجاد وضعیتOngoingActivity
استفاده می شود -
OngoingActivityData
وOngoingActivityStatus
دیگر بخشی از API عمومی نیستند.
- کلاس جدید
کلاس های
TextStatusPart
وTimerStatusPart
دیگر بخشی از API عمومی نیستند. ( I57fb6 )- برای ایجاد یک
Part
با متن ایستا، ازStatus.TextPart
استفاده کنید. - برای ایجاد یک
Part
با کرونومتر (شمارش رو به بالا)، ازStatus.Stopwatch
استفاده کنید - برای ایجاد یک
Part
با تایمر (شمارش معکوس)، ازStatus.Timer
استفاده کنید
- برای ایجاد یک
Wear-Ongoing نسخه 1.0.0-alpha04
5 مه 2021
androidx.wear:wear-ongoing:1.0.0-alpha04
منتشر شد. نسخه 1.0.0-alpha04 حاوی این commit ها است.
تغییرات API
- در OngoingActivity، روش های ExistingOngoingActivity اکنون recoverOngoingActivity نامیده می شوند.
- OngoingActivity اکنون مجموعه کاملی از گیرندهها دارد که قبلاً فقط در OngoingActivityData موجود بود. ( I0ee4d )
Wear-Remote-Interactions نسخه 1.0.0-alpha05
21 جولای 2021
androidx.wear:wear-remote-interactions:1.0.0-alpha05
منتشر شد. نسخه 1.0.0-alpha05 حاوی این commit ها است.
تغییرات API
ما کلاس
RemoteIntentHelper
(قبلاً RemoteIntent در کتابخانه پشتیبانی Wearable) را اضافه کردهایم که میتواند برای باز کردن intent در دستگاههای دیگر (یعنی از ساعت به تلفن) استفاده شود. ( I1d7e0 )کلاس PlayStoreAvailability از کتابخانه AndroidX حذف شده است. برای تشخیص اینکه آیا Play Store در تلفن متصل موجود است یا خیر، از روش
androidx.phone.interactions.PhoneTypeHelper.getPhoneDeviceType
استفاده کنید تا مشخص کنید تلفن متصل یک تلفن Android است یا خیر. سپس از روشandroidx.wear.utils.WearTypeHelper.isChinaDevice
برای تعیین اینکه آیا تلفن متصل یک دستگاه چینی است استفاده کنید. اگر گوشی اندرویدی باشد و اگر چینی نباشد، پلی استور در دسترس خواهد بود. ( Ie7dec )
Wear-Phone-Interactions نسخه 1.0.0-alpha04
7 آوریل 2021
androidx.wear:wear-phone-interactions:1.0.0-alpha04
منتشر شد. نسخه 1.0.0-alpha04 حاوی این commit ها است.
تغییرات API
- ثابتهای
ErrorCode
بهروزرسانی کرد تا کتابخانه جدید با پیادهسازی در کتابخانه پشتیبانی پوشیدنی سازگار باشد.
رفع اشکال
- رفع استثنا ناشی از OAuth API جدید هنگام شروع جلسه OAuth.
Wear-Remote-Interactions نسخه 1.0.0-alpha03
7 آوریل 2021
androidx.wear:wear-remote-interactions:1.0.0-alpha03
منتشر شد. نسخه 1.0.0-alpha03 حاوی این commit ها است.
تغییرات API
-
PlayStoreAvailability
تغییر داد تا کلاسی باشد که شامل شیء همراه با متدهای ثابت باشد. استفاده ثابت می ماند.
رفع اشکال
- سند خلاصه برای
WatchFaceConfigIntentHelper
برای نمایش صحیح کد نمونه با کاراکترهای واقعی HTML ثابت شد.
Wear-Ongoing Wear-Phone-Interactions نسخه 1.0.0-alpha03
10 مارس 2021
androidx.wear:wear-ongoing:1.0.0-alpha03
و androidx.wear:wear-phone-interactions:1.0.0-alpha03
منتشر شد. نسخه 1.0.0-alpha03 حاوی این commit ها است.
ویژگی های جدید
- OAuthClient را از کتابخانه پشتیبانی Wearable به AndroidX منتقل کنید. این کلاس منتقل شده به RemoteAuthClient تغییر نام داده است و از احراز هویت از راه دور در Wearables همراه با پشتیبانی از افزودن پسوند OAuth PKCE پشتیبانی می کند. کنترلرها و کلاس های کمکی اضافی برای ارتباط ارائه شده است.
- اکنون می توان با استفاده از سازنده OngoingActivity.Builder جدید، فعالیت های در حال انجام را با یک اعلان که دارای یک برچسب است مرتبط کرد.
تغییرات API
- پشتیبانی از برچسبهای اعلان در کتابخانه فعالیتهای جاری ( I653b4 ) اضافه شد
- OAuthClient را از کتابخانه Wear Support به AndroidX منتقل کنید و از برنامه افزودنی OAuth PKCE پشتیبانی اضافه کنید ( I3eaaa )
Wear-Remote-Interactions نسخه 1.0.0-alpha02
10 مارس 2021
androidx.wear:wear-remote-interactions:1.0.0-alpha02
منتشر شد. نسخه 1.0.0-alpha02 حاوی این commit ها است.
ویژگی های جدید
- انتقال کلاس PlayStoreAvailability از کتابخانه پشتیبانی Wearable به AndroidX که یک API برای بررسی اینکه آیا فروشگاه Play در تلفن موجود است یا خیر ارائه میکند.
رفع اشکال
- انتقال کلاس PlayStoreAvailability از کتابخانه پشتیبانی Wearable به AndroidX. ( I69bfe )
نسخه 1.0.0-alpha02
10 فوریه 2021
androidx.wear:wear-ongoing:1.0.0-alpha02
و androidx.wear:wear-phone-interactions:1.0.0-alpha02
منتشر شد. نسخه 1.0.0-alpha02 حاوی این commit ها است.
تغییرات API
- پشتیبانی برای وضعیت پیچیده تر اضافه شده است. آنها از یک الگو (یا چندین) و مجموعه ای از قطعات تشکیل شده اند که برای پر کردن مکان های نگهدارنده الگو استفاده می شود. OngoingActivityStatus اکنون یک روش ثابت برای ایجاد وضعیت های ساده تنها با یک قسمت (یک متن یا یک تایمر) و یک سازنده برای ایجاد وضعیت های پیچیده تر دارد. ( I1fe81 )
- کلاسهای BridgingManager و BridgingConfig را از Wear Support Library به AndroidX منتقل کنید که APIهایی را برای فعال/غیرفعال کردن اعلانها در زمان اجرا ارائه میدهد و به صورت اختیاری برچسبهایی را برای اعلانهایی که از حالت پل زدن معاف هستند، تنظیم میکند. ( I3a17e )
نسخه 1.0.0-alpha01
27 ژانویه 2021
androidx.wear:wear-ongoing:1.0.0-alpha01
، androidx.wear:wear-phone-interactions:1.0.0-alpha01
و androidx.wear:wear-remote-interactions:1.0.0-alpha01
منتشر شدند. نسخه 1.0.0-alpha01 حاوی این commit ها است.
تغییرات API
کتابخانه فعالیتهای در حال انجام را به یک کتابخانه فرعی جدید منتقل کنید: پوشیدن مداوم. کلاسها اکنون در بسته androidx.wear.ongoing (قبلا androidx.wear.ongoingactivities بود) زندگی میکنند ( I7c029 )
یک کتابخانه پشتیبانی جدید ایجاد کنید تا شامل کلاس هایی باشد که از تعاملات Wearables به Phones پشتیبانی می کند. در ابتدا پر از کلاسهایی است که از کتابخانه پشتیبانی پوشیدنی مهاجرت کردهاند. ( ID5180 )
کلاس PhoneDeviceType را از کتابخانه پشتیبانی Wearable به AndroidX منتقل کنید. کلاس منتقل شده به PhoneTypeHelper تغییر نام داده است که روشهای کمکی را برای تعیین نوع تلفنی که ساعت فعلی با آن جفت شده است، برای استفاده در دستگاههای پوشیدنی ارائه میکند. ( Ibd947 )
یک کتابخانه پشتیبانی جدید ایجاد کنید تا شامل کلاسهایی باشد که از تعاملات بین ابزارهای پوشیدنی و تلفنها پشتیبانی میکنند. در ابتدا پر از کلاسهایی است که از کتابخانه پشتیبانی پوشیدنی مهاجرت کردهاند. ( I9deb4 )
کلاس WatchFaceCompanion را از کتابخانه پشتیبانی Wearable به AndroidX منتقل کنید. کلاس منتقل شده به WatchFaceConfigIntentHelper تغییر نام داده است که توابع کمکی را برای تعیین شناسه و نام مؤلفه در فعالیتهای پیکربندی چهره ساعت به صورت همراه در تلفن ارائه میکند، همچنین میتواند به صورت محلی برای پیکربندی صفحه ساعت در دستگاه پوشیدنی استفاده شود. ( Ia455f )
عوارض پوشیدن و Watchface 1.0.0
نسخه 1.0.0-alpha22
15 سپتامبر 2021
androidx.wear:wear-*:1.0.0-alpha22
منتشر شد. نسخه 1.0.0-alpha22 حاوی این commit ها است.
ویژگی های جدید
- EditorSession اکنون در ناظران چرخه حیات مشترک شده است، بنابراین دیگر لازم نیست وقتی فعالیت شما از بین رفت، آن را به صراحت ببندید.
تغییرات API
- EditorSession و ListenableEditorSession اکنون از kotlin StateFlows برای complicationSlotsState، ComplicationsPreviewData و ComplicationsDataSourceInfo استفاده می کنند. ( I761d9 )
- EditorSession#userStyle اکنون یک
MutableStateFlow<UserStyle>
است ( I32ca9 ) - EditorSession.createOnWatchEditorSession اکنون از یک ناظر چرخه حیات استفاده می کند و با مشاهده onDestroy به طور خودکار بسته می شود. علاوه بر این
createOnWatchEditorSession
اکنون فقط نیاز به ارسال فعالیت دارد. تغییرات یکسانی نیز در ListenableEditorSession اعمال شده است. ( IC6b7f ) - سازنده CustomValueUserStyleSetting به عنوان بخشی از API عمومی بازیابی شده است. ( I2e69a )
-
UserStyle
اکنون ازMap<UserStyleSetting, UserStyleSetting.Option>
وMutableUserStyleSetting#put
ارث می برد اگر تنظیم در طرحواره نباشد یا گزینه مطابق با تنظیمات نباشد. ( Iba40f )
نسخه 1.0.0-alpha21
1 سپتامبر 2021
androidx.wear:wear-*:1.0.0-alpha21
منتشر شد. نسخه 1.0.0-alpha21 حاوی این commit ها است.
تغییرات API
- همه واچ فیس عمومی، کلاینت، ویرایشگر و APIهای پیچیده اکنون از java.time.Instant به جای Long استفاده می کنند، در نتیجه حداقل سطح API به 26 افزایش یافته است. ( I3cd48 )
- واچ فیس و APIهای پیچیده اکنون به جای تقویم از ZonedDateTime غیرقابل تغییر استفاده می کنند. ( I25cf8 )
- ComplicationSlot ها اکنون با NoDataComplicationData مقداردهی اولیه می شوند، ComplicationSlot.complicationData اکنون همیشه یک مقدار دارد و CanvasComplicationDrawable.complicationData دیگر قابل تهی نیست. ( I4dfd6 ) این کار باعث کاهش (اما از بین نمی برد) سوسو زدن عارضه هنگام جابجایی بین صفحه های ساعت می شود.
نسخه 1.0.0-alpha20
18 آگوست 2021
androidx.wear:wear-*:1.0.0-alpha20
منتشر شد. نسخه 1.0.0-alpha20 حاوی این commit ها است.
تغییرات API
- ما createFallbackPreviewData را به ComplicationDataSourceInfo اضافه کردهایم که میتواند زمانی که ComplicationDataSourceInfoRetriever.retrievePreviewComplicationData null برمیگرداند استفاده شود. ( I38c4d )
- ComplicationDataSourceUpdateRequester به یک رابط تبدیل شده است تا امکان تمسخر در تست های واحد را فراهم کند. می توانید با ComplicationDataSourceUpdateRequester.create یک ComplicationDataSourceUpdateRequester بتن بسازید. ( I7da22 )
- RenderParameters.pressedComplicationSlotIds با RenderParameters.lastComplicationTapDownEvents جایگزین شده است که کلاس TapEvent جدید را نشان می دهد که شامل سه مختصات x، y از ضربه در پیکسل و یک مهر زمانی است.
WatchFace.TapListener.onTap
باonTapEvent(@TapType tapType: Int, tapEvent: TapEvent)
جایگزین شده است. علاوه بر این،InteractiveWatchFaceClient.displayPressedAnimation
حذف شده است. ( ID87d2 ) - حاشیه نویسی صریح رشته برای setImportantForAccessibility ( I990fa ) اضافه شد
- ComplicationSlotBoundsType به androidx-wear-watchface منتقل شده است.ComplicationSlotBoundsType in wear/wear-watchface. ( I09420 )
- ما برای ارسال شناسه های منبع رشته به UserStyleSetting و Options پشتیبانی اضافه کرده ایم. اکنون این روش پیشنهادی برای ساخت آن اشیا است. ( I03d5f )
- محدودیتهایی برای حداکثر اندازه سیم یک طرحواره سبک کاربر اعمال شده است. همچنین نمادهای موجود در طرح نباید بزرگتر از 400x400 پیکسل باشند. ( I3b65b )
- ما یک کلاس MutableUserStyle برای پشتیبانی از تغییرات در نمونه های UserStyle اضافه کردیم ( I95a40 )
- ما
ListenableWatchFaceMetadataClient.Companion#listenableCreateWatchFaceMetadataClient
را بهListenableWatchFaceMetadataClient.Companion#createListenableWatchFaceMetadataClient
تغییر نام دادیم. ( I64ce2 ) - ما EditorState.previewComplicationsData را طوری تغییر دادهایم که فقط شامل دادههایی برای عوارض فعال شده باشد، و
EditorSession.DEFAULT_PREVIEW_TIME_MILLIS
اضافه کردهایم که اگر بهrenderWatchFaceToBitmap
یاPreviewScreenshotParams
ارسال شود، درخواست ارائه با زمان پیشنمایش پیشفرض چهره ساعت را میدهد. ( If7b3c ) - سازندههای UserStyleSetting که CharSequence را میگیرند را از API عمومی حذف کردهایم. توصیه می شود به جای آن از سازنده هایی استفاده کنید که به شناسه های StringResource نیاز دارند. ( I8537b )
-
CurrentUserStyleRepository.UserStyleChangeListener
اکنون از تبدیل SAM پشتیبانی می کند. ( I85989 )
نسخه 1.0.0-alpha19
4 آگوست 2021
androidx.wear:wear-*:1.0.0-alpha19
منتشر شد. نسخه 1.0.0-alpha19 حاوی این commit ها است.
تغییرات API
- ما
ListenableWatchFaceMetadataClient.listenableCreateWatchFaceMetadataClient
را اضافه کرده ایم که یک پوششListenableFuture
برایWatchFaceMetadataClient.createWatchFaceMetadataClient
ارائه می دهد. ( I5fa37 ) -
UserStyleOption.getOptionForId
اکنون به جای آرایه بایت،UserStyleOption.Id
می پذیرد. ( I469be ) - ثابت های
BooleanOption.TRUE
وBooleanOption.FALSE
را ارائه دهید و ایجاد نمونه را مجاز نکنید ( I46e09 ) - روشهایی در wear-watchface-client که میتوانند RemoteException را پرتاب کنند، اکنون بر این اساس حاشیهنویسی شدهاند. ( IB8438 )
- برای ثبات
EditorSession.createOnWatchEditingSession
بهcreateOnWatchEditorSession
تغییر نام دادیم، به طور مشابهcreateHeadlessEditingSession
اکنونcreateHeadlessEditorSession
است. لفاف های گواوا آنها نیز تغییر نام یافته است. ( I1526b ) -
EditorSession
اکنون یک رابط است وListenableEditorSession.commitChangesOnClose
اکنون به درستی واگذار شده است. ( I7dc3e ) - اکنون هر طرح سبک کاربری که تنظیمات یا گزینه هایی با شناسه های متضاد داشته باشد را رد می کنیم ( Ic2715 )
- ما یک
UserStyle.get
اضافه بار اضافه کرده ایم کهUserStyleSetting.Id
می پذیرد. ( I2aa0f )
نسخه 1.0.0-alpha18
21 جولای 2021
androidx.wear:wear-*:1.0.0-alpha18
منتشر شد. نسخه 1.0.0-alpha18 حاوی این commit ها است.
تغییرات API
-
ComplicationHelperActivity
به کتابخانهandroidx.wear:wear-watchface
منتقل کردیم. ( I39e76 ) - برای یکپارچگی و وضوح،
ComplicationProvider
بهComplicationDataSource
تغییر نام داده است و همه کلاسهایی که Provider به نام خود دارند، به طور مشابه تغییر نام دادهاند. ( Iaef0b ) -
CanvasComplication.isHighlighted
بهRenderParameters.pressedComplicationSlotIds
منتقل شدهCanvasComplication
. برای پشتیبانی از این تغییرCanvasComplication.render
اکنونslotId
نیز به عنوان پارامتر می گیرد و اکنونComplicationSlot
را بهGlesTextureComplication
می دهیم. ( I50e6e ) - ما
headlessDeviceConfig
بهEditorRequest
اضافه کردهایم، اگر تهی نباشد، این پارامتر برای ساختن یک نمونه headless برای پشتیبان EditorSession به جای عمل کردن بر روی نمونه تعاملی استفاده میشود. این اجازه می دهد تا ویرایشگر برای صفحه ساعتی که فعلی نیست فراخوانی شود. ( I0a820 ) - ما یک
WatchFaceMetadataClient
آزمایشی اضافه کردهایم که امکان بازیابی کارآمد ابردادههای استاتیک چهره ساعت مانندUserStyleSchema
و جزئیات ثابت دربارهComplicationSlots
را فراهم میکند. ( I6bfdf ) - ما
CanvasRenderer.uiThreadInit
به init تغییر نام دادیم. ( I6fff9 ) - ما PreviewScreenshotParams را یک پارامتر جدید اختیاری برای EditorRequest اضافه کردهایم که به EditorSession دستور میدهد تا یک اسکرین شات پیشنمایش در commit با این پارامتر بگیرد. تصویر پیشنمایش در
EditorState.previewImage
نمایش داده میشود. ( IC2c16 )
رفع اشکال
- توسعه دهندگان دیگر نیازی به اضافه کردن ComplicationHelperActivity به مانیفست خود ندارند. ( I6f0c2 )
نسخه 1.0.0-alpha17
30 ژوئن 2021
androidx.wear:wear-*:1.0.0-alpha17
منتشر شد. نسخه 1.0.0-alpha17 حاوی این commit ها است.
ویژگی های جدید
در
GlesRenderer
،makeUiThreadContextCurrent
وmakeBackgroundThreadContextCurrent
باrunUiThreadGlCommands
وrunBackgroundThreadGlCommands
جایگزین شده اند که هر دو یکRunnable
می پذیرند. کتابخانه تضمین می کند که تنها یک دستور GL قابل اجرا در هر زمان معین اجرا می شود.برای سادهتر کردن اولیه UiThread،
CanvasRenderer.uiThreadInit
اضافه کردهایم که قبل از هر تماسی برای رندر، یک بار در UiThread فراخوانی میشود. ما همچنینonRendererCreated
بهCanvasComplication
اضافه کردهایم که اشتراکگذاری حالت را برایRenderer
وCanvasComplication
آسانتر میکند.برای وضوح، نام
Complication
بهComplicationSlot
وcomplicationId
بهcomplicationSlotId
یاcomplicationInstanceId
بسته به استفاده تغییر دادهایم.
تغییرات API
- برای وضوح، ما
Complication
بهComplicationSlot
وcomplicationId
بهcomplicationSlotId
یاcomplicationInstanceId
تغییر نام دادهایم. کلاس هایی که از Complication استفاده می کنند به طور مشابه تغییر نام داده اند، به عنوان مثال ComplicationsManager اکنون ComplicationSlotsManager نامیده می شود. ( I4da44 ) - در GlesRenderer
makeUiThreadContextCurrent
وmakeBackgroundThreadContextCurrent
باrunUiThreadGlCommands
وrunBackgroundThreadGlCommands
جایگزین شده اند که هر دو یکRunnable
می پذیرند. این توابع تنها زمانی مورد نیاز هستند که نیاز به برقراری تماسهای GL خارج از رندر،runBackgroundThreadGlCommands
وonUiThreadGlSurfaceCreated
داشته باشید. این مورد نیاز است زیرا میتواند چندین GlesRenderer وجود داشته باشد که هر کدام با زمینههای خاص خود در یک فرآیند، به طور بالقوه از صفحههای ساعت متفاوت وجود داشته باشند. علاوه بر این، دسترسی به زمینه مشترک فعلی GL اکنون همگام شده است. ( I04d59 ) - ما
CanvasRenderer.uiThreadInit
اضافه کرده ایم که قبل از هر تماسی برای رندر، یک بار در UiThread فراخوانی می شود. همچنین برای وضوح در GlesRenderer نامonGlContextCreated
بهonBackgroundThreadGlContextCreated
وonGlSurfaceCreated
را بهonUiThreadGlSurfaceCreated
تغییر نام دادیم. ( If86d0 ) -
HeadlessWatchFaceClient
&InteractiveWatchFaceClient
getComplicationsSlotState
بهgetComplicationSlotsState
تغییر نام داده است. درComplicationSlot
:createRoundRectComplicationBuilder
،createBackgroundComplicationBuilder
، وcreateEdgeComplicationBuilder
به ترتیب بهcreateRoundRectComplicationSlotBuilder
،createBackgroundComplicationSlotBuilder
، وcreateEdgeComplicationSlotBuilder
تغییر نام داده اند. ( Ib9adc ) - ما onRendererCreated را به CanvasComplication اضافه کردهایم که اشتراکگذاری حالت را برای Renderer و CanvasComplication آسانتر میکند. ( I5e1ac )
نسخه 1.0.0-alpha16
16 ژوئن 2021
androidx.wear:wear-*:1.0.0-alpha16
منتشر شد. نسخه 1.0.0-alpha16 حاوی این commit ها است.
ویژگی های جدید
- ما تعدادی از باگهای مربوط به تغییرات اخیر مدل رشتهبندی و همچنین رسیدگی به سایر مشکلات را با ویرایشگر صفحه ساعت برطرف کردهایم.
رفع اشکال
- جلوگیری از NPE در
onComplicationProviderChooserResult
( b/189594557 ) - رفع مشکلات سطوح کهنه و drawBlack ( b/189452267 )
- اصلاح نژاد در دسترسی به
complicationsManager.watchState
( b/189457893 ) - رفع اشکال طول عمر رشته پس زمینه ( b/189445428 )
- رفع مشکلات Pre-R Watch face Editor ( b/189126313 )
- پارامترهای بوت مستقیم را برای تغییرات سبک ویرایشگر به روز نکنید ( b/187177307 )
نسخه 1.0.0-alpha15
2 ژوئن 2021
androidx.wear:wear-*:1.0.0-alpha15
منتشر شد. نسخه 1.0.0-alpha15 حاوی این commit ها است.
ویژگی های جدید
اکثریت مقداردهی اولیه واچ فیس اکنون بر روی یک رشته پس زمینه انجام می شود، اما پس از بارگذاری، تمام رندرهای چهره ساعت و غیره در UiThread انجام می شود. یک مانع حافظه بین بارگذاری و رندر وجود دارد، بنابراین اکثر واچ فیس های کاربر نیازی به انجام کار خاصی ندارند. چهرههای ساعتی که از GLES استفاده میکنند ممکن است یک استثنا باشد، زیرا زمینه خاص رشته است و ما دو زمینه مرتبط ایجاد میکنیم، بنابراین میتوان منابع GL (مانند بافتها و سایهزنها) را در رشته پسزمینه آپلود کرد و از آنها در UiThread استفاده کرد.
ما ساخت واچفیسها را به سه عملکرد تقسیم کردهایم: createUserStyleSchema، createComplicationsManager و createWatchFace. ما فرض میکنیم که createUserStyleSchema و createComplicationsManager سریع هستند و createWatchFace ممکن است مدتی طول بکشد تا داراییها بارگیری شوند. با استفاده از این مزیت، WatchFaceControlClient.getDefaultProviderPoliciesAndType
را معرفی کردهایم که نقشهای از شناسههای پیچیدگی را به DefaultComplicationProviderPolicies و ComplicationType پیشفرض برمیگرداند. این سریعتر از ایجاد یک نمونه بدون هد است زیرا برای انجام پرس و جو نیازی به مقداردهی اولیه کامل صفحه ساعت ندارد.
در نهایت عوارض اکنون با CanvasComplicationFactory ساخته می شوند که امکان ساخت تنبل رندرهای CanvasComplication را فراهم می کند.
تغییرات API
-
@TargetApi
با@RequiresApi
جایگزین شد. ( I0184a , b/187447093 , b/187447094 ) - ما
WatchFaceControlClient.getDefaultProviderPoliciesAndType
را معرفی کردهایم که نقشهای از شناسههای پیچیدگی را به DefaultComplicationProviderPolicies و ComplicationType پیشفرض برمیگرداند. در صورت امکان از یک مسیر سریع استفاده می شود که از ساخت کامل صفحه ساعت جلوگیری می کند. برای تسهیل این امر، WatchFaceService API مجبور شده است با دو روش جدید تغییر کند: createUserStyleSchema و createComplicationsManager که نتایج آن به createWatchFace منتقل میشود. علاوه بر این، Complications در حال حاضر با CanvasComplicationFactory ساخته شده است که امکان ساخت تنبل رندرهای CanvasComplication را فراهم می کند. ( Iad6c1 ) - ما MOST_RECENT_APP را از SystemProviders حذف کردیم. ( I3df00 )
- ObservableWatchData اکنون یک کلاس مهر و موم شده است. ( IC940d )
- CanvascomplicationFactory.Create (که به طور معمول IO محدود است) اکنون قبل از شروع کار با موضوع UI ، به یک موضوع پس زمینه برای هر عارضه فراخوانده می شود. یک مانع حافظه بین ساخت و ساز و رندر وجود دارد ، بنابراین به ابتدای نخ مخصوصی نیاز نیست. ( ia18f2 )
- اکنون Watchface Construction روی یک موضوع پس زمینه انجام شده است اگرچه تمام ارائه ها در موضوع UI انجام می شود ، Glesrenderer برای پشتیبانی از این از دو زمینه مرتبط پشتیبانی می کند. WatchFaceControlClient.CreateHeadlessWatchFaceClient و WatchFaceControlClient.GetOrCreateInteractiveWatchFaceclient ممکن است قبل از WatchFaceservice.CreateeWatchface حل شود. تماس های بعدی API تا زمان تکمیل اولیه سازی Watchface مسدود می شود. ( id9f41 )
- Expansion_dp و Stroke_Width_DP دیگر در API.TXT قابل مشاهده نیست. ( i54801 )
- ما در صورت بروز خطایی به جای ارسال یک جلسه تهی ، ویرایشگر را انجام داده ایم. علاوه بر این ، ارزش بازده EditorRequest.CreateFromintent و editorSession.CreateOnWatchEdingsession اکنون غیرقانونی است. ( i41eb4 )
نسخه 1.0.0-alpha14
18 مه 2021
androidx.wear:wear-*:1.0.0-alpha14
منتشر می شود. نسخه 1.0.0-alpha14 شامل این تعهدات است.
ویژگی های جدید
-
EditorSession.openComplicationProviderChooser
اکنون ChosenComplicationProvider را برمی گرداند که حاوی شناسه عارضه ،ComplicationProviderInfo
و یک بسته نرم افزاری است که حاوی سایر موارد اضافی است که توسط ارائه دهنده انتخاب کننده بازگردانده می شود. - علاوه بر این ، ما به طور پیوسته کد را به کوتلین مهاجرت کرده ایم و اکنون اکثریت API چهره ساعت در کوتلین تعریف شده است.
تغییرات API
- ویژگی های GLESRENDERER
eglContext
وeglDisplay
اکنون غیر قابل تهی هستند. هر خطای GL اکنون از طریقGlesRenderer.GlesException
به جای از طریق RuntimeException گزارش شده است. ( IB1005 ) - ما به
androidx.wear.watchface.complications.rendering.ComplicationDrawable
از جاوا به Kotlin ( IBC3EB ) مهاجرت کرده ایم. - ما به
androidx.wear.watchface.complications.rendering.ComplicationStyle
از جاوا به کوتلین مهاجرت کرده ایم ( I3375E ) - ما اطلاعاتی در مورد ارائه دهنده عوارض برای هر عارضه در ویرایشگر اضافه کردیم. ( i37f14 )
- ما نتیجه
EditorSession.openComplicationProviderChooser
را گسترش دادیم. ( iead6d )
عوارض و Watchface نسخه 1.0.0-alpha13 را بپوشید
5 مه 2021
androidx.wear:wear-*:1.0.0-alpha13
منتشر می شود. نسخه 1.0.0-alpha13 شامل این تعهدات است.
ویژگی های جدید
چهره های تماشای می توانند عناصر بصری مهمی فراتر از نشان دادن زمان و عوارض داشته باشند. برای ارائه پشتیبانی از خواننده صفحه نمایش برای این کار ، WatchFace اکنون می تواند محتوای دسترسی را از طریق خاصیت اضافی ContentDescriptionLabels ارائه دهد. علاوه بر این ، برای کنترل ترتیب ContentDescriptionLabels در دسترس بودن TraversalIndex به عوارض اضافه شده است. این می تواند با استفاده از عوارض بخشنده اصلاح شود.
برای ترغیب توسعه دهندگان برای در نظر گرفتن دقیق خوانندگان صفحه نمایش ، ما
ShortTextComplicationData.Builder
را ساخته ایم ،LongTextComplicationData.Builder
وRangedValueComplicationData.Builder
.contentDescription
Field باید به سازندگان خود منتقل شود. اگرComplicationText.EMPTY
برایcontentDescription
منتقل شود ، یکcontentDescription
به طور خودکار از متن و عنوان تولید می شود.WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient
اکنونServiceStartFailureException
پرتاب می کند اگر Watchface یک استثنا را در حین INIT پرتاب کند ، این امر تشخیص مشکلات را در هنگام راه اندازی Face Watch بسیار ساده تر می کند.
تغییرات API
- ما از داشتن یک نام مؤلفه تهی در SccomicationProviderInfo ، که برای پشتیبانی از نسخه های قدیمی تر سیستم عامل Wear لازم است ، پشتیبانی کردیم. ( i744d2 )
- ما
androidx.wear.complications.SystemProviders
از جاوا به کوتلین مهاجرت کرده ایم. ( ia1f8b ) - ما تمام کلاس ها را از API عمومی که در Android.support.wearable.complications قرار دارند پنهان کرده ایم و در صورت لزوم بسته بندی های مربوطه را در Androidx ایجاد کرده ایم. ( I7BD50 )
- ما در
TimeDifferenceComplicationText.Builder
ازsetMinimumUnit
بهsetMinimalTimeUnit
تغییر نام دادیم. ( i20C64 ) - ما
ShortTextComplicationData.Builder
را ساخته ایم ،LongTextComplicationData.Builder
وRangedValueComplicationData.Builder
contentDescription
Field Asseration باید در سازنده منتقل شود. ( i8cb69 ) - ما به AccricationProviderService.OnComplicationUpdate به onComplicationRequest و پارامتر محصور شده و پارامتر این روش به Data SccomicationRequest تغییر نام داده ایم. شنونده مربوطه به AccricationRequestListener و روش آن تغییر یافته است. ( IAF146 )
- ما روش
isActiveAt
ازComplicationData
حذف کرده ایم و به جای آن ،validTimeRange
در معرض قرار گرفته است. این تماس روش را می توان باvalidTimeRange.contains
جایگزین کرد. ( i65936 ) - ما توضیحات مربوط به روش عارضه را ارائه داده ایم. ( idb5ff )
- ProviderUpDateRequester از جاوا به کلتین مهاجرت کرده است. ( IBCE13 )
- GLESRENDER.MAKECONTEXTCURRENT اکنون عمومی است. کد تماشای چهره ممکن است نیاز به برقراری تماس های GL در خارج از Render و OnglContextCreated داشته باشد و به دلیل اینکه ممکن است یک زمینه تعاملی و بی سر و صدا وجود داشته باشد ، لازم است تا این موضوع را فراخوانی کند. ( i8a43c )
- WatchFaceControlClient.GetOrCreateInteractiveWatchFaceClient اکنون اگر Watchface در هنگام INIT پرتاب شود ، ServiceStartFailureException را پرتاب می کند. علاوه بر این ، WatchFaceservice در صورتی که CreateWatchFace بیش از 6 ثانیه طول بکشد ، استثنائی را به وجود می آورد. ( i59b2f )
- ما خاصیت شناسه استفاده نشده از
GlesTextureComplication
را حذف کرده ایم. ( I28958 ) - Watchface هم اکنون می تواند محتوای دسترسی را از طریق خاصیت اضافی ContContentDescriptionLabels
Renderer
مشخص کند. علاوه بر کنترل سفارش ContentDescriptionLabels در دسترس بودن TraversalIndex به عوارض اضافه شده است. این می تواند با استفاده از عوارض بخشنده اصلاح شود. ( IB7362 ) - مستندات مربوط به رسیدگی به رویداد لمسی را در چهره ساعت گسترش دهید. ( IAF31E )
رفع اشکال
-
EditorSession.getComplicationsPreviewData()
اکنون نقشه ای را برای هر عارضه غیر خالی فقط باز می گرداند. نمونه ای از خالی ComplicationData برای عوارض خالی استفاده می شود. ( i1ef7e )
از عوارض و Watchface نسخه 1.0.0-alpha12 بپوشید
21 آوریل 2021
androidx.wear:wear-*:1.0.0-alpha12
منتشر می شود. نسخه 1.0.0-alpha12 حاوی این commit ها است.
ویژگی های جدید
ویرایشگرهای صورت باید برای کمک به مخزن که جنبه یک ساعت در حال پیکربندی است ، قسمت هایی از چهره ساعت را برجسته کنند. ما به پارامترهای رندر گسترش داده ایم تا سبک ها و همچنین عوارض برجسته شود. یک HighlightLayer اختیاری جدید وجود دارد که قرار است در بالای چهره ساعت با شفافیت آلفا قرار گیرد (API های تصویر می توانند این حصیر را برای شما انجام دهند ، یا برای حداکثر انعطاف پذیری ، به خودی خود را به خودی خود ارائه دهند). به عنوان مثال فرض کنید شما سبکی داشتید که به شما امکان می دهد ظاهر دستان ساعت را پیکربندی کنید ، رندر شما در RenderHighlightLayer می تواند یک طرح کلی را در اطراف خود ترسیم کند.
برای تشویق پشتیبانی از ارائه دهنده عوارض برای دسترسی ، ما در زمینه ContentDescription به عنوان یک آرگومان سازنده اجباری ، PhotaImageComplicationData.Builder's ، MonochrematicArimageComationData.Builder و SmallImagecomplicationData.Builder را انجام داده ایم. AccricationTapFilter و عوارض. createedgecomplicationBuilder برای پشتیبانی از عوارض لبه اضافه شده است (در اطراف لبه صفحه نمایش داده می شود). ارائه و آزمایش آزمایش عوارض لبه به چهره ساعت واگذار شده است. آزمایش Hit Hit از ویرایشگر همراه پشتیبانی نمی شود.
تغییرات API
- پیشوند
PROVIDER_
اضافه شده به ثابت در SystemProviders. ( i1e773 ) - ما
PhotoImageComplicationData.Builder
را ساخته ایم ،MonochromaticImageComplicationData.Builder
contentDescription
رنگ وSmallImageComplicationData.Builder
. ( i9643a ) -
ProviderInfoRetriever.requestPreviewComplicationData
بهretrievePreviewComplicationData
تغییر نام داده است. ( i911ee ) -
ComplicationProviderService
از جاوا به کولتین. ( i849f2 ) -
ComplicationProviderService.onBind
اکنون نهایی است ( I39AF5 ) - ما
CanvasComplication
رابط را مجدداً مجدداً مجدداً جابجا کرده ایم وCanvasComplicaitonDrawable
،GlesTextureComplication
وComplicationHighlightRenderer
بهwear-watchface-complications-rendering
منتقل کرده ایم. ( i84670 ) -
RenderParameters
برای پشتیبانی از ارائه برجسته برجسته مورد استفاده قرار گرفته است. اکنون می توان درخواست ارائه نکات برجسته برای سبک ها و همچنین همه یا یک عارضه واحد را درخواست کرد. علاوه بر این ، Canvasrenderer و Glesrenderer چگونه یک روش انتزاعی جدید RenderHighlightLayer برای ارائه هرگونه برجسته درخواست شده توسط ویرایشگر دارند. Layer به WatchFacelayer تغییر نام داده است. ( IC2444 ) -
ComplicationTapFilter
وComplication.createEdgeComplicationBuilder
برای پشتیبانی از عوارض لبه اضافه شده است. ارائه و آزمایش آزمایش عوارض لبه به چهره ساعت واگذار شده است. آزمایش HIT از داخل ویراستاران پشتیبانی نمی شود. ( IA6604 ) - برای
DoubleRangeUserStyleSetting
&LongRangeUserStyleSetting
:defaultValue
،maximumValue
وminimumValue
اکنون خصوصیات کوتلین هستند. علاوه بر این ،UserStyleSetting.Option
عملکرد مانند Tobooleanoption ، TocoplicationOptions ، Tolistoption و موارد مشابه حذف شده است. ( i52899 ) - اندازه چانه را به خصوصیات دستگاه موجود در صورت ساعت اضافه کنید. ( i76e1e )
- سازنده
ComplicationHighlightRenderer
اکنون پارامترهایoutlineExpansion
وoutlineStrokeWidth
می پذیرد. ( i87009 ) -
ComplicationDrawable.getNoDataText
اکنون بخشی از API عمومی است. ( i00598 )
نسخه 1.0.0-alpha11
7 آوریل 2021
androidx.wear:wear-*:1.0.0-alpha11
منتشر می شود. نسخه 1.0.0-alpha11 حاوی این commit ها است.
ویژگی های جدید
- لهستانی بیشتری در مورد API های Face Watch اعمال شده است. بسیاری از تغییرات نوسازی ساده هستند اما
InteractiveWatchFaceWcsClient
وInteractiveWatchFaceSysUiClient
درInteractiveWatchFaceClient
ادغام شده اند.
تغییرات API
- ContentDescriptionLabel.Text اکنون یک طرح عارضه به جای کتابخانه پشتیبانی پوشیدنی قدیمی به موقع وابسته است. ( i80c03 )
-
SystemProviders.GOOGLE_PAY
تضمین نمی شود که در تمام دستگاه های Android R وجود داشته باشد ، بنابراین از لیست حذف شده است. هنوز هم می توان از این ارائه دهنده از طریقDefaultComplicationProviderPolicy
( IF01B5 ) استفاده کرد - ما برای قوام به AccricationUpdateCallback به AccricationUpdatelistener تغییر نام داده ایم. ( i61ec7 )
- نقشه فرمت سیم Userstyle به
Map<String, byte[]>
تغییر یافته است و برای راحتی ، یک کلاسUserStyleData
به API عمومی اضافه شده است و اکنون توسط Wear-Watchface-Client و Wear-Watchface-Editor استفاده می شود. علاوه بر این علاوه بر CustomValueUserstylesetting.CustomValueOption.Value اکنون به جایString
byte[]
است. ( IAA103 ) -
UserStyleSetting
وUserStyleSetting.Option
اکنون به ترتیب ازUserStyleSetting.Id
وUserStyleSetting.Option.Id
استفاده کنید تا شناسه های خود را به جای یک رشته ذخیره کنید. ( i63f72 ) -
InteractiveWatchFaceClient.SystemState
بهWatchUiState
تغییر نام داده است. ( i6a4e0 ) -
InteractiveWatchFaceWcsClient
وInteractiveWatchFaceSysUiClient
ادغام شده اند زیرا توضیح تقسیم مسئولیت دشوار است ( IFF3FA ) - مقادیر enum لایه برای وضوح تغییر نام داده شده است.
Layer#TOP_LAYER
اکنونLayer#COMPLICATIONS_OVERLAY
است وLayer#BASE_LAYER
اکنونLayer#BASE
است ( IA144E ) -
UserStyleListener
بهUserStyleChangeListener
تغییر نام داده است ( I18524 ) -
UserStyleRepository
بهCurrentUserStyleRepository
تغییر نام داده شده است ( i6ea53 ) -
InteractiveWatchFaceWcsClient.updateInstance
بهupdateWatchfaceInstance
تغییر نام داده است. ( i321dc ) - رویدادهای Taptype Watchface به تراز کردن با MotionEvents / آهنگسازی تغییر نام داده اند. ( I0DFD0 )
- TakeWatchFaceScreenShot به RenderWatchFacetoBitMap تغییر نام داده است ، و TeakecomplicationsCreenshot به RenderComplicationTobitMap تغییر نام داده است ( IE0697 )
- رابط Canvascomplication به نفع Class Class Open CanvasComplication DRAWDABLE حذف شده است. ( i1f81f )
-
WatcfaceControlServiceFactory
از API عمومی حذف شده است. ( i1f8d3 ) - ما به
CanvasComplication.setData
بهCanvasComplication.loadData
تغییر نام داده ایم. ( IF1239 ) -
ComplicationsManager.bringAttentionToComplication
بهdisplayPressedAnimation
تغییر نام داده است. ( IC4297 ) -
WatchFaceService.createWatchFace
اکنون یک حاشیه نویسی@UiThread
دارد. ( IB54C2 ) - برای رفع یک اشکال ، نام یک پارامتر CanvasComplicationDrawtable را تغییر داد. ( I50DAC )
- ما برای پشتیبانی از ارسال
HeadlessWatchFaceClient
از طریق AIDL ، ماHeadlessWatchFaceClient.toBundle()
وHeadlessWatchFaceClient.createFromBundle
اضافه کرده ایم. ( I07C35 ) - HeadlessWatchFaceClient و InteractiveWatchFaceclient اکنون ClientDisconnectListener و IsConnectionalive () دارند تا به شما امکان دهند که آیا اتصال به دلایلی شکسته شده است (به عنوان مثال کشته شدن ساعت). ( IE446D )
-
WatchFaceControlClient#getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClientAsync
اکنون یک عملکرد تعلیق است و بهgetOrCreateInteractiveWatchFaceClient
تغییر نام داده است. ( IB745D ) -
EditorState.commitChanges
وhasCommitChanges()
بهshouldCommitChanges()
تغییر نام داده است. ( i06e04 ) -
previewComplicationData
بهpreviewComplicationsData
تغییر نام داده است تا بیش از یک عارضه در نقشه را نشان دهد. ( i56c06 ) -
InteractiveWatchFaceWcsClient.bringAttentionToComplication
بهdisplayPressedAnimation
برای سازگاری باComplicationsManager.displayPressedAnimation
تغییر نام داده است. ( IC9999 ) - تمام نمونه های شناسه نمونه Watchface در یک کلاس جدید WatchfaceID ( I45FDF ) محصور شده است
- برای نشان دادن کثرت ، دارایی
complicationState
بهcomplicationsState
تغییر یافته است. ( ided07 ) - ما تبدیل های مختلف چسباننده مشتری با لباس را حذف کرده ایم ، آنها باید لازم باشند. ( ICC4C0 )
- برای
EditorServiceClient
سازگاری ، برای استفاده از شنوندگان به جای ناظران ، مجدداً مورد استفاده قرار گرفته است. ( IEC3A4 ) - ما یک زن و شوهر از حاشیه نویسی های
@Px
گمشده را بهInteractiveWatchFaceSysUiClient
وWatchFaceControlClient
اضافه کرده ایم. ( i3277a ) - برای قوام به EditorObserverCallback به EditorObserverListener تغییر نام داد. ( IE572D )
- editorState.WatchfaceInstanceId به سطح API Android R API و بالاتر محدود شده است و دیگر قابل قبول نیست. ( id52bb )
-
EditorSession.launchComplicationProviderChooser
openComplicationProviderChooser
( i9d441 ) -
EditorSession.createOnWatchEditingSessionAsync
بهcreateOnWatchEditingSession
تغییر نام داده است و اکنون یک عملکرد تعلیق است. ( id257b ) - چندین حاشیه نویسی
@UiThread
را درEditorSession
اضافه کرد. ( i6935c ) -
UserStyleSetting.affectsLayers
بهaffectedLayers
تغییر نام داده است. ( i6e22b )
نسخه 1.0.0-alpha10
24 مارس 2021
androidx.wear:wear-*:1.0.0-alpha10
منتشر می شود. نسخه 1.0.0-alpha10 حاوی این commit ها است.
ویژگی های جدید
- اکنون امکان ایجاد اشیاء GL باز (به عنوان مثال بافت) در طول Watchcaceservice.createwatchface امکان پذیر است زیرا Glesrenderer اکنون نیاز به یک تماس صریح برای INITOPENGLCONTEXT دارد که می تواند در CreateWatchFace انجام شود.
تغییرات API
-
IdAndComplicationData
کمی بی دست و پا بود و از API عمومی حذف شده است. کلاس ها و رابط هایی که از آن استفاده می کردند ، مجدداً مورد استفاده قرار گرفته اند. ( i4c928 ) - ما
ReferenceTime
باCountUpTimeReference
وCountDownTimeReference
که خود توضیحی تر هستند جایگزین کرده ایم. ( IB66C6 ) - برخی از یادداشت های
@Px
و@ColorInt
را از دست داده است. ( i9bbc3 ) -
Complication.complicationConfigExtras
Bundle.EMPTY
( IAD04F ) -
GlesRenderer
اکنون شما را ملزم به تماس باinitOpenGLContext
پس از ساخت و ساز می کند. این عملکرد یک جزئیات داخلی بود اما اکنون در API عمومی قرار دارد تا تماس های GL را زودتر در داخل CreateWatchface قرار دهد. ( i726c2 ) - ما
Complication.setRenderer
همانطور که لازم نیست. ( IE992F ) -
Complicaiton.setComplicationBounds
دیگر بخشی از API عمومی نیست. اگر نیاز به تنظیم موقعیت یک عارضه دارید ، این کار را می توان از طریقComplicationsUserStyleSetting
. ( IBD9E5 ) -
ComplicationsManager.TapCallback.onComplicationSingleTapped
بهonComplicationTapped
تغییر نام داده است. ( i3a55c ) -
ComplicationOutlineRenderer.drawComplicationSelectOutline
بهdrawComplicationOutline
تغییر نام داده است. ( I14B88 )
نسخه 1.0.0-alpha09
10 مارس 2021
androidx.wear:wear-complications-*:1.0.0-alpha09
و androidx.wear:wear-watchface-*:1.0.0-alpha09
منتشر می شود. نسخه 1.0.0-alpha09 حاوی این commit ها است.
ویژگی های جدید
- رابط بین میزبان WCS/SYSUI و چهره Watch On تکامل یافته است. اکنون برای یک ویرایشگر امکان پذیر است که آیا تغییر سبک باعث ایجاد یا غیرفعال کردن عارضه می شود (فعال شده = در ابتدا قابل کنترل به علاوه هرگونه غلبه از عوارض بخشیدن). همچنین
EditorService.closeEditor
به Sysui اجازه می دهد تا در صورت لزوم از راه دور ویرایشگر Watch Face را ببندد. - علاوه بر این
InteractiveWatchFaceWcsClient.setUserStyle
watchfacewcsclient.setuSerstyle با یکupdateInstance
فرمان قدرتمندتر که: شناسه نمونه را تغییر می دهد ، سبک را تنظیم می کند و همه را به صورت یکنواخت پاک می کند.
تغییرات API
- ردیابی به کتابخانه های Watchface اضافه شده است. ( i1a141 )
- در حال حاضر
ComplicationState
دارای یک ویژگی جدیدinitiallyEnabled
است که برای پیش بینی پیامدهای سبک های تعویض مفید است. ( i8c905 ) - ما با یک
updateInstance
InteractiveWatchFaceWcsClient.setUserStyle
قدرتمندتر جایگزین شده است که: شناسه نمونه را تغییر می دهد ، سبک را تنظیم می کند و عوارض را پاک می کند. ( ife6f6 ) - API های تصاویر WatchFaceClient دیگر تصاویر را فشرده نمی کنند زیرا این کار کند بود ، در عوض ما هر پردازش پست را به تماس گیرنده می گذاریم. ( id35af )
- اکنون می توان از راه دور ویرایشگر On Watchface را از طریق
EditorService.closeEditor
بسته کرد. ( IC5AA4 ) - حاشیه نویسی قابل تهوع اضافه شده ( IC16ED )
نسخه 1.0.0-alpha08
24 فوریه 2021
androidx.wear:wear-*:1.0.0-alpha08
منتشر می شود. نسخه 1.0.0-alpha08 حاوی این commit ها است.
ویژگی های جدید
- برخی از چهره های ساعت در حدود یک یا چند عارضه خاص طراحی شده اند ، برای پشتیبانی از این ، ما عارضه را اضافه کرده ایم. Builder#SetFixedComplicationProvider که در صورت تنظیم صحیح ، مانع از تغییر عارضه در آن شکاف می شود.
- کتابخانه های Watchface اولین Kotlin هستند و از Coroutines استفاده می کنند (به عنوان مثال توابع تعلیق). برای کاربران جاوا ، ما برای بهبود قابلیت تعامل در کتابخانه های زیر ، ما را به بسته بندی های گوش LeadableFuture ارائه داده ایم: سایش/سایش-تماشای-گواوا ، سایش/سایش-ساعت-مشتری-گوا و سایش/سایش-ساعت-ویرایشگر.
تغییرات API
- ما پشتیبانی از شیرهای مضاعف را در مورد عوارض راه اندازی انتخاب کننده ارائه دهنده حذف کرده ایم ، این ویژگی در فضای ساعتها رایج نبود و اجرای SYSUI را پیچیده می کند. ( i3ef24 )
- در صورت بسته شدن باند به طور غیر منتظره ، روشهای ارائه دهنده ForeTriever ممکن است ServiceConnectedException را پرتاب کنند. ( IB2CC4 )
- از Android 11 به بعد ، محدودیت هایی وجود دارد که می توان ProviderChooser را اجرا کرد ، علاوه بر این ، ما دوست داریم که ویرایشگرها با
wear-watchface-editor
ساخته شوند ، بنابراین SccomicationHelperactivity از API عمومی حذف می شود. ( IB19C1 ) - روشهای استاتیک متن را به نفع سازندگان حذف کنید. ( IBE399 )
- ما برای روشهای تعلیق کتابخانه Watch Face مختلف ، بسته بندی های Guava LeadableFuture را معرفی کرده ایم. ( i16b2c )
- برای وضوح API ، ما یک سازنده ثانویه را به رندر پارامترهایی اضافه کردیم که نیازی به رنگ ندارد ، برای استفاده با LayerModes غیر از
LayerMode.DRAW_OUTLINED
. ( i497ea ) - پیش از این ، لیست های لیست با دیگری متفاوت بود زیرا یک استدلال پیش فرض داشت. اکنون تمام سازندگان زیر کلاس سبک ، مقدار پیش فرض را به طول می انجامند. ( i9dbfd )
- Canvascomplication برای استفاده از روش پنهان استفاده مجدد شده است ، که اجرای یک زیر کلاس را آسانتر می کند ( I5B321 )
- ما ویرایشگر را به نفع یک ویرایشگر جدید و
EditorSession.broadcastState()
برای پخش به روزرسانی ها به یک ناظر (به طور معمول sysui) ، مجدداً مورد استفاده قرار داده ایم. ( IC4370 ) - برخی از فضای ساعت در اطراف یک عارضه خاص به عنوان بخشی جدایی ناپذیر از چهره ساعت ساخته شده است که در آن ارائه دهنده قابل تنظیم کاربر نیست. برای پشتیبانی از این ، ما
Complication.Builder#setFixedComplicationProvider
. ( i4509e ) - EditorRequest اکنون نام بسته را به جای ComponentName مشخص می کند زیرا برای Sysui ناخوشایند بود که نام کلاس ویرایشگر را جستجو کند ، و ما فقط به نام بسته احتیاج داریم. ( IB6814 )
نسخه 1.0.0-alpha07
10 فوریه 2021
androidx.wear:wear-*:1.0.0-alpha07
منتشر می شود. نسخه 1.0.0-alpha07 حاوی این commit ها است.
ویژگی های جدید
- watchfaceservice.createwatchface اکنون یک عملکرد معلق است به این معنی که ساعت مچی دیگر مجبور نیست در حالی که منتظر IO است ، موضوع UI را مسدود کند. به طور مشابه سایش-ویرایشگر-ویرایشگر و ساخت سایش
تغییرات API
- کلاس PhotoImage را حذف کرده و از نماد مستقیم استفاده کنید. ( i8a70b )
- در معرض معتبر AcctionData. ( I91366 )
- ویژگی های شبیه تصویر را صریح تر کنید. ( i81700 )
- ویرایشگر سایش-ساعت و-ترکیبات سایش-Data برای استفاده از توابع تعلیق به جای Coroutines استفاده شده است. Rx Java & Future Compat Contars برای دنبال کردن. ( IF3C5F )
- ProviderInforeTriever اکنون اکنون PreviewNotaIlableException را پرتاب می کند اگر RequestPreviewComplicationData نتواند داده های پیش نمایش را به دلیل مشکلات اتصال یا عدم پشتیبانی API بازگرداند. ( i4964d )
- WatchFaceControlService::createWatchFaceControlClient is now a suspended fuction and getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient is now called getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClientAsync returning
Deferred<InteractiveWatchFaceWcsClient>
. RX Java و بسته بندی های سازگار آینده برای دنبال کردن. ( i5d461 ) - تغییر نام
CATEGORY_PROVIDER_CONFIG_ACTION
بهCATEGORY_PROVIDER_CONFIG
. ( I7C068 ) - لطفاً توجه داشته باشید که CreateOnwatchEditingsion اکنون یک عملکرد معلق است زیرا ساعت مچی گاهی اوقات تا مدت کوتاهی پس از شروع فعالیت ویرایشگر در دسترس نیست. ( ida9aa )
- Watchfaceservice.CreateEwatchface اکنون یک عملکرد معلق است که امکان ابتکار عمل Async را فراهم می کند ، قبلاً مجبور بودید موضوع اصلی را مسدود کنید. ( if076a )
- Userstyle اکنون یک اپراتور آرایه دارد و ما یاران بازیگران را به userstyle.option اضافه کرده ایم. ( i35036 )
- ما یک اشکال باتلاق با سیم های Userstyle را تغییر داده ایم که برخی از API پنهان ناپایدار را تغییر می دهد. ( i8be09 )
- ما به CustomValueUserstylesotting اضافه کرده ایم که به شما امکان می دهد یک رشته خاص برنامه را در یک userstyle ذخیره کنید. ویراستاران پیش فرض Watch Face این مقدار را نادیده می گیرند. ( IC04D2 )
- SustanceID در موارد اضافی برای نسخه های R و قدیمی تر Wearos Android که ما نمی توانیم ارتقا دهیم ، منتقل نمی شود. برای پشتیبانی از این ، اکنون ما به Instancid اجازه می دهیم که تهی باشد. ( id8b78 )
- EditorRequest اکنون شامل نام مؤلفه ویرایشگر است که به عنوان مؤلفه در WatchfaceEditorContract.CreateIntent ( I3CD06 ) تنظیم شده است
- Watchface EditorResult اکنون شامل پیش نمایش SccomictionData است تا به تماس گیرنده اجازه دهد پس از ویرایش ، از صفحه نمایش Watchface عکس بگیرد. ( I2C561 )
رفع اشکال
- ToString () اضافه شده به Userstyle ، userstyletting و userstyleschema است که کار با این کلاس ها را کمی بهتر می کند. ( i9f5ec )
نسخه 1.0.0-alpha06
27 ژانویه 2021
androidx.wear:wear-*:1.0.0-alpha06
منتشر می شود. نسخه 1.0.0-alpha06 حاوی این commit ها است.
ویژگی های جدید
- ما یک ویرایشگر جدید در کتابخانه و ساییدگی کتابخانه را معرفی کرده ایم که به توسعه دهندگان Face و OEM های بالقوه برای ساختن یک ویرایشگر سبک و عارضه امکان می دهد. Sysui قصد را به چهره Watch ارسال می کند که از کلاس جدید EditorSession برای دسترسی به جزئیات Watchface استفاده می کند و نتیجه را از طریق Activity.SetWatchRequestResult ثبت می کند. برای پشتیبانی از این ، ما ProviderInforeTriever.RequestPreviewComplicationData را اضافه کرده ایم که به ویرایشگرهای Watch اجازه می دهد تا از پیش نمایش PreviewData درخواست کنند. مزیت Preview MactricationData برخلاف داده های زنده است که شما لازم نیست نگران نمایش گفتگوی مجوز هنگام ارائه ویرایشگر خود باشید (توجه داشته باشید که اگر یک کاربر با مجوز ارائه دهنده را انتخاب کند ، باز هم از آنها خواسته می شود که مجوز را اعطا کنند).
تغییرات API
- MactionProviderInfo اکنون زمینه ای برای نام سازنده ارائه دهنده دارد ، پشتیبانی از این زمینه در بعداً به Wearos اضافه می شود و در ضمن ، تهی خواهد بود. ( id8fc4 )
- ما ProviderInforeTriever.RequestPreviewComplicationData را اضافه کرده ایم که به ویرایشگرهای Watch اجازه می دهد تا از پیش نمایش PreviewData درخواست کنند. این مفید است زیرا عوارض زنده ممکن است به مجوز نیاز داشته باشد و اکنون می توانید داده های پیش نمایش را برای عوارض فعال نمایش دهید. ( i2e1df )
- AccricationManager اکنون یک پارامتر اختیاری از سازنده Watchface است و آرگومان ها دوباره مرتب شده اند تا این امکان را فراهم کند. ( i66c76 )
- ما یک بسته نرم افزاری اختیاری را به عوارض اضافه کرده ایم که در صورت ادغام با قصد ارسال شده برای راه اندازی فعالیت انتخاب کننده انتخاب کننده. ( IFD4AD )
- ما یک کتابخانه جدید
wear-watchface-editor
برای پشتیبانی از Watch Face و Sysui میزبان ویراستاران اضافه کرده ایم. Sysui این ویراستاران را با ارسال یک هدف راه اندازی می کند. سرویس فعالیت Watch Face می تواند از کلاس جدید EditorSession برای دسترسی به جزئیات Watchface استفاده کند و نتیجه را از طریق Activity.SetWatchRequestResult ثبت کند. ( I2110D ) - layermode.draw_highlighted اکنون LayerMode.draw_outlined و RenderParameters نامیده می شود. HighlightComplicationId اکنون RenderParameters.SelectedComplicationId نامیده می شود که علاوه بر یک طرح کلی ، عارضه مشخص شده را نیز برجسته می کند. ( i90a40 )
- WatchFaceControlClient.GetOrCreateEwallPaperserviceBackedInteractiveWatchFaceFaceFaceWcsClient اکنون می تواند در صورتی که این سرویس در حالی که منتظر ایجاد Watchface هستند ، با یک سرویس ServiceStartFailureException حل شود. ( I0F509 )
- editorsession.complicationpreviewdata اکنون یک گوش شنوایی است زیرا واکشی این داده ها یک فرآیند ناهمزمان است. ( iead9d )
رفع اشکال
- ما در حال حذف زمینه های بلااستفاده از SccomicationOverlay هستیم که باعث می شود و عوارض را فعال کنیم. ( I17B71 )
نسخه 1.0.0-alpha05
13 ژانویه 2021
androidx.wear:wear-*:1.0.0-alpha05
منتشر می شود. نسخه 1.0.0-alpha05 حاوی این commit ها است.
ویژگی های جدید
فضای ساعتها اغلب با تعداد مختلفی از عوارض نشان داده شده از تعدادی از تنظیمات عارضه پشتیبانی می کنند. برای آسانتر کردن این کار ، اکنون با فراخوانی SetEnabled (false) در سازنده ، از عوارض غیرفعال در ابتدا پشتیبانی می کنیم. این موارد بعداً از طریق عوارض بخشیدن به صورت فعال می شوند.
تغییرات API
- در حال حاضر عارضه ،
Collection<ComplicationType>
به جای یک آرایه Int ، استفاده از آن را آسان تر می کند. ( i1f13d ) -
ProviderInfoRetriever.retrieveProviderInfo
اکنون به درستی باز می گرددListenableFuture<ProviderInfo[]>
. ( IF2710 ) - اکنون می توانید با فراخوانی SetEnabled (false) در سازنده ، یک عارضه در ابتدا غیرفعال ایجاد کنید. ( IDAA53 )
- WatchFacestate اکنون دارای یک ویژگی بدون سر و صدا است که فقط در مورد نمونه های بدون سر صادق است. ( IFA900 )
- AccricationDrawdable اکنون به صورت اختیاری از بارگذاری همزمان Drawables پشتیبانی می کند. این توسط API های تصویر استفاده می شود. ( i34d4a )
نسخه 1.0.0-alpha04
16 دسامبر 2020
androidx.wear:wear-*:1.0.0-alpha04
منتشر می شود. نسخه 1.0.0-alpha04 شامل این تعهدات است.
ویژگی های جدید
- کتابخانه Wear Watch Face اکنون از تنظیمات در هر نوع پشتیبانی می کند. به عنوان مثال می توانید برای SccomicationType.long_text به یک جعبه محدودیت گسترده تغییر دهید.
تغییرات API
- در حال حاضر عوارض از حرکات عوارض استفاده می کنند که
Map<ComplicationType, RectF>
می بندد. ( i1ebe7 ) - RenderParameters اکنون به شما امکان می دهد رنگ برجسته را برای استفاده در عکس های صفحه مشخص کنید. ( iff42b )
- به استثنای مرزهایی که اکنون برای اصلاح عوارض باید از عوارض استفاده کنید ، این اطمینان از این است که سیستم عامل در همگام سازی نگه داشته شود. ( i8dc5d )
- رندر اکنون یک کلاس مهر و موم شده است. این بدان معناست که Canvasrenderer و Glesrenderer اکنون کلاسهای داخلی رندر هستند. ( IAB5D4 ، B/173803230 )
- CanvascomplicationDrawable.DrawHighlight به Drawoutline تغییر نام داد. ObservableWatchData اکنون چند حاشیه نویسی Uithread مفقود شده است. Screenstate اکنون کاملاً از Watchstate حذف شده است. ( IF1393 )
- حداقل سطح API برای سایش در حال حاضر 25 است. توجه داشته باشید که پشتیبانی بوم سخت افزار به سطح 26 یا بالاتر API نیاز دارد. ( IC9BBD )
- InteractiveWatchfaceWcsClient اکنون یک یاور getComplictationIdat دارد. ( I05811 )
- سطح API برای مشتری سایش به 25 کاهش یافته است ، اما API های شات صفحه به API سطح 27 نیاز دارند. ( ID31C2 )
رفع اشکال
- اکنون ما عارضه عارضه فعلی عارضه را در عوارض در معرض دید قرار می دهیم. ( i9b390 )
- InteractiveWatchfaceWcs اکنون روشی را دارد که به طور خلاصه عارضه مشخص شده را برجسته می کند. ( i6d31c )
-
InteractiveWatchFaceWcsClient#setUserStyle
اکنون یک نقشه اضافه بار داردکه به طور بالقوه می تواند از یک سفر دور اضافی IPC که برای ساخت Userstyle لازم است جلوگیری کند. ( i24eec )
نسخه 1.0.0-alpha03
2 دسامبر 2020
androidx.wear:wear-*:1.0.0-alpha03
منتشر می شود. نسخه 1.0.0-alpha03 شامل این تعهدات است.
ویژگی های جدید
در حال حاضر کلاس عارضه دارای یک خاصیت CompicationData است که به ساعت مچی اجازه می دهد تغییرات عارضه را مشاهده کند. این امر باعث می شود ابعاد عارضه بر اساس نوع عارضه تغییر کند.
اکنون نرخ فریم متغیر با اختصاص به Renderer.interactiveDrawModeUpdatedElaymillis پشتیبانی می شود. برای چهره های تماشای که در هر ثانیه انیمیشن های کوتاه را اجرا می کنند ، این می تواند با رفتن به خواب هنگام عدم انیمیشن منجر به صرفه جویی در مصرف برق شود.
تغییرات API
-
BACKGROUND_IMAGE
به همراه کلاسهای مرتبط بهPHOTO_IMAGE
تغییر نام داده است. این نوع عارضه منحصراً برای پس زمینه ها استفاده نمی شود از این رو تغییر نام. ( i995c6 ) - DefaultComplicationProviderPolicy به درستی با intdefs حاشیه نویسی می شود. ( i3b431 )
- کلاس HiddenPEDENTENTTEXT دیگر از طریق ContentDescriptionLabel دیگر در معرض دید قرار نمی گیرد ، در عوض ما یک دسترسی را برای دریافت متن در یک زمان مشخص اضافه می کنیم. ( ICA692 )
- سازنده ObservableWatchData اکنون داخلی است. ( I30121 ، b/173802666 )
- در حال حاضر عارضه دارای CompicationData است که به چهره های ساعت اجازه می دهد تغییرات عارضه را مشاهده کنند. عارضه همچنین دارای یک تماس جدید isactiveat است که می تواند مورد استفاده قرار گیرد تا در DateTime ارائه شده هر چیزی ارائه شود. ( IC0E2A )
-
SharedMemoryImage
خالی دیگر در API عمومی نیست. ( i7ee17 ) -
WatchFace.overridePreviewReferenceTimeMillis
اکنون یک حاشیه نویسی داخل رحمی دارد و Getter و Setter نام های مداوم دارند. ( ia5f78 ) - عارضه .
Complication.Builder
اکنون از طریقComplication.createRoundRectComplicationBuilder
ایجاد شده استComplication.createBackgroundComplicationBuilder
- اضافه شده watchface.taplistener که اجازه می دهد تا شیرهای موجود در اثر عوارض توسط ساعت مچی مشاهده نشود. ( IC2fe1 ، b/172721168 )
- Watchface اکنون با اختصاص دادن به
Renderer.interactiveDrawModeUpdateDelayMillis
از نرخ فریم متغیر پشتیبانی می کند. این می تواند در هنگام عدم انیمیشن به حفظ عمر باتری با خوابیدن کمک کند. ( I707C9 ) - Watchface.Builder دیگر مورد نیاز نیست و نامعتبر است () و InteractiveUpdateratemillis به Renderer منتقل شده است. ( i329ea )
- برای همکاری بهتر جاوا ، تغییر نام دادخواست برای خصوصیات بولی در ساعت نگهبان ( i6d2f1 )
- تغییر نام TapListener به tapcallback و InvalidAtecallback به InvalidAtelistener برای قوام. ( i9414e )
- گزینه های سبک Watch 2.0 Watchface برای وضوح به کلاس خود منتقل شده اند. Watchface.Builder Setters اکنون گیرنده های کلاس Watchface متقارن را دارند. ( iefdfc )
- اضافه شده InteractiveWatchFaceWcsClient و
WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient
که یا یک نمونه موجود دریافت می کند یا پس از اتصال سرویس Wallaper و ایجاد موتور ، آن را ایجاد می کند. ( id666e ) - WatchFaceControlClient اکنون رابط کاربری است که به آزمایشات اجازه می دهد تا آن را مسخره کند. ( i875d9 )
- HeadlessWatchFaceClient ، InteractiveWatchFacesSuicLientImpl ، InteractiveWatchfaceWcsClient اکنون در رابط هایی برای تسهیل بهتر آزمایش هستند. ( i7cdc3 )
- حاشیه نویسی اضافه شده به روشهای موجود در
wear-watchface-complications-rendering
( I0D65C )
رفع اشکال
- شکل صفحه نمایش را از DeviceConfig ، که در حال کپی کردن
android.content.res.Configuration#isScreenRound()
است ، حذف کنید. - تغییر
WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient
برای پذیرش یکMap<String, String>
به جایUserStyle
، زیرا ایجاد یکUserStyle
بدون دانستن طرحواره ای که فقط پس از ایجاد مشتری می توانید بدست آورید ، دشوار است. ( IEA02A ) -
InteractiveWatchFaceWcsClient
برطرف کنید تا به جای قالب سیم ازComplicationState
استفاده کنید. ( ICB8A4 ) -
UserStyleSettings
اکنون یک کلاس مهر و موم شده است زیرا ویراستاران چهره ساعت فقط کلاس های ساخته شده را درک می کنند. ( i2d797 )
نسخه 1.0.0-alpha02
11 نوامبر 2020
androidx.wear:wear-*:1.0.0-alpha02
منتشر می شود. نسخه 1.0.0-alpha02 شامل این تعهدات است.
تغییرات API
- در حال حاضر
ComplicationDetails
به عنوانComplicationState
نامیده می شود و به درستی پیچیده شده است و استفاده از پشتیبانی پوشیدنی@ComplicationData.ComplicationType
به AndroidxComplicationType
منتقل شده است. ( i4dd36 ) - یک پارامتر
highlightedComplicationId
اختیاری را به RenderParameters اضافه کنید که به شما امکان می دهد تا یک عارضه واحد را در تصاویر برجسته کنید. ( i66ce9 ) -
ComplicationProviderService
برای استفاده از API عارضه سبک جدید برای قوام ( id5aea ) -
getPreviewReferenceTimeMillis
اکنون زمان مرجع ازDeviceConfig
را دریافت می کند. ( i779fe ) - Simplifying Renderer API surface, can use
SurfaceHolder.Callback
to observe changes instead. ( I210db ) -
CanvasComplicationRenderer
doesn't extend fromRenderer
, renaming it for clarity. ( Ibe880 )
رفع اشکال
- First version of
androidx.wear:wear-watchface-client
( I1e35e ) - Changed the name of
GlesTextureComplication#renderer
for clarity ( Ib78f7 ) - Rename
StyleCategory
toStyleSetting
for clarity ( I488c7 ) - Adding
UserStyleSchema
for a cleaner API ( If36f8 )
نسخه 1.0.0-alpha01
28 اکتبر 2020
androidx.wear:wear-complications-*:1.0.0-alpha01
and androidx.wear:wear-watchface-*:1.0.0-alpha01
are released. نسخه 1.0.0-alpha01 شامل این تعهدات است.
تغییرات API
- Removed some things we didn't intend to expose in public api. ( I41669 )
- Create
androidx.wear:wear-complications-provider
library. ( I77f1f ) - ComplicationsUserStyleCategory the new recommended category for configuring complications ( I96909 )
- Add wear-complication-data API. ( I7c268 )
- Functions with boolean return values to be prefixed with “is” rather than “get” ( If36ff )
- API advice is to avoid using protected so this class has been refactored to take parameters in via the constructor. ( I61644 )
- Rename setBackgroundComplication for clarity. ( I96fe3 )
- Use Kotlin properties for ComplicationDrawable isHighlighted & data ( I4dcc8 )
- Instead of ComplicationRenderer.InvalidateCallback we add Complication#invalidate() ( I4f4c6 )
- These APIs are being deprecated in WearableSupport and are removed here. ( Ib425c )
- Renamed some WatchFace builder methods to emphasize their wear 2.0 legacy nature. ( Idb775 )
- First beta API candidate for wear/wear-watchface ( Id3981 )
- First tracked version of the API. ( Ie9fe6 )
- Properly hiding ComplicationDrawable.BorderStyle IntDef and move to ComplicationStyle for consistency. ( I27f7a )
- Adding missing annotations for ComplicationStyle methods ( I838fd )
- This library has no public API surface ( I88e2b )
- All style category Option classes are now properly final. ( Ib8323 )
- First tracked version of the API. ( I27c85 )
رفع اشکال
- Changed ComplicationProviderService to have an explicit getComplicationPreviewData method. ( I4905f )
- API lint check for MissingGetterMatchingBuilder is enabled for androidx ( I4bbea , b/138602561 )
- Rename wear-complications-rendering. ( Ifea02 )
- Style category display names are now CharSequences ( I28990 )
- Replacing Override with Overlay to match current themes & styles naming conventions. ( I4fde9 )
- Renamed UserStyle#getOptions for clarity. ( I695b6 )
نسخه 1.2.0
نسخه 1.2.0
15 سپتامبر 2021
androidx.wear:wear:1.2.0
is released. نسخه 1.2.0 حاوی این commit ها است.
تغییرات مهم از 1.1.0
Added CurvedText component for easily writing curved text following the curvature of the largest circle that can be inscribed in the view. An usage example:
<androidx.wear.widget.CurvedText android:layout_width="wrap_content" android:layout_height="wrap_content" android:text="example curved text" app:anchorAngleDegrees="180" app:anchorPosition="center" app:clockwise="false" style="@android:style/TextAppearance.Large" />
Added ArcLayout container for laying out its child elements one by one on an arc in either the clockwise or counterclockwise direction. Its children can be both standard android widget or "curved" widgets which implement the
ArcLayout.Widget
interface. ( I536da ) An usage example:<androidx.wear.widget.ArcLayout android:layout_width="match_parent" android:layout_height="match_parent" app:anchorPosition="center"> <ImageView android:layout_width="20dp" android:layout_height="20dp" android:src="@drawable/ic_launcher" /> <androidx.wear.widget.CurvedText android:layout_width="match_parent" android:layout_height="match_parent" android:text="Curved Text" style="@android:style/TextAppearance.Small" android:padding="2dp" /> </androidx.wear.widget.WearArcLayout>
Added a new layout container, DismissibleFrameLayout, which handles back-button-dismiss and/or swipe-to-dismiss, intended for use within an activity. At least one listener must be added to act on a dismissal action. A listener will typically remove a containing view or a fragment from the current activity. setSwipeDismissible(boolean) & setBackButtonDismissible(boolean) are provided for direct control over the features. This new layout is meant to replace the existing SwipeDismissFrameLayout.
Added support for indicating that an Activity can be “auto-resumed” when the device leaves ambient mode in the AmbientModeSupport class. This functionality was previously available in the deprecated WearableActivity class from WearableSupportLibrary. ( I336ab )
Migrated WearableCalendarContract class from Wearable Support Library. This API provides a subset of the data available through CalendarContract , but is automatically synced to wearable devices. ( I6f2d7 )
Added a new API
WearTypeHelper
inandroidx.wear.utils
for determining whether the given wear device is for China. ( Ib01a9 )Added accessibility features to
androidx.wear.widget.ConfirmationOverlay
that will read out messages if set followed by animation description. ( I524dd )Fixed bug that caused ConfirmationActivity to crash if no message was provided. ( Ie6055 )
Fixed bug where horizontally scrolling RecyclerViews caused
WearableDrawerLayout
to peek on all interactions. ( I24c7f )
نسخه 1.2.0-rc01
1 سپتامبر 2021
androidx.wear:wear:1.2.0-rc01
is released with no changes since the last beta. نسخه 1.2.0-rc01 حاوی این commit ها است.
نسخه 1.2.0-beta01
18 آگوست 2021
androidx.wear:wear:1.2.0-beta01
is released. نسخه 1.2.0-beta01 حاوی این تعهدات است.
رفع اشکال
- Fix bug that caused ConfirmationActivity to crash if no message was provided. ( Ie6055 )
Version 1.2.0-alpha13
4 آگوست 2021
androidx.wear:wear:1.2.0-alpha13
is released. Version 1.2.0-alpha13 contains these commits.
تغییرات API
- Renamed
WearTypeHelper.isChinaDevice
toWearTypeHelper.isChinaBuild
. ( I47302 )
رفع اشکال
- We have added accessibility features to
androidx.wear.widget.ConfirmationOverlay
that will read out messages if set followed by animation description. ( I524dd )
Version 1.2.0-alpha12
21 جولای 2021
androidx.wear:wear:1.2.0-alpha12
is released. Version 1.2.0-alpha12 contains these commits.
تغییرات API
- We have added a new API
WearTypeHelper
inandroidx.wear.utils
for determining whether the given wear device is for China. ( Ib01a9 )
Version 1.2.0-alpha11
30 ژوئن 2021
androidx.wear:wear:1.2.0-alpha11
is released. Version 1.2.0-alpha11 contains these commits.
رفع اشکال
- Fixed bug where horizontally scrolling RecyclerViews caused
WearableDrawerLayout
to peek on all interactions. ( I24c7f )
Version 1.2.0-alpha10
2 ژوئن 2021
androidx.wear:wear:1.2.0-alpha10
is released. Version 1.2.0-alpha10 contains these commits.
ویژگی های جدید
- Alpha10 improves accessibility support in Curved Text and ArcLayouts. It also add some minor renaming of in the DismissibleFrameLayout to help clarify the API.
تغییرات API
- We have renamed following methods in
DismissibleFrameLayout
( Ib195e ):-
Callback#onDismissed
->Callback#onDismissedFinished
-
isSwipeDismissible
->isDismissableBySwipe
-
isBackButtonDismissible
->isDismissableByBackButton
-
- We have made following methods final ( Ib195e ):
-
setBackButtonDismissible
-
setSwipeDismissible
-
registerCallback
-
unregisterCallback
-
رفع اشکال
- Use the content of the CurvedTextView on Talkback. ( I05798 )
- Better accessibility for normal views in an ArcLayout. ( I4418d )
Version 1.2.0-alpha09
18 مه 2021
androidx.wear:wear:1.2.0-alpha09
is released. Version 1.2.0-alpha09 contains these commits.
تغییرات API
- Added a new function
CurvedTextView.setTypeface()
(similar toTextView
's), to set the text typeface and bold/italics style. ( I4653c ) - Renamed
WearArcLayout
toArcLayout
,WearCurvedText
toCurvedText
andWearArcLayout.ArcLayoutWidget
toArcLayout.Widget
. ( I6e5ce )- On
ArcLayout.Widget
, renamedgetThicknessPx
intogetThickness
. - Vertical alignment constants on
ArcLayout.LayoutParams
are now named starting withVERTICAL_ALIGN_
(instead of the previousVALIGN_
)
- On
- On
CurvedTextView
, the methodssetMinSweepDegrees
andsetMaxSweepDegrees
were replaced bysetSweepRangeDegrees
( I7a9d9 )
نسخه 1.2.0-alpha08
5 مه 2021
androidx.wear:wear:1.2.0-alpha08
is released. نسخه 1.2.0-alpha08 حاوی این commit ها است.
تغییرات API
- To improve code clarity, we added
@FloatRange
annotations to some angle parameters and return types. ( I430dd ) - In the interface
WearArcLayout.ArcLayoutWidget
, the methodinsideClickArea
is now called isPointInsideClickArea. ( Ia7307 )
نسخه 1.2.0-alpha07
24 مارس 2021
androidx.wear:wear:1.2.0-alpha07
is released. نسخه 1.2.0-alpha07 حاوی این commit ها است.
رفع اشکال
- Fixing errors with non-curved children inside of WearArcLayout caused by using screen size with height bigger than width. These non-curved children are now correctly placed inside of an arc on all screen types.
نسخه 1.2.0-alpha06
27 ژانویه 2021
androidx.wear:wear:1.2.0-alpha06
is released. نسخه 1.2.0-alpha06 حاوی این commit ها است.
تغییرات API
- Migrate the Ongoing Activities library to a new sub-library: wear-ongoing. Classes now live in the androidx.wear.ongoing package (previously was androidx.wear.ongoingactivities) ( I7c029 )
- Migrate WearableCalendarContract class from Wearable Support Library to AndroidX. This API provides a subset of the data available through CalendarContract , but is automatically synced to wearable devices. ( I6f2d7 )
رفع اشکال
- Disable the back button dismiss feature by default in Dismissible FrameLayout since swipe-to-dismiss remains as the main way to navigate back a full screen on Wearable devices ( Ic24e3 )
- Fixed some issues handling children visibility on WearArcLayout ( Icf912 )
نسخه 1.2.0-alpha05
13 ژانویه 2021
androidx.wear:wear:1.2.0-alpha05
is released. نسخه 1.2.0-alpha05 حاوی این commit ها است.
رفع اشکال
- Update the javadoc of AmbientModeSupport class to provide sample snippets to better demonstrate the general use of this class.
نسخه 1.2.0-alpha04
16 دسامبر 2020
androidx.wear:wear:1.2.0-alpha04
is released. نسخه 1.2.0-alpha04 حاوی این commit ها است.
تغییرات API
- Added support for indicating that an Activity can be “auto-resumed” when the device leaves ambient mode in the AmbientModeSupport class. This functionality was previously available in the deprecated WearableActivity class from WearableSupportLibrary. ( I336ab )
- OngoingActivity
- Category can now be set when creating an OngoingActivity, eg
OngoingActivitiy.Builder.getCategory(String)
- OngoingActivityData now has a timestamp of when the OngoingActivity was built -
OngoingActivityData.getTimestamp()
- ( I91cb4 )
- Category can now be set when creating an OngoingActivity, eg
- Added support for setting margins on children of WearArcLayout by changing the layout params to extend MarginLayoutParams, ie WearArcLayout.LayoutParams extends android.view.ViewGroup.MarginLayoutParams. ( I2cd88 )
- Change WearCurvedTextView's anchor type default to
WearArcLayout.ANCHOR_CENTER
(wasWearArcLayout.ANCHOR_START
). This simplifies the contract between the arc layout and the curved text as the curved text by default draws itself x-centered at the top, and the parent arc layout can rotate it to where it needs to be. ( I105ff )
نسخه 1.2.0-alpha03
2 دسامبر 2020
androidx.wear:wear:1.2.0-alpha03
is released. نسخه 1.2.0-alpha03 حاوی این commit ها است.
ویژگی های جدید
A new layout container DismissibleFrameLayout, which handles back-button-dismiss and/or swipe-to-dismiss, intended for use within an activity. At least one listener must be added to act on a dismissal action. A listener will typically remove a containing view or a fragment from the current activity. setSwipeDismissible(boolean) & setBackButtonDismissible(boolean) are provided for direct control over the features. This new layout is meant to replace the existing SwipeDismissFrameLayout.
Curved widgets now handle touch events. Normal widgets inside an WearArcLayout will receive all touch events, mapped to their coordinate space. WearCurvedTextView (inside an WearArcLayout or not) can set onClick and onLongClick handlers.
Ongoing activities classes are now VersionedParcelables instead of using custom serialization/deserialization. The static icon and touch intent are now required.
تغییرات API
- The attribute "sweepDegrees" for WearCurvedTextView is separated into minSweepDegrees and maxSweepDegrees to give a more flexible layout of this widget.
نسخه 1.2.0-alpha02
11 نوامبر 2020
androidx.wear:wear:1.2.0-alpha02
is released. نسخه 1.2.0-alpha02 حاوی این commit ها است.
This release adds a new “Ongoing Activities API” for the first time. This API can be used by developers to signal that a long running activity, such as a fitness exercise or a media playback session is on-going. It allows developers to provide periodic status updates such as “distance and time run” or “current track playing” for display on the watch face or in the app launcher. This functionality is targeted at future devices with the on-going activity functionality enabled.
تغییرات API
- New API for Ongoing Activities, this is a no-op on "unsupported devices.". ( I69a31 )
نسخه 1.2.0-alpha01
28 اکتبر 2020
androidx.wear:wear:1.2.0-alpha01
is released. نسخه 1.2.0-alpha01 حاوی این commit ها است.
ویژگی های جدید
- Added WearCurvedTextView component for easily writing curved text following the curvature of the largest circle that can be inscribed in the view. An usage example:
<androidx.wear.widget.WearCurvedTextView
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:text="example curved text"
app:anchorAngleDegrees="180"
app:anchorPosition="center"
app:clockwise="false"
style="@android:style/TextAppearance.Large"
/>
- Added WearArcLayout container for laying out its child elements one by one on an arc in either the clockwise or counterclockwise direction. Its children can be both standard android widget or "curved" widgets which implement its ArcLayoutWidget interface. An usage example:
<androidx.wear.widget.WearArcLayout
android:layout_width="match_parent"
android:layout_height="match_parent"
app:anchorPosition="center">
<ImageView
android:layout_width="20dp"
android:layout_height="20dp"
android:src="@drawable/ic_launcher"
/>
<androidx.wear.widget.WearCurvedTextView
android:layout_width="match_parent"
android:layout_height="match_parent"
android:text="Curved Text"
style="@android:style/TextAppearance.Small"
android:padding="2dp"
/>
</androidx.wear.widget.WearArcLayout>
( I536da )
Wear-Input 1.2
نسخه 1.2.0-alpha02
29 سپتامبر 2021
androidx.wear:wear-input:1.2.0-alpha02
and androidx.wear:wear-input-testing:1.2.0-alpha02
are released. نسخه 1.2.0-alpha02 حاوی این commit ها است.
تغییرات API
- Renamed
disallowEmoji
tosetEmojisAllowed
inWearableRemoteInputExtender
to use to set whether the option to draw emojis will be shown. ( I28393 )
نسخه 1.2.0-alpha01
15 سپتامبر 2021
androidx.wear:wear-input:1.2.0-alpha01
and androidx.wear:wear-input-testing:1.2.0-alpha01
are released. نسخه 1.2.0-alpha01 حاوی این commit ها است.
تغییرات API
- Exposed all button location constants from
WearableButtons
. ( Ibb12c ) - Added
WearableRemoteInputExtender
class that can be used for adding Wear-specific extras to the android.app.RemoteInput. ( I01903 )
Wear-Input 1.1.0
نسخه 1.1.0
18 آگوست 2021
androidx.wear:wear-input:1.1.0
and androidx.wear:wear-input-testing:1.1.0
are released. نسخه 1.1.0 حاوی این commit ها است.
تغییرات مهم از 1.0.0
- Added
RemoteInputIntentHelper
.- This class can be used to build a RemoteInput Intent. This can then be used to request input from your users in a customisable activity.
نسخه 1.1.0-rc01
4 آگوست 2021
androidx.wear:wear-input:1.1.0-rc01
and androidx.wear:wear-input-testing:1.1.0-rc01
are released. نسخه 1.1.0-rc01 حاوی این commit ها است.
No API Changes since androidx.wear:wear-input:1.1.0-beta01
and androidx.wear:wear-input-testing:1.1.0-beta01
نسخه 1.1.0-beta01
21 جولای 2021
androidx.wear:wear-input:1.1.0-beta01
and androidx.wear:wear-input-testing:1.1.0-beta01
are released with no changes since 1.1.0-alpha03
. نسخه 1.1.0-beta01 حاوی این تعهدات است.
نسخه 1.1.0-alpha03
30 ژوئن 2021
androidx.wear:wear-input:1.1.0-alpha03
and androidx.wear:wear-input-testing:1.1.0-alpha03
are released. نسخه 1.1.0-alpha03 حاوی این commit ها است.
رفع اشکال
- Fixed bug which caused RemoteInput intents, which had
RemoteInput
s added to them viaRemoteInputHelper.putRemoteInputsExtra
, to be rejected.
نسخه 1.1.0-alpha02
18 مه 2021
androidx.wear:wear-input:1.1.0-alpha02
and androidx.wear:wear-input-testing:1.1.0-alpha02
are released. نسخه 1.1.0-alpha02 حاوی این commit ها است.
تغییرات API
-
RemoteInputIntentHelper
's methods that are used for getting or putting extras that represent title, cancel, confirm, and in progress labels are now usingCharSequence
instead ofString
for these labels. ( I0e71f )
نسخه 1.1.0-alpha01
27 ژانویه 2021
androidx.wear:wear-input:1.1.0-alpha01
and androidx.wear:wear-input-testing:1.1.0-alpha01
are released. نسخه 1.1.0-alpha01 حاوی این commit ها است.
تغییرات API
- Migrate RemoteInputIntent class from Wearable Support Library to AndroidX. The migrated class is renamed as RemoteInputIntentHelper which provides helper functions for supporting remote inputs through starting an intent. ( I47cee )
Wear-Input 1.0.0
نسخه 1.0.0
2 دسامبر 2020
androidx.wear:wear-input:1.0.0
and androidx.wear:wear-input-testing:1.0.0
are released. نسخه 1.0.0 حاوی این commit ها است.
This release is identical to 1.0.0-rc01
.
ویژگی های اصلی 1.0.0
Migration of WearableButtons functionality from Wearable Support Library to Jetpack.
Added
androidx.wear.input.test.TestWearableButtonsProvider
which implementsandroidx.wear.input.WearableButtonsProvider
to aid testing applications developed withandroidx.wear:wear-input
library.
نسخه 1.0.0-rc01
11 نوامبر 2020
androidx.wear:wear-input:1.0.0-rc01
and androidx.wear:wear-input-testing:1.0.0-rc01
are released. نسخه 1.0.0-rc01 حاوی این commit ها است.
This release is identical to 1.0.0-beta01
.
نسخه 1.0.0-beta01
28 اکتبر 2020
androidx.wear:wear-input:1.0.0-beta01
and androidx.wear:wear-input-testing:1.0.0-beta01
are released with no changes since 1.1.0-alpha01
. نسخه 1.0.0-beta01 حاوی این تعهدات است.
Wear-Input-Testing Version 1.0.0-alpha01
14 اکتبر 2020
androidx.wear:wear-input-testing:1.0.0-alpha01
is released. نسخه 1.0.0-alpha01 شامل این تعهدات است.
تغییرات API
- Added
androidx.wear.input.test.TestWearableButtonsProvider
which implementsandroidx.wear.input.WearableButtonsProvider
to aid testing applications developed withandroidx.wear:wear-input
library. ( I0ed0c )
Wear-Input Version 1.0.0-alpha01
2 سپتامبر 2020
androidx.wear:wear-input:1.0.0-alpha01
is released. نسخه 1.0.0-alpha01 شامل این تعهدات است.
ویژگی های جدید
Migration of WearableButtons functionality from Wearable Support Library to Jetpack. Additional testing support will be provided in androidx.wear:wear-input-testing
library in the next Jetpack release.
نسخه 1.1.0
نسخه 1.1.0
14 اکتبر 2020
androidx.wear:wear:1.1.0
is released. نسخه 1.1.0 حاوی این commit ها است.
Major changes since 1.0.0
- Added a
layout_
prefix to boxedEdges attribute (nowlayout_BoxedEdges
) forBoxInsetLayout
in order to comply with android naming convention. This will remove the linter error in Android Studio for these attributes. ( I4272f ) - Added optional
EXTRA_ANIMATION_DURATION_MILLIS
toConfirmationActivity
to allow for the duration that the confirmation dialog is displayed. ( adb83ce , b/143356547 ) - Updated
WearableActionDrawView
to delay action drawer inflation until the drawer is opened for the first time. ( I01026 , b/163870541 )
نسخه 1.1.0-rc03
2 سپتامبر 2020
androidx.wear:wear:1.1.0-rc03
is released. نسخه 1.1.0-rc03 حاوی این commit ها است.
رفع اشکال
- Fixed issue with Action Drawer not showing content when it is opened. ( I01026 , b/163870541 )
Version 1.1.0-rc02
24 ژوئن 2020
androidx.wear:wear:1.1.0-rc02
is released. Version 1.1.0-rc02 contains these commits.
رفع اشکال
- Added a
layout_
prefix to boxedEdges attribute (nowlayout_boxedEdges
) forBoxInsetLayout
in order to comply with android naming convention. This will remove the linter error in Android Studio for these attributes.
نسخه 1.1.0-rc01
14 مه 2020
androidx.wear:wear:1.1.0-rc01
is released with no changes since .1.0-beta01
. نسخه 1.1.0-rc01 حاوی این commit ها است.
نسخه 1.1.0-beta01
29 آوریل 2020
androidx.wear:wear:1.1.0-beta01
is released with no changes since androidx.wear:wear:1.1.0-alpha01
. نسخه 1.3.0-beta01 حاوی این تعهدات است.
نسخه 1.1.0-alpha01
15 آوریل 2020
androidx.wear:wear:1.1.0-alpha01
is released. نسخه 1.1.0-alpha01 حاوی این commit ها است.
تغییرات API
- Added optional
EXTRA_ANIMATION_DURATION_MILLIS
toConfirmationActivity
to allow for the duration that the confirmation dialog is displayed. ( adb83ce , 134523c , b/143356547 )
رفع اشکال
- Updated
WearableActionDrawView
to delay action drawer inflation until the drawer is opened for the first time. ( 5cd32f7 )