بپوشید

بپوشید

نمونه کد راهنمای کاربر

مرجع API
androidx.wear.activity
androidx.wear.ambient
androidx.wear.input
androidx.wear.utils
androidx.wear.widget
androidx.wear.widget.drawer
( به refdocs برای همه بسته‌های پوشیدنی مراجعه کنید )

ایجاد برنامه‌های کاربردی برای ساعت‌های هوشمند Wear OS by Google.

این جدول تمام مصنوعات گروه androidx.wear را فهرست می کند.

مصنوع	انتشار پایدار	کاندید را آزاد کنید	نسخه بتا	انتشار آلفا
پوشیدن	1.3.0	-	-	1.4.0-alpha02
ورودی سایش	1.2.0	-	-	-
تست ورودی-سایشی	1.2.0	-	-	-
مستمر	1.1.0	-	-	-
پوشیدن-تلفن-تعاملات	1.1.0	-	-	-
سایش-کنش های راه دور	1.1.0	-	-	1.2.0-alpha01

آخرین به روز رسانی این کتابخانه در: 8 اکتبر 2025

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

برای افزودن وابستگی به 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.2.0"
    implementation "androidx.wear:wear-input-testing:1.2.0"

    // Use to implement wear ongoing activities
    implementation "androidx.wear:wear-ongoing:1.1.0"

    // Use to implement support for interactions from the Wearables to Phones
    implementation "androidx.wear:wear-phone-interactions:1.1.0"
    // Use to implement support for interactions between the Wearables and Phones
    implementation "androidx.wear:wear-remote-interactions:1.1.0"
}

کاتلین

dependencies {
    implementation("androidx.wear:wear:1.3.0")

    // Add support for wearable specific inputs
    implementation("androidx.wear:wear-input:1.2.0")
    implementation("androidx.wear:wear-input-testing:1.2.0")

    // Use to implement wear ongoing activities
    implementation("androidx.wear:wear-ongoing:1.1.0")

    // Use to implement support for interactions from the Wearables to Phones
    implementation("androidx.wear:wear-phone-interactions:1.1.0")
    // Use to implement support for interactions between the Wearables and Phones
    implementation("androidx.wear:wear-remote-interactions:1.1.0")
}

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

بازخورد

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

یک شماره جدید ایجاد کنید

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

Wear Core نسخه 1.0

نسخه 1.0.0-rc01

08 اکتبر 2025

androidx.wear:wear-core:1.0.0-rc01 بدون هیچ تغییری منتشر شد. نسخه 1.0.0-rc01 حاوی این commit ها است.

نسخه 1.0.0-beta02

10 سپتامبر 2025

androidx.wear:wear-core:1.0.0-beta02 منتشر شد. نسخه 1.0.0-beta02 حاوی این تعهدات است.

رفع اشکال

• هنگام بررسی APIهای جدیدتر از پرتاب WearApiVersionHelper به دستگاه های قدیمی جلوگیری کنید.

نسخه 1.0.0-beta01

30 جولای 2025

androidx.wear:wear-core:1.0.0-beta01 بدون هیچ تغییر قابل توجهی از آخرین آلفا منتشر شد. نسخه 1.0.0-beta01 حاوی این تعهدات است.

نسخه 1.0.0-alpha02

16 جولای 2025

androidx.wear:wear-core:1.0.0-alpha02 منتشر شد. نسخه 1.0.0-alpha02 حاوی این تعهدات است.

تغییرات API

• WearApiVersionHelper برای گنجاندن VIC/باقلوا ( I4676d ) به‌روزرسانی می‌کند

رفع اشکال

• این کتابخانه اکنون از حاشیه‌نویسی‌های پوچ JSpecify استفاده می‌کند که نوع استفاده هستند. توسعه دهندگان Kotlin باید از آرگومان های کامپایلر زیر برای اعمال استفاده صحیح استفاده کنند: -Xjspecify-annotations=strict ، -Xtype-enhancement-improvements-strict-mode ( Icbfb9 , b/326456246 )

نسخه 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-alpha02

16 جولای 2025

androidx.wear:wear:1.4.0-alpha02 منتشر شد. نسخه 1.4.0-alpha02 حاوی این تعهدات است.

رفع اشکال

• این کتابخانه اکنون از حاشیه‌نویسی‌های پوچ JSpecify استفاده می‌کند که نوع استفاده هستند. توسعه دهندگان Kotlin باید از آرگومان های کامپایلر زیر برای اعمال استفاده صحیح استفاده کنند: -Xjspecify-annotations=strict ، -Xtype-enhancement-improvements-strict-mode ( If4b1a ، b/326456246 )

نسخه 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-Remote-Interactions نسخه 1.2.0

نسخه 1.2.0-alpha01

2 ژوئیه 2025

androidx.wear:wear-remote-interactions:1.2.0-alpha01 منتشر شد. نسخه 1.2.0-alpha01 حاوی این commit ها است.

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

• RemoteActivityHelper.startRemoteActivity برای استفاده از یک API عمومی Wear SDK ( startRemoteActivity ) در صورت موجود بودن (از Wear 6 به بعد) به روز کرد. ( ID1e77 )

Wear Congoing & Interactions نسخه 1.1.0

نسخه 1.1.0

26 فوریه 2025

androidx.wear:wear-phone-interactions:1.1.0 منتشر شد. نسخه 1.1.0 حاوی این تعهدات است.

تغییرات مهم از 1.0.0

• این نسخه شامل رفع اشکال حیاتی برای برنامه‌هایی است که روی Wear OS 5 (سطح API 34) یا بالاتر اجرا می‌شوند و سطح API 35 یا بالاتر را هدف قرار می‌دهند.
• برنامه‌ها باید قبل از به‌روزرسانی targetSdkVersion خود به ۳۵ یا بالاتر، به این نسخه از کتابخانه به‌روزرسانی شوند.
• در غیر این صورت، استثنا در زمان اجرا پرتاب می شود.
• تعریف جدیدی برای نوع دستگاه جفت شده - none ، هنگامی که دستگاه با تلفن جفت نشده است، اضافه شده است.

نسخه 1.1.0-rc01

12 فوریه 2025

androidx.wear:wear-phone-interactions:1.1.0-rc01 بدون هیچ تغییر قابل توجهی از آخرین نسخه بتا منتشر شده است. نسخه 1.1.0-rc01 حاوی این commit ها است.

نسخه 1.1.0-beta01

29 ژانویه 2025

androidx.wear:wear-phone-interactions:1.1.0-beta01 منتشر شد. نسخه 1.1.0-beta01 حاوی این تعهدات است.

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

نسخه 1.1.0-beta01 Wear Phone Interactions نشان می‌دهد که این نسخه از کتابخانه کامل شده است و API قفل شده است (به جز مواردی که به عنوان آزمایشی علامت‌گذاری شده‌اند). Wear Phone Interactions 1.1 شامل عملکردها و APIهای جدید زیر است:

• ویژگی redirectUrl به OAuthRequest اضافه شد.
• رفع اسناد
• نوع اضافی در PhoneTypeHelper برای تعیین زمانی که دستگاه با تلفن جفت نشده است، به جای استفاده از نوع ناشناخته موجود.

تغییرات API

• تعریف جدیدی برای نوع دستگاه جفت شده اضافه شد - هیچ، وقتی دستگاه با تلفن جفت نشده باشد. ( I06cb8 )

نسخه 1.1.0-alpha05

11 دسامبر 2024

androidx.wear:wear-phone-interactions:1.1.0-alpha05 منتشر شد. نسخه 1.1.0-alpha05 حاوی این تعهدات است.

رفع اشکال

• هنگام اجرا بر روی Wear OS 5 (سطح API 34) یا بالاتر در حالی که سطح API 35 یا بالاتر را هدف قرار می دهید، یک اشکال خرابی را برطرف کنید. برنامه‌ها باید قبل از به‌روزرسانی targetSdkVersion خود به ۳۵ یا بالاتر، به این نسخه از کتابخانه به‌روزرسانی شوند.

نسخه 1.1.0

11 دسامبر 2024

androidx.wear:wear-remote-interactions:1.1.0 منتشر شد. نسخه 1.1.0 حاوی این تعهدات است.

تغییرات مهم از 1.0.0

• ما RemoteActivityHelper.isRemoteActivityHelperAvailable را اضافه کرده‌ایم که به بررسی اینکه آیا عملکرد راه‌اندازی یک فعالیت راه دور در دسترس است یا خیر کمک می‌کند. ( I107a9 )

نسخه 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

• ویژگی redirectUrl به OAuthRequest اضافه شد. ( I98840 , Ie684d )

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

10 سپتامبر 2025

androidx.wear:wear-ongoing:1.1.0 منتشر شد. نسخه 1.1.0 حاوی این تعهدات است.

تغییرات مهم از 1.0.0:

• فیلد توضیحات محتوا را به فعالیت‌های در حال انجام اضافه کرد که توسط سرویس‌های دسترس‌پذیری استفاده می‌شود.
• حاشیه نویسی RequiresPermission به APIهایی اضافه شد که به مجوز POST_NOTIFICATIONS در SDK 33 و بالاتر نیاز دارند.

نسخه 1.1.0-rc01

27 آگوست 2025

androidx.wear:wear-ongoing:1.1.0-rc01 بدون هیچ تغییری از آخرین نسخه بتا منتشر شده است. نسخه 1.1.0-rc01 حاوی این commit ها است.

نسخه 1.1.0-beta01

30 جولای 2025

androidx.wear:wear-ongoing:1.1.0-beta01 بدون هیچ تغییر قابل توجهی از آخرین آلفا منتشر شد. نسخه 1.1.0-beta01 حاوی این تعهدات است.

نسخه 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-alpha23 ، کتابخانه های watchface و complications به یک گروه androidx.wear.watchface یکپارچه منتقل شده اند. لطفاً برای جزئیات بیشتر به صفحه یادداشت انتشار Wear Watchface مراجعه کنید.

نسخه 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 )
• We have added CanvasRenderer.uiThreadInit which is called once on the UiThread before any calls to render. Also for clarity in GlesRenderer we have renamed onGlContextCreated to onBackgroundThreadGlContextCreated , and onGlSurfaceCreated to onUiThreadGlSurfaceCreated . ( If86d0 )
• HeadlessWatchFaceClient & InteractiveWatchFaceClient getComplicationsSlotState has been renamed to getComplicationSlotsState . In ComplicationSlot : createRoundRectComplicationBuilder , createBackgroundComplicationBuilder , and createEdgeComplicationBuilder have been renamed to createRoundRectComplicationSlotBuilder , createBackgroundComplicationSlotBuilder , and createEdgeComplicationSlotBuilder respectively. ( Ib9adc )
• We have added onRendererCreated to CanvasComplication which makes it easier for Renderer and CanvasComplication to share state. ( I5e1ac )

Version 1.0.0-alpha16

16 ژوئن 2021

androidx.wear:wear-*:1.0.0-alpha16 is released. Version 1.0.0-alpha16 contains these commits.

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

• We've fixed a number of bugs related to the recent threading model changes as well as addressing other issues with the on watch face editor.

رفع اشکال

• Prevent NPE in onComplicationProviderChooserResult ( b/189594557 )
• Fix issues with stale surfaces and drawBlack ( b/189452267 )
• Fix race in accessing complicationsManager.watchState ( b/189457893 )
• Fix background thread lifetime bug ( b/189445428 )
• Fix Pre-R Watch face Editor issues ( b/189126313 )
• Don't update direct boot params for editor style changes ( b/187177307 )

Version 1.0.0-alpha15

2 ژوئن 2021

androidx.wear:wear-*:1.0.0-alpha15 is released. Version 1.0.0-alpha15 contains these commits.

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

The majority of watch face initialization is now done on a background thread, however after loading all watch face rendering etc is done on the UiThread. There is a memory barrier between loading and rendering so most user watch faces don't need to do anything special. Watch faces using GLES may be an exception since the context is thread specific and we create two linked contexts so it's possible to upload GL resources (eg textures and shaders) on the background thread and use them on the UiThread.

We have split the construction of watchfaces into three functions: createUserStyleSchema, createComplicationsManager and createWatchFace. We assume that createUserStyleSchema and createComplicationsManager are fast and createWatchFace may take some time to load assets. Taking advantage of this we have introduced WatchFaceControlClient.getDefaultProviderPoliciesAndType which returns a map of Complication Ids to DefaultComplicationProviderPolicies and the default ComplicationType. This is faster than creating a headless instance since it doesn't need to fully initialize the watch face to perform the query.

Finally complications are now constructed with a CanvasComplicationFactory which allows for lazy construction of the CanvasComplication renderers.

تغییرات API

• Replaced @TargetApi with @RequiresApi . ( I0184a , b/187447093 , b/187447094 )
• We have introduced WatchFaceControlClient.getDefaultProviderPoliciesAndType which returns a map of Complication Ids to DefaultComplicationProviderPolicies and the default ComplicationType. Where possible a fast path is used that avoids fully constructing a watch face. To facilitate this the WatchFaceService API has had to change with two new methods being: createUserStyleSchema and createComplicationsManager the results of which are passed into createWatchFace. In addition Complications are now constructed with a CanvasComplicationFactory which allows for lazy construction of the CanvasComplication renderers. ( Iad6c1 )
• We have removed MOST_RECENT_APP from SystemProviders. ( I3df00 )
• ObservableWatchData is now a sealed class. ( Ic940d )
• CanvasComplicationFactory.create (which is typically io bound) is now called on a background thread for each complication before ui thread rendering commences. There is a memory barrier between construction and rendering so no special threading primitives are required. ( Ia18f2 )
• Watchface construction is now done on a background thread although all rendering is done on the ui thread, GlesRenderer supports two linked contexts to support this. WatchFaceControlClient.createHeadlessWatchFaceClient and WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient may resolve before WatchFaceService.createWatchFace has completed. Subsequent API calls will block until watchFace initialization has completed. ( Id9f41 )
• EXPANSION_DP and STROKE_WIDTH_DP are no longer visible in api.txt. ( I54801 )
• We have made EditorSession.createOnWatchEditingSession throw TimeoutCancellationException if there's an error instead of sending a null session. Additionally, the return value of EditorRequest.createFromIntent and EditorSession.createOnWatchEditingSession is now NonNull. ( I41eb4 )

Version 1.0.0-alpha14

18 مه 2021

androidx.wear:wear-*:1.0.0-alpha14 is released. Version 1.0.0-alpha14 contains these commits.

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

• EditorSession.openComplicationProviderChooser now returns ChosenComplicationProvider which contains the complication id, ComplicationProviderInfo and a Bundle containing any additional extras returned by the provider chooser.
• In addition we have been steadily migrating code to Kotlin and the majority of the watch face API is now defined in Kotlin.

تغییرات API

• GlesRenderer properties eglContext and eglDisplay are now non-nullable. Any GL errors are now reported via GlesRenderer.GlesException rather than via RuntimeExceptions. ( Ib1005 )
• We have migrated androidx.wear.watchface.complications.rendering.ComplicationDrawable from Java to Kotlin ( Ibc3eb )
• We have migrated androidx.wear.watchface.complications.rendering.ComplicationStyle from Java to Kotlin ( I3375e )
• We added information about the complication provider for each complication within EditorSession. ( I37f14 )
• We extended the result of EditorSession.openComplicationProviderChooser to include information returned by the chosen. ( Iead6d )

Wear Complications & Watchface Version 1.0.0-alpha13

5 مه 2021

androidx.wear:wear-*:1.0.0-alpha13 is released. Version 1.0.0-alpha13 contains these commits.

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

• Watch faces can have important visual elements beyond showing the time and complications. To provide screen reader support for this, watchface can now specify accessibility ContentDescriptionLabels via the Renderer's additionalContentDescriptionLabels property. In addition, to control the ordering of ContentDescriptionLabels accessibilityTraversalIndex has been added to complications. This can be modified by a ComplicationsUserStyleSetting.

• To encourage developers to carefully consider screen readers we have made ShortTextComplicationData.Builder 's, LongTextComplicationData.Builder 's and RangedValueComplicationData.Builder 's contentDescription field mandatory to be passed into their constructors. If ComplicationText.EMPTY is passed in for the contentDescription , a contentDescription will be automatically generated from the text and title.

• WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient now throws ServiceStartFailureException if the watchface throws an exception during init, this makes it much easier to diagnose issues during watch face startup.

تغییرات API

• We added support for having a null component name in ComplicationProviderInfo, which is needed to support older versions of Wear OS. ( I744d2 )
• We have migrated androidx.wear.complications.SystemProviders from Java to Kotlin. ( Ia1f8b )
• We have hidden all classes from public API that are in android.support.wearable.complications and created corresponding wrappers in AndroidX where needed. ( I7bd50 )
• We have renamed method in TimeDifferenceComplicationText.Builder from setMinimumUnit to setMinimalTimeUnit . ( I20c64 )
• We have made ShortTextComplicationData.Builder 's, LongTextComplicationData.Builder 's and RangedValueComplicationData.Builder 's contentDescription field mandatory to be passed in constructor. ( I8cb69 )
• We have renamed ComplicationProviderService.onComplicationUpdate to onComplicationRequest and encapsulated id and type parameter of this method into data ComplicationRequest. Corresponding listener has been renamed to ComplicationRequestListener and its method ComplicationRequestListener.onComplicationData. ( Iaf146 )
• We have removed method isActiveAt from ComplicationData and exposed field validTimeRange instead of it. This method call can be replaced with validTimeRange.contains . ( I65936 )
• We have changed description of the method ComplicationProviderService.onComplicationActivated to receive a ComplicationType instead of an int. ( Idb5ff )
• Migrated ProviderUpdateRequester from Java to Koltin. ( Ibce13 )
• GlesRender.makeContextCurrent is now public. Watch face code may need to make gl calls outside of render and onGlContextCreated and because there may be both an interactive and a headless context its necessary to call this. ( I8a43c )
• WatchFaceControlClient.getOrCreateInteractiveWatchFaceClient now throws ServiceStartFailureException if the watchface throws during init. In addition WatchFaceService now throws an exception if createWatchFace takes longer than 6 seconds. ( I59b2f )
• We have removed the unused id property of GlesTextureComplication . ( I28958 )
• The watchface can now specify accessibility ContentDescriptionLabels via the Renderer 's additionalContentDescriptionLabels property. In addition to controlling the ordering of ContentDescriptionLabels accessibilityTraversalIndex has been added to complications. This can be modified by a ComplicationsUserStyleSetting. ( Ib7362 )
• Expand documentation about touch event handling in the watch face. ( Iaf31e )

رفع اشکال

• EditorSession.getComplicationsPreviewData() now returns a map for every rather only non-empty complications. An instance of EmptyComplicationData is used for empty complications. ( I1ef7e )

Wear Complications & Watchface Version 1.0.0-alpha12

21 آوریل 2021

androidx.wear:wear-*:1.0.0-alpha12 is released. Version 1.0.0-alpha12 contains these commits.

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

Watch face editors need to highlight parts of the watch face to help convery which aspect of a watch is being configured. We've extended RenderParameters to allow styles as well as complications to be highlighted. There's a new optional HighlightLayer which is intended to be matted on top of the watch face with alpha transparency (the screenshot apis can do this matting for you, or provide the HighlightLayer on its own for maximum flexibility). Eg suppose you had a style that lets you configure the appearance of the watch hands, your renderer in its renderHighlightLayer can draw an outline around them.

To encourage Complication Provider support for accessibility we have made PhotoImageComplicationData.Builder's, MonochromaticImageComplicationData.Builder's and SmallImageComplicationData.Builder's contentDescription field to be a mandatory constructor argument. ComplicationTapFilter and Complication.createEdgeComplicationBuilder have been added to support edge complications (drawn around the edge of the screen). Rendering and hit testing of edge complications is left up to the watch face. Edge hit testing isn't supported from the companion editor.

تغییرات API

• Added PROVIDER_ prefix to constants in SystemProviders. ( I1e773 )
• We have made PhotoImageComplicationData.Builder 's, MonochromaticImageComplicationData.Builder 's and SmallImageComplicationData.Builder 's contentDescription field mandatory to be passed in constructor. ( I9643a )
• ProviderInfoRetriever.requestPreviewComplicationData has been renamed to retrievePreviewComplicationData . ( I911ee )
• Migrated ComplicationProviderService from Java to Koltin. ( I849f2 )
• Method ComplicationProviderService.onBind is now final ( I39af5 )
• We've reinstated interface CanvasComplication and moved CanvasComplicaitonDrawable , GlesTextureComplication and ComplicationHighlightRenderer to wear-watchface-complications-rendering . ( I84670 )
• RenderParameters has been refactored to support extended highlight rendering. It's now possible to request rendering of highlights for styles as well as all or a single complication. In addition CanvasRenderer and GlesRenderer how have a new abstract renderHighlightLayer method for rendering any highlighting requested by the editor. Layer has been renamed to WatchFaceLayer. ( Ic2444 )
• ComplicationTapFilter and Complication.createEdgeComplicationBuilder have been added to support edge complications. Rendering and hit testing of edge complications is left up to the watch face. Hit testing isn't supported from within editors. ( Ia6604 )
• For DoubleRangeUserStyleSetting & LongRangeUserStyleSetting : defaultValue , maximumValue and minimumValue are now kotlin properties. In addition, UserStyleSetting.Option functions like toBooleanOption, toCoplicationOptions, toListOption and similar have been removed. ( I52899 )
• Add chin size to the properties of the device available to the watch face. ( I76e1e )
• ComplicationHighlightRenderer 's constructor now accepts outlineExpansion and outlineStrokeWidth parameters. ( I87009 )
• ComplicationDrawable.getNoDataText is now part of the public API. ( I00598 )

نسخه 1.0.0-alpha11

7 آوریل 2021

androidx.wear:wear-*:1.0.0-alpha11 is released. Version 1.0.0-alpha11 contains these commits.

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

• More polish has been applied to the watch face APIs. Most of the changes are simple renamings but InteractiveWatchFaceWcsClient and InteractiveWatchFaceSysUiClient have been merged into InteractiveWatchFaceClient .

تغییرات API

• ContentDescriptionLabel.text is now a ComplicationText rather than the old wearable support library TimeDependentText. ( I80c03 )
• SystemProviders.GOOGLE_PAY is not guaranteed to be present on all Android R devices so it has been removed from the list. It's still possible to use this provider via DefaultComplicationProviderPolicy ( If01b5 )
• We've renamed ComplicationUpdateCallback to ComplicationUpdateListener for consistency. ( I61ec7 )
• The UserStyle wire format map has been changed to Map<String, byte[]> and for convenience a UserStyleData class has been added to the public API and is now used by wear-watchface-client and wear-watchface-editor. In addition CustomValueUserStyleSetting.CustomValueOption.value is now byte[] instead of String . ( Iaa103 )
• UserStyleSetting and UserStyleSetting.Option now use UserStyleSetting.Id and UserStyleSetting.Option.Id respectively to store their ids rather than a String. ( I63f72 )
• InteractiveWatchFaceClient.SystemState has been renamed to WatchUiState . ( I6a4e0 )
• InteractiveWatchFaceWcsClient and InteractiveWatchFaceSysUiClient have been merged because it was hard to explain the division of responsibility ( Iff3fa )
• Layer enum values have been renamed for clarity. Layer#TOP_LAYER is now Layer#COMPLICATIONS_OVERLAY and Layer#BASE_LAYER is now Layer#BASE ( Ia144e )
• UserStyleListener has been renamed to UserStyleChangeListener ( I18524 )
• UserStyleRepository has been renamed to CurrentUserStyleRepository ( I6ea53 )
• InteractiveWatchFaceWcsClient.updateInstance has been renamed to updateWatchfaceInstance . ( I321dc )
• WatchFace TapType events have been renamed to align with MotionEvents / Compose. ( I0dfd0 )
• takeWatchfaceScreenshot has been renamed to renderWatchFaceToBitmap, and takeComplicationScreenshot has been renamed to renderComplicationToBitmap ( Ie0697 )
• The CanvasComplication interface has been removed in favor of the open class CanvasComplicationDrawable. ( I1f81f )
• WatcfaceControlServiceFactory has been removed from the public api. ( I1f8d3 )
• We've renamed CanvasComplication.setData to CanvasComplication.loadData . ( If1239 )
• ComplicationsManager.bringAttentionToComplication has been renamed to displayPressedAnimation . ( Ic4297 )
• WatchFaceService.createWatchFace now has an @UiThread annotation. ( Ib54c2 )
• Changed the name of a CanvasComplicationDrawable parameter to fix a bug. ( I50dac )
• We've added HeadlessWatchFaceClient.toBundle() and HeadlessWatchFaceClient.createFromBundle to support sending HeadlessWatchFaceClient over AIDL. ( I07c35 )
• HeadlessWatchFaceClient and InteractiveWatchFaceClient now have ClientDisconnectListener and isConnectionAlive() to allow you to observe if the connection is broken for some reason (eg the watchface being killed). ( Ie446d )
• WatchFaceControlClient#getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClientAsync is now a suspend function and has been renamed to getOrCreateInteractiveWatchFaceClient . ( Ib745d )
• EditorState.commitChanges and hasCommitChanges() has been renamed to shouldCommitChanges() . ( I06e04 )
• previewComplicationData has been renamed to previewComplicationsData to indicate theres (usually) more than one complication in the map. ( I56c06 )
• InteractiveWatchFaceWcsClient.bringAttentionToComplication has been renamed to displayPressedAnimation for consistency with ComplicationsManager.displayPressedAnimation . ( Ic9999 )
• All instances of watchface instance id have been encapsulated in a new WatchFaceId class ( I45fdf )
• complicationState property has been renamed to complicationsState to indicate plurality. ( Ided07 )
• We've removed the various wear-watchface-client Binder conversions, they should be necessary. ( Icc4c0 )
• For consistency EditorServiceClient has been refactored to use listeners instead of observers. ( Iec3a4 )
• We've added a couple of missing @Px annotations to InteractiveWatchFaceSysUiClient and WatchFaceControlClient . ( I3277a )
• Renamed EditorObserverCallback to EditorObserverListener for consistency. ( Ie572d )
• EditorState.watchFaceInstanceId is restricted to Android R API level and above and is no longer nullable. ( Id52bb )
• EditorSession.launchComplicationProviderChooser has been renamed to openComplicationProviderChooser . ( I9d441 )
• EditorSession.createOnWatchEditingSessionAsync has been renamed to createOnWatchEditingSession and is now a suspend function. ( Id257b )
• Added several missing @UiThread annotations on EditorSession . ( I6935c )
• UserStyleSetting.affectsLayers has been renamed to affectedLayers . ( I6e22b )

نسخه 1.0.0-alpha10

24 مارس 2021

androidx.wear:wear-*:1.0.0-alpha10 is released. Version 1.0.0-alpha10 contains these commits.

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

• It's now possible to create open gl objects (eg textures) during WatchFaceService.createWatchFace because GlesRenderer now requires an explicit call to initOpenGLContext which can be done inside createWatchFace.

تغییرات API

• IdAndComplicationData was a bit awkward and has been removed from the public API. Classes & interfaces that used it have been refactored. ( I4c928 )
• We've replaced ReferenceTime with CountUpTimeReference and CountDownTimeReference which are more self explanatory. ( Ib66c6 )
• Added some missing @Px and @ColorInt annotations. ( I9bbc3 )
• Complication.complicationConfigExtras is now non-nullable and defaults to Bundle.EMPTY . ( Iad04f )
• GlesRenderer now requires you to call initOpenGLContext after construction. This function was an internal detail but is now on the public API to allow GL calls earlier inside createWatchFace. ( I726c2 )
• We've removed Complication.setRenderer as it should not be needed. ( Ie992f )
• Complicaiton.setComplicationBounds is no longer part of the public API. If you need to adjust the position of a complication, this can be done via ComplicationsUserStyleSetting . ( Ibd9e5 )
• ComplicationsManager.TapCallback.onComplicationSingleTapped has been renamed to onComplicationTapped . ( I3a55c )
• ComplicationOutlineRenderer.drawComplicationSelectOutline has been renamed to drawComplicationOutline . ( I14b88 )

نسخه 1.0.0-alpha09

10 مارس 2021

androidx.wear:wear-complications-*:1.0.0-alpha09 and androidx.wear:wear-watchface-*:1.0.0-alpha09 are released. Version 1.0.0-alpha09 contains these commits.

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

• The interface between WCS/SysUI host and the on watch face has evolved. It's now possible for an editor to determine if a style change will enable or disable a complication (enabled = initiallyEnabled plus any override from ComplicationsUserStyleSetting). Also EditorService.closeEditor allows SysUI to remotely close an on watch face editor if needed.
• In addition InteractiveWatchFaceWcsClient.setUserStyle with a more powerful command updateInstance which: changes the instance ID, sets the style, and clears complications all in one go.

تغییرات API

• TraceEvents have been added to the watchface libraries. ( I1a141 )
• ComplicationState now has a new property initiallyEnabled which is useful for predicting the consequences of switching styles. ( I8c905 )
• We've replaced InteractiveWatchFaceWcsClient.setUserStyle with a more powerful command updateInstance which: changes the instance ID, sets the style, and clears complications. ( Ife6f6 )
• WatchFaceClient screenshot APIs no longer compress the screenshots because that was slow, instead we leave any post processing up to the caller. ( Id35af )
• It's now possible to remotely close an on watchface editor via EditorService.closeEditor . ( Ic5aa4 )
• Added nullability annotations ( Ic16ed )

نسخه 1.0.0-alpha08

24 فوریه 2021

androidx.wear:wear-*:1.0.0-alpha08 is released. Version 1.0.0-alpha08 contains these commits.

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

• Some watch faces are designed around one or more specific complications, to support this we've added Complication.Builder#setFixedComplicationProvider which if set to true prevents the user from changing the complication in that slot.
• The watchface libraries are Kotlin first and use coroutines (eg suspend functions). For Java users we've provided ListenableFuture wrappers to improve interoperability in the following libraries: wear/wear-watchface-guava, wear/wear-watchface-client-guava & wear/wear-watchface-editor-guava.

تغییرات API

• We've removed support for double taps on complications launching the provider chooser, this feature wasn't common in watchfaces and complicated the implementation of SysUI. ( I3ef24 )
• ProviderInfoRetriever methods may throw ServiceDisconnectedException if the binder closes unexpectedly. ( Ib2cc4 )
• From Android 11 onwards, there are restrictions on when the ProviderChooser can be run, in addition we'd like editors to be built with the new wear-watchface-editor so ComplicationHelperActivity is being removed from the public API. ( Ib19c1 )
• Remove ComplicationText static methods in favor of builders. ( Ibe399 )
• We have introduced guava ListenableFuture wrappers for the various watch face library suspended methods. ( I16b2c )
• For API clarity we've added a secondary constructor to RenderParameters which doesn't require a tint, for use with LayerModes other than LayerMode.DRAW_OUTLINED . ( I497ea )
• Previously ListUserStyleSetting was different from the other because it had a default argument. Now all the StyleSetting subclass constructors take the default value last. ( I9dbfd )
• CanvasComplication has been refactored to use have a hidden method, which makes it easier to implement a subclass ( I5b321 )
• We have refactored away EditorResult in favor of a new EditorService and EditorSession.broadcastState() to stream updates to an observer (typically SysUI). ( Ic4370 )
• Some watchfaces are built around a particular complication as an integral part of the watch face where the provider is not user configurable. To support this we've added Complication.Builder#setFixedComplicationProvider . ( I4509e )
• EditorRequest now specifies package name rather than ComponentName because it was inconvenient for SysUI to look up the class name of the editor, and we only really need the package name. ( Ib6814 )

نسخه 1.0.0-alpha07

10 فوریه 2021

androidx.wear:wear-*:1.0.0-alpha07 is released. Version 1.0.0-alpha07 contains these commits.

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

• WatchFaceService.createWatchFace is now a suspend function which means the watchface no longer has to block the ui thread while waiting for IO. Similarly wear-watchface-editor and wear-complications-data

تغییرات API

• Remove PhotoImage class and use Icon directly. ( I8a70b )
• Expose the validTimeRange of ComplicationData. ( I91366 )
• Make image-like attributes more explicit. ( I81700 )
• wear-watchface-editor and wear-complications-data have been refactored to use suspend functions instead of coroutines. Rx java & Future compat wrappers to follow. ( If3c5f )
• ProviderInfoRetriever now now throws PreviewNotAvailableException if requestPreviewComplicationData can't return preview data due to connection issues or lack of API support. ( I4964d )
• WatchFaceControlService::createWatchFaceControlClient is now a suspended fuction and getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient is now called getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClientAsync returning Deferred<InteractiveWatchFaceWcsClient> . RX java and Future compat wrappers to follow. ( I5d461 )
• Rename CATEGORY_PROVIDER_CONFIG_ACTION to CATEGORY_PROVIDER_CONFIG . ( I7c068 )
• Please note createOnWatchEditingSession is now a suspended function because the watchface sometimes isn't available until shortly after the editor activity has started. ( Ida9aa )
• WatchFaceService.createWatchFace is now a suspend function which allows for async initialization, previously you would have had to block the main thread. ( If076a )
• UserStyle now has an array operator and we've added casting helpers to UserStyle.Option. ( I35036 )
• We've fixed a marshalling bug with UserStyle wireformats changing some of the unstable hidden API. ( I8be09 )
• We've added CustomValueUserStyleSetting which lets you store a single application specific string within a UserStyle. The default watch face editors will ignore this value. ( Ic04d2 )
• InstanceID is not passed in the intent extras for R and older versions of Android WearOS which we can't upgrade. To support this we now allow InstancID to be null. ( Id8b78 )
• EditorRequest now includes the editor ComponentName which is set as the component in WatchFaceEditorContract.createIntent ( I3cd06 )
• The watchface EditorResult now includes preview ComplicationData to allow the caller to take a screenshot of the watchface after editing. ( I2c561 )

رفع اشکال

• Added toString() overrides to UserStyle, UserStyleSetting and UserStyleSchema which makes working with these classes a bit nicer. ( I9f5ec )

Version 1.0.0-alpha06

27 ژانویه 2021

androidx.wear:wear-*:1.0.0-alpha06 is released. Version 1.0.0-alpha06 contains these commits.

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

• We've introduced a new library wear/wear-watchface-editor which allows watch face developers and potentially OEMs to build a style and complication editor. SysUI will send an Intent to the watch face which will use the new EditorSession class to access WatchFace details and record the result via Activity.setWatchRequestResult. To support this we've added ProviderInfoRetriever.requestPreviewComplicationData which allows watch face editors to request preview ComplicationData. The advantage of preview ComplicationData is unlike live data you don't have to worry about showing permission dialogs when rendering your editor (note if a user selects a provider with a permission they will still be prompted to grant the permission).

تغییرات API

• ComplicationProviderInfo now has a field for the provider's ComponentName, support for this field will be added to WearOS at a later date and in the meantime, it will be null. ( Id8fc4 )
• We've added ProviderInfoRetriever.requestPreviewComplicationData which allows watch face editors to request preview ComplicationData. This is useful because live complications may require permissions and you can now display preview data for complications that are not active. ( I2e1df )
• ComplicationManager is now an optional parameter of WatchFace constructor and the arguments have been reordered to allow this. ( I66c76 )
• We've added an optional Bundle to Complications which if set gets merged in with the intent sent to launch the provider chooser activity. ( Ifd4ad )
• We've added a new wear-watchface-editor library to support on watch face and SysUi hosted editors. SysUI will launch these editors by sending an intent. The watch face activity service can use the new EditorSession class to access WatchFace details and record the result via Activity.setWatchRequestResult. ( I2110d )
• LayerMode.DRAW_HIGHLIGHTED is now called LayerMode.DRAW_OUTLINED and RenderParameters.highlightComplicationId is now called RenderParameters.selectedComplicationId which draws a highlight on the specified complication in addition to an outline. ( I90a40 )
• WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient's future can now resolve with a ServiceStartFailureException if the service dies while waiting for the watchface to be created. ( I0f509 )
• EditorSession.complicationPreviewData is now a ListenableFuture because fetching this data is an asynchronous process. ( Iead9d )

رفع اشکال

• We're removing unused fields from ComplicationOverlay leaving enabled and complicationBounds. ( I17b71 )

Version 1.0.0-alpha05

13 ژانویه 2021

androidx.wear:wear-*:1.0.0-alpha05 is released. Version 1.0.0-alpha05 contains these commits.

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

Watchfaces often support a number of complication configurations with varying numbers of complications shown. To make this easier to set up we now support initially disabled complications by calling setEnabled(false) on the builder. These can be enabled later via ComplicationsUserStyleSetting.

تغییرات API

• ComplicationHelperActivity now accepts Collection<ComplicationType> rather than an int array making it easier to use. ( I1f13d )
• ProviderInfoRetriever.retrieveProviderInfo now correctly returns ListenableFuture<ProviderInfo[]> . ( If2710 )
• You can now create an initially disabled complication by calling setEnabled(false) on the builder. ( Idaa53 )
• WatchFaceState now has an isHeadless property which is only true for headless instances. ( Ifa900 )
• ComplicationDrawable now optionally supports synchronous loading of drawables. This is used by the screenshot APIs. ( I34d4a )

نسخه 1.0.0-alpha04

16 دسامبر 2020

androidx.wear:wear-*:1.0.0-alpha04 is released. نسخه 1.0.0-alpha04 حاوی این commit ها است.

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

• The wear watch face library now supports setting bounds per type. Eg you can switch to a wide bounding box for ComplicationType.LONG_TEXT whilst using a smaller bounding box for other types.

تغییرات API

• Complications now use ComplicationBounds which wraps a Map<ComplicationType, RectF> to support per complication type sizes. ( I1ebe7 )
• RenderParameters now lets you specify the highlight tint for use in screen shots. ( Iff42b )
• With the exception of bounds you now have to use ComplicationsUserStyleSetting to modify complications, this is to ensure the OS is kept in sync. ( I8dc5d )
• Renderer is now a sealed class. This means CanvasRenderer and GlesRenderer are now inner classes of Renderer. ( Iab5d4 , b/173803230 )
• CanvasComplicationDrawable.drawHighlight renamed to drawOutline. ObservableWatchData now has a few missing UiThread annotations. ScreenState has now been fully removed from WatchState. ( If1393 )
• The minimum API level for wear-watchface is now 25. Note hardware canvas support requires API level 26 or above. ( Ic9bbd )
• InteractiveWatchFaceWcsClient now has a getComplicationIdAt helper. ( I05811 )
• The API level for wear-watchface-client has been reduced to 25, however the screen shot APIs require API level 27. ( Id31c2 )

رفع اشکال

• We now expose the complication's current ComplicationData's ComplicationType in ComplicationState. ( I9b390 )
• InteractiveWatchFaceWcs now has a method `bringAttentionToComplication to briefly highlight the specified complication. ( I6d31c )
• InteractiveWatchFaceWcsClient#setUserStyle now has an overload accepting Map which can potentially avoid an extra IPC round trip necessary to construct UserStyle. ( I24eec )

نسخه 1.0.0-alpha03

2 دسامبر 2020

androidx.wear:wear-*:1.0.0-alpha03 is released. نسخه 1.0.0-alpha03 حاوی این commit ها است.

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

The Complication class now has a compicationData property letting watch faces observe ComplicationData changes. This makes it possible to change the complication's dimensions based on the type of the complication.

Variable frame rates are now supported by assigning to Renderer.interactiveDrawModeUpdateDelayMillis. For watch faces which run short animations every second this can lead to good power savings by going to sleep when not animating.

تغییرات API

• BACKGROUND_IMAGE has been renamed to PHOTO_IMAGE along with related classes. This type of complication is not exclusively used for backgrounds hence the name change. ( I995c6 )
• DefaultComplicationProviderPolicy properly annotated with IntDefs. ( I3b431 )
• The hidden TimeDependentText class is no longer exposed via ContentDescriptionLabel, instead we add an accessor to get the text at a specified time. ( Ica692 )
• ObservableWatchData's constructor is now internal. ( I30121 , b/173802666 )
• Complication now has compicationData letting watch faces observe ComplicationData changes. Complication also has a new isActiveAt call which can be used to tell if anything should be rendered at the provided datetime. ( Ic0e2a )
• The empty SharedMemoryImage is no longer in the public API. ( I7ee17 )
• WatchFace.overridePreviewReferenceTimeMillis now has an IntRange annotation and the getter and setter have consistent names. ( Ia5f78 )
• Complication.Builder is now created via Complication.createRoundRectComplicationBuilder or Complication.createBackgroundComplicationBuilder for clarity ( I54063 )
• Added WatchFace.TapListener which allows taps not consumed by complications to be observed by the WatchFace. ( Ic2fe1 , b/172721168 )
• WatchFace now supports variable frame rates by assigning to Renderer.interactiveDrawModeUpdateDelayMillis . This can help preserve battery life by sleeping when not animating. ( I707c9 )
• WatchFace.Builder is no longer needed and invalidate() and interactiveUpdateRateMillis have been moved to Renderer. ( I329ea )
• For better java interoperability renamed getters for boolean properties in WatchState ( I6d2f1 )
• Renamed TapListener to TapCallback and InvalidateCallback to InvalidateListener for consistency. ( I9414e )
• Wear 2.0 watchface style options have been moved to their own class for clarity. WatchFace.Builder setters now have symmetrical WatchFace class getters. ( Iefdfc )
• Added InteractiveWatchFaceWcsClient and WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient which either gets an existing instance or creates it once the wallaper service has connected and made the engine. ( Id666e )
• WatchFaceControlClient is now an interface to allow tests to mock it. ( I875d9 )
• HeadlessWatchFaceClient, InteractiveWatchFaceSysUiClientImpl, InteractiveWatchFaceWcsClient are now interfaces to better facilitate testing. ( I7cdc3 )
• Added annotations to methods in wear-watchface-complications-rendering ( I0d65c )

رفع اشکال

• Remove screen shape from DeviceConfig, which was duplicating android.content.res.Configuration#isScreenRound() ( Ifadf4 )
• Changed WatchFaceControlClient.getOrCreateWallpaperServiceBackedInteractiveWatchFaceWcsClient to accept a Map<String, String> instead of UserStyle because it's hard to create a UserStyle without knowing the schema which you can only get after the client has been created. ( Iea02a )
• Fix InteractiveWatchFaceWcsClient to use ComplicationState instead of the wire format. ( Icb8a4 )
• UserStyleSettings is now a sealed class because the watch face editors only understand the built in classes. ( I2d797 )

نسخه 1.0.0-alpha02

11 نوامبر 2020

androidx.wear:wear-*:1.0.0-alpha02 is released. نسخه 1.0.0-alpha02 حاوی این commit ها است.

تغییرات API

• ComplicationDetails is now called ComplicationState and is properly wrapped and usages of wearable support @ComplicationData.ComplicationType have been migrated to androidx ComplicationType . ( I4dd36 )
• Add an optional highlightedComplicationId parameter to RenderParameters which allows you to request highlighting of a single complication in screenshots. ( I66ce9 )
• ComplicationProviderService to use new style complication api for consistency ( Id5aea )
• getPreviewReferenceTimeMillis now gets reference times from DeviceConfig . ( I779fe )
• Simplifying Renderer API surface, can use SurfaceHolder.Callback to observe changes instead. ( I210db )
• CanvasComplicationRenderer doesn't extend from Renderer , 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 to StyleSetting 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 حاوی این commit ها است.

تغییرات 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 برای MissingGetterMatchingBuilder برای 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. Version 1.2.0 contains these commits.

Important changes since 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 in androidx.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. Version 1.2.0-rc01 contains these commits.

نسخه 1.2.0-beta01

18 آگوست 2021

androidx.wear:wear:1.2.0-beta01 is released. Version 1.2.0-beta01 contains these commits.

رفع اشکال

• 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 to WearTypeHelper.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 in androidx.wear.utils for determining whether the given wear device is for China. ( Ib01a9 )

نسخه 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 )

نسخه 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 )

نسخه 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 to TextView 's), to set the text typeface and bold/italics style. ( I4653c )
• Renamed WearArcLayout to ArcLayout , WearCurvedText to CurvedText and WearArcLayout.ArcLayoutWidget to ArcLayout.Widget . ( I6e5ce )
  • On ArcLayout.Widget , renamed getThicknessPx into getThickness .
  • Vertical alignment constants on ArcLayout.LayoutParams are now named starting with VERTICAL_ALIGN_ (instead of the previous VALIGN_ )
• On CurvedTextView , the methods setMinSweepDegrees and setMaxSweepDegrees were replaced by setSweepRangeDegrees ( I7a9d9 )

نسخه 1.2.0-alpha08

5 مه 2021

androidx.wear:wear:1.2.0-alpha08 is released. Version 1.2.0-alpha08 contains these commits.

تغییرات API

• To improve code clarity, we added @FloatRange annotations to some angle parameters and return types. ( I430dd )
• In the interface WearArcLayout.ArcLayoutWidget , the method insideClickArea is now called isPointInsideClickArea. ( Ia7307 )

نسخه 1.2.0-alpha07

24 مارس 2021

androidx.wear:wear:1.2.0-alpha07 is released. Version 1.2.0-alpha07 contains these commits.

رفع اشکال

• 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. Version 1.2.0-alpha06 contains these commits.

تغییرات 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. Version 1.2.0-alpha05 contains these commits.

رفع اشکال

• 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. Version 1.2.0-alpha04 contains these commits.

تغییرات 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 )
• 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 (was WearArcLayout.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. Version 1.2.0-alpha03 contains these commits.

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

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. Version 1.2.0-alpha02 contains these commits.

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. Version 1.2.0-alpha01 contains these commits.

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

• 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

10 سپتامبر 2025

androidx.wear:wear-input:1.2.0 and androidx.wear:wear-input-testing:1.2.0 are released. نسخه 1.2.0 شامل این commit ها است.

Important changes since 1.1.0:

• Exposed physical button location constants.
• Added WearableRemoteInputExtender for setting Wear-specific extras on android.app.RemoteInput (for example, enabling Emoji input)

نسخه 1.2.0-rc01

27 آگوست 2025

androidx.wear:wear-input:1.2.0-rc01 and androidx.wear:wear-input-testing:1.2.0-rc01 are released with no changes since the last beta. نسخه 1.2.0-rc01 حاوی این commit ها است.

نسخه 1.2.0-beta01

30 جولای 2025

androidx.wear:wear-input:1.2.0-beta01 and androidx.wear:wear-input-testing:1.2.0-beta01 are released with no notable changes since the last alphas. نسخه 1.2.0-beta01 حاوی این تعهدات است.

نسخه 1.2.0-alpha04

16 جولای 2025

androidx.wear:wear-input:1.2.0-alpha04 and androidx.wear:wear-input-testing:1.2.0-alpha04 are released. نسخه 1.2.0-alpha04 حاوی این commit ها است.

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

• Account for screen rotation when calculating the location of physical buttons relative to the screen. ( 87a57e )

تغییرات API

• Rename LOC * to LOCATION * in wear-input. ( I5e879 )

رفع اشکال

• این کتابخانه اکنون از حاشیه‌نویسی‌های پوچ JSpecify استفاده می‌کند که نوع استفاده هستند. Kotlin developers should use the following compiler arguments to enforce correct usage: -Xjspecify-annotations=strict , -Xtype-enhancement-improvements-strict-mode ( Icbfb9 , b/326456246 )

نسخه 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. Version 1.2.0-alpha02 contains these commits.

تغییرات API

• Renamed disallowEmoji to setEmojisAllowed in WearableRemoteInputExtender 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. Version 1.2.0-alpha01 contains these commits.

تغییرات 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. Version 1.1.0 contains these commits.

تغییرات مهم از 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. Version 1.1.0-rc01 contains these commits.

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 . Version 1.1.0-beta01 contains these commits.

نسخه 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. Version 1.1.0-alpha03 contains these commits.

رفع اشکال

• Fixed bug which caused RemoteInput intents, which had RemoteInput s added to them via RemoteInputHelper.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. Version 1.1.0-alpha02 contains these commits.

تغییرات API

• RemoteInputIntentHelper 's methods that are used for getting or putting extras that represent title, cancel, confirm, and in progress labels are now using CharSequence instead of String 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. Version 1.1.0-alpha01 contains these commits.

تغییرات 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. Version 1.0.0 contains these commits.

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 implements androidx.wear.input.WearableButtonsProvider to aid testing applications developed with androidx.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. Version 1.0.0-rc01 contains these commits.

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 حاوی این commit ها است.

تغییرات API

• Added androidx.wear.input.test.TestWearableButtonsProvider which implements androidx.wear.input.WearableButtonsProvider to aid testing applications developed with androidx.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 حاوی این commit ها است.

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

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. Version 1.1.0 contains these commits.

تغییرات عمده از 1.0.0

• Added a layout_ prefix to boxedEdges attribute (now layout_BoxedEdges ) for BoxInsetLayout 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 to ConfirmationActivity 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 )

Version 1.1.0-rc03

2 سپتامبر 2020

androidx.wear:wear:1.1.0-rc03 is released. Version 1.1.0-rc03 contains these commits.

رفع اشکال

• 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 (now layout_boxedEdges ) for BoxInsetLayout 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 . Version 1.1.0-rc01 contains these commits.

نسخه 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. Version 1.1.0-alpha01 contains these commits.

تغییرات API

• Added optional EXTRA_ANIMATION_DURATION_MILLIS to ConfirmationActivity 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 )