یادداشت‌های انتشار سیستم عامل را بپوشید

این صفحه حاوی اطلاعاتی درباره نسخه‌های Wear OS است، مانند Wearable SDK و Wearable Support Library.

2024-نوامبر-21 SDK پوشیدنی 19.0.0

SDK پوشیدنی نسخه 19.0.0 شامل به‌روزرسانی‌های جزئی SDK است. به روز رسانی ها عبارتند از:

• وابستگی های کتابخانه به آخرین نسخه ها به روز شد.
• یک نوع API sendMessage() پشتیبانی نشده که شامل یک پارامتر MessageOptions بود را حذف کرد.

2023-اگوست-31 SDK پوشیدنی 18.1.0

Wearable SDK نسخه 18.1.0 شامل به‌روزرسانی‌های API جزئی برای پشتیبانی از نسخه بعدی کتابخانه پشتیبانی پوشیدنی است. به روز رسانی ها عبارتند از:

• پشتیبانی از تعویض تلفن، برای جزئیات بیشتر به NodeClient.OnNodeMigratedListener مراجعه کنید.
• اسناد اضافی برای ارسال و پاسخ پیام‌های MessageClient .
• پیوندهای به روز شده در توضیحات API.

2022-سپتامبر-20 SDK پوشیدنی 18.0.0

Wearable SDK نسخه 18.0.0 شامل به‌روزرسانی‌های API جزئی برای پشتیبانی از نسخه بعدی کتابخانه پشتیبانی پوشیدنی است. به روز رسانی ها عبارتند از:

• پشتیبانی WearableListenerService برای برنامه‌هایی که Android 13 را هدف قرار می‌دهند — شماره 235538840 .
• متد MessageClient.sendRequest() جدید.

کتابخانه پشتیبانی پوشیدنی 2022-February-16 نسخه 2.9.0

نسخه 2.9.0 کتابخانه پشتیبانی پوشیدنی همه کلاس‌های باقی‌مانده را منسوخ می‌کند. به جای آن از کتابخانه های Wear OS Jetpack استفاده کنید.

کتابخانه Wear OS Jetpack 2021-October-29

کتابخانه‌های Wear OS Jetpack جایگزینی برای کتابخانه‌های پشتیبانی پوشیدنی هستند و برای استفاده با هم طراحی نشده‌اند. کتابخانه پشتیبانی پوشیدنی در Wear OS 3 کار نمی کند.

2021-آوریل-27 SDK پوشیدنی 17.1.0

Wearable SDK نسخه 17.1.0 شامل به‌روزرسانی‌های جزئی API برای پشتیبانی از نسخه بعدی کتابخانه پشتیبانی پوشیدنی است.

کتابخانه پشتیبانی پوشیدنی 2020-سپتامبر-28 نسخه 2.8.1

نسخه 2.8.1 کتابخانه پشتیبانی پوشیدنی شامل تغییرات زیر است.

اجازه غیرفعال کردن Jetifier هنگام استفاده از قالب Watch Face را بدهید

قالب Android Studio Watch Face اکنون از وابستگی‌های AndroidX برای غیرفعال کردن Jetifier استفاده می‌کند. این اصلاحات هنگام استفاده از قالب Watch Face با Android Studio نسخه ۴.۲ یا بالاتر اعمال می‌شود.

کتابخانه پشتیبانی پوشیدنی 2020-سپتامبر-24 نسخه 2.8.0

نسخه 2.8.0 کتابخانه پشتیبانی پوشیدنی شامل تغییرات زیر است.

قابلیت بازگشت به عقب برای تعیین ارائه دهندگان عارضه غیر سیستمی پیش فرض

واچ‌فیس‌ها اکنون می‌توانند از setDefaultComplicationProviderWithFallbacks برای تعیین یک یا چند ارائه‌دهنده پیچیدگی غیرسیستم به‌طور پیش‌فرض استفاده کنند. اگر هیچ یک از ارائه دهندگان غیر سیستمی مشخص شده نصب نشده باشند، سیستم به استفاده از ارائه دهنده سیستم پیش فرض برمی گردد.

WearableActivity منسوخ شد

WearableActivity منسوخ شده است. به جای آن از AmbientModeSupport استفاده کنید.

SKIP_CONFIRMATION_UI منسوخ شده است

ActionConfirmationActivity.SKIP_CONFIRMATION_UI منسوخ شده است. این اضافی از زمان انتشار Wear 2.0 استفاده نشده است.

کتابخانه پشتیبانی پوشیدنی 2020-مه-15 نسخه 2.7.0

نسخه 2.7.0 کتابخانه پشتیبانی پوشیدنی شامل ویژگی زیر است.

شتاب سخت افزاری برای صفحه های ساعت

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

برای اطلاعات بیشتر، به بهبود عملکرد صفحه ساعت با شتاب سخت افزاری مراجعه کنید.

کتابخانه پشتیبانی پوشیدنی 2020-آوریل-21 نسخه 2.6.0

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

مهاجرت به Android Jetpack

کتابخانه پشتیبانی پوشیدنی به Android Jetpack منتقل شده است. کتابخانه‌های موجود اکنون با استفاده از فضای نام androidx در AndroidX نقشه‌برداری شده و قابل دسترسی هستند و همه وابستگی‌ها به کتابخانه پشتیبانی منسوخ حذف شده‌اند.

این تغییر همچنین به شما امکان می‌دهد از کتابخانه‌های Wearable Support در Android Studio نسخه ۴.۰ و بالاتر استفاده کنید که مشکلاتی مانند مشکل #147972079 را حل می‌کند.

کتابخانه پشتیبانی پوشیدنی 2019-August-28 نسخه 2.5.0

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

رفع ComplicationDrawable هنگامی که startActivity() با نوع عارضه TYPE_NO_PERMISSION فراخوانی شود

ComplicationDrawable اکنون شامل یک پرچم NEW_TASK است که تضمین می کند که فراخوانی های startActivity() که از WatchFaceService سرچشمه می گیرند شامل FLAG_ACTIVITY_NEW_TASK برای جلوگیری از android.util.AndroidRuntimeException باشد.

این تغییر به نوع پیچیدگی TYPE_NO_PERMISSION اجازه می‌دهد به‌جای خراب کردن صفحه ساعت، فعالیت درخواست مجوز را به درستی راه‌اندازی کند.

2018-September-25 Wearable SDK 16.0.0

Wearable SDK نسخه 16.0.0 نسخه مورد نیاز خدمات Google Play را از نسخه 12.4 به نسخه 8.6 کاهش می دهد. این تغییر به برنامه‌های موجود اجازه می‌دهد بدون نیاز به به‌روزرسانی APK خدمات Google Play، به آخرین نسخه Wearable SDK به‌روزرسانی شوند.

به‌روزرسانی 2018-ژوئن-11 برای Wear OS Developer Preview 2

به‌روزرسانی‌های هوایی اخیر در Wear OS Developer Preview 2 هشدارها و مشاغل را برای برنامه‌های پس‌زمینه دوباره فعال کرده است.

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

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

پیش‌نمایش برنامه‌نویس Wear OS 2018-My-8 2

Wear OS Developer Preview 2 دارای ویژگی هایی مانند تجربه بهبود یافته دستیار Google است.

با استفاده از ردیاب Wear OS by Google هرگونه اشکال یا بازخوردی را ارسال کنید. هرچه زودتر آنها را ارسال کنید، احتمال اینکه اصلاحات در نسخه نهایی گنجانده شود بیشتر است.

مسائل شناخته شده

این بخش شامل مشکلات شناخته شده برای نسخه پیش نمایش 2 است.

مشکلات مربوط به تصویر Wear OS

• وقتی در هر برنامه‌ای هستید و دکمه پاور را در کنار ساعت فشار می‌دهید، ممکن است به جای صفحه ساعت، به صفحه قبلی بازگردید.

مشکلات مربوط به تصویر Wear OS for China

• وقتی در هر برنامه‌ای هستید و دکمه پاور را در کنار ساعت فشار می‌دهید، ممکن است به جای صفحه ساعت، به صفحه قبلی بازگردید.
• تنظیمات صدای مربوط به میزان صدا ادامه ندارند. به عنوان مثال، یک تماس دریافتی منجر به زنگ های شنیداری در ساعت می شود، حتی اگر صدای ساعت روی ساعت خاموش باشد. و اگر صدای زنگ هشدار را تنظیم کنید، تغییر تاثیری ندارد.
• ممکن است چند اعلان در حال انجام به درستی نمایش داده نشود. به عنوان مثال، اگر هر دو تایمر و کرونومتر تنظیم شده باشند، اعلان ها نمایش داده نمی شوند. توصیه می کنیم برنامه خود را با یک اعلان در حال انجام آزمایش کنید تا با بیش از یک اعلان.
• فروشگاه اپلیکیشن Wear در نسخه چینی کار نمی کند. برنامه‌نویسان نمی‌توانند برنامه‌های جدید را با استفاده از آن کانال به‌روزرسانی یا نصب کنند. توصیه می کنیم از adb به عنوان یک راه حل برای بارگذاری جانبی برنامه خود برای آزمایش استفاده کنید.

مسائل مربوط به شبیه ساز Wear

• تماس تلفنی ورودی به تلفن همراه به عنوان تماس ورودی در شبیه‌ساز جفت شده نشان داده نمی‌شود، یا _mirrored_ است.
• وقتی از مدیر SDK برای نصب یا تأیید اینکه آخرین نصب Android P یا نسخه چین را دارید استفاده می‌کنید، کادرهای تأیید کنار آن انتخاب‌ها می‌توانند پس از انتخاب آنها از حالت انتخاب خارج شوند. اگر انتخاب نشدند، برای بار دوم آنها را انتخاب کنید.
• هنگامی که شبیه ساز یک بوت سرد انجام می دهد، ممکن است خطای زیر نمایش داده شود: "یک مشکل داخلی در دستگاه شما وجود دارد. برای جزئیات با سازنده تماس بگیرید." این بر عملکرد تأثیر نمی گذارد. به پایین اسکرول کنید و روی OK کلیک کنید تا آزمایش برنامه شما آغاز شود.
• پاسخ صوتی ممکن است در شبیه ساز کار نکند. به عنوان مثال، اگر اعلان پیام Google Hangouts را در شبیه‌ساز Wear دریافت کنید و سعی کنید به آن پیام به صورت صوتی پاسخ دهید، پیام خطای «Google همچنان متوقف می‌شود» رخ می‌دهد و از پاسخ صوتی شما جلوگیری می‌شود.
• Instant Run ممکن است با شبیه ساز Wear ناسازگار باشد.
• گرفتن اسکرین شات به صورت برنامه ریزی شده، مانند استفاده از «adb» یا گرفتن گزارش اشکال، ممکن است کارساز نباشد. به عنوان یک راه حل، روی دکمه دوربین در نوار ابزار شبیه ساز کلیک کنید تا یک اسکرین شات بگیرید.

مشکلات نسخه چینی شبیه ساز Wear

• تماس تلفنی ورودی به تلفن همراه ممکن است به عنوان تماس ورودی در شبیه‌ساز جفت‌شده نشان داده نشود، یا _mirrored_ شود. بر این اساس، اعلان تماس های از دست رفته ممکن است در شبیه ساز نشان داده نشود. علاوه بر این، ممکن است نتوانید به تماسی از شبیه ساز پاسخ دهید، در این صورت تماس همچنان به زنگ می زند.
• وقتی از مدیر SDK برای نصب یا تأیید اینکه آخرین نصب Android P یا نسخه چین را دارید استفاده می‌کنید، کادرهای تأیید کنار آن انتخاب‌ها می‌توانند پس از انتخاب آنها از حالت انتخاب خارج شوند. اگر انتخاب نشدند، برای بار دوم آنها را انتخاب کنید.
• هنگامی که شبیه ساز بوت سرد را انجام می دهد، ممکن است خطای زیر نمایش داده شود: "یک مشکل داخلی در دستگاه شما وجود دارد. برای جزئیات با سازنده تماس بگیرید." این بر عملکرد تأثیر نمی گذارد. به پایین اسکرول کنید و روی OK کلیک کنید تا آزمایش برنامه شما آغاز شود.
• Instant Run ممکن است با شبیه ساز Wear ناسازگار باشد.
• گرفتن اسکرین شات به صورت برنامه ریزی شده، مانند استفاده از «adb» یا گرفتن گزارش اشکال، ممکن است کارساز نباشد. به عنوان یک راه حل، روی دکمه دوربین در نوار ابزار شبیه ساز کلیک کنید تا یک اسکرین شات بگیرید.

Google Assistant on Wear

پشتیبانی پیشرفته از Assistant on Wear OS به شما این امکان را می‌دهد تا بدون نوشتن کد اندروید یک تجربه پوشیدنی آماده بسازید. به طور خاص، می‌توانید برای پلتفرم Actions on Google بسازید و به کاربران خود کمک کنید تا کارها را با محصولات و خدمات شما انجام دهند.

علاوه بر این، Wear OS اکنون از تعاملات سریع‌تر با صدا و لمس پشتیبانی می‌کند. تراشه های پیشنهادی نیز پشتیبانی می شوند. آنها کارهای زیر را انجام می دهند:

• به کاربران کمک کنید تا تعاملات خود را سریع انجام دهند
• در مورد قابلیت Action خود به کاربران نکاتی ارائه دهید

علاوه بر این، Wear OS اکنون از کارت های بصری بیشتر و همچنین لیست ها و چرخ فلک ها پشتیبانی می کند.

بنابراین، می‌توانید از DialogFlow ، الگوها یا Actions SDK برای ایجاد Actions در Google برای Wear OS استفاده کنید. شما همچنین می توانید از الگوهای پاسخ جدید که مختص ساعت هستند استفاده کنید. بهترین روش‌ها برای Actions on Google عبارتند از:

• گفتگوی کوتاه و مختصر
• فعال کردن بازخورد بصری و صوتی

این پیشرفت‌ها برای Assistant on Wear OS به Android P وابسته نیستند و برای همه کاربران Wear 2.0 عرضه می‌شوند. برای آشنایی با ساخت Actions در Google، به ادغام با Google Assistant مراجعه کنید.

صرفه جویی در باتری در پیش نمایش برنامه نویس 2

همانطور که در بخش زیر توضیح داده شد، ویژگی های مرتبط با انرژی برای افزایش عمر باتری در دسترس هستند. اطلاعات این بخش پیش‌نمایش برنامه‌نویس 2 جایگزین اطلاعات مربوط به قدرت برای پیش‌نمایش برنامه‌نویس 1 می‌شود.

حالت جدید: بهینه‌سازی باتری پیشرفته

در حالی که یک ساعت در حالت صرفه جویی باتری بهبود یافته است، یک صفحه ساعت پیش فرض با بهینه سازی انرژی نمایش داده می شود. همه موارد زیر خاموش است:

• رادیوها
• صفحه نمایش لمسی
• ویژگی tilt-to-wake

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

فعالیت پس زمینه محدود

برای بهبود مدیریت انرژی، برنامه‌های موجود در پس‌زمینه دیگر نمی‌توانند آلارم‌ها و کارها را شروع کنند، مگر اینکه ساعت روی شارژر باشد. استثناها شامل چهره های ساعت و عوارض فعال است.

توجه : اگر برنامه شما باید همیشه اجرا شود، مثلاً برای نظارت پس‌زمینه، توصیه می‌کنیم با استفاده از روش startForegroundService() از یک سرویس پیش‌زمینه استفاده کنید. برای جزئیات بیشتر به محدودیت های سرویس پس زمینه مراجعه کنید. استفاده از خدمات پیش زمینه برای موارد استفاده استثنایی مانند نظارت بر سلامت مناسب است.

سازگاری برنامه بهبود یافته

برای بهبود سازگاری برنامه، Android P شروع به اجرای محدودیت‌های خاصی در استفاده از رابط‌های غیر SDK کرده است. برای مهاجرت از روش ها و زمینه های غیر SDK برنامه ریزی کنید. اگر هیچ معادل عمومی برای مورد استفاده شما در دسترس نیست، به ما اطلاع دهید .

تم سیستم رابط کاربری تاریک

از ابتدای سال ۲۰۱۸، Wear OS به یک تم پیش‌فرض رابط کاربری تغییر کرده است که پس‌زمینه تیره‌تری برای جریان اعلان‌ها و راه‌انداز سیستم دارد. این تغییر برای بهبود قابلیت نگاه کردن به برنامه های شما در نظر گرفته شده است. دسترسی برنامه خود را با این موضوع رابط کاربری جدید بررسی کنید.

کدهای به روز شده در دسترس هستند

برای کمک به کشف راه‌های مهم توسعه با Wear OS، کدهای به‌روزرسانی شده در دسترس هستند. به عنوان مثال، برای آزمایش با زبان اختصاصی دامنه Kotlin یا DSL، آزمایشگاه جدید صورت ساعت مبتنی بر Kotlin را امتحان کنید.

پیش‌نمایش برنامه‌نویس 2018-مارس-27 Wear OS 1

این بخش حاوی اطلاعاتی درباره پیش‌نمایش برنامه‌نویس 1 Wear OS by Google است. پیش‌بینی می‌شود که چندین به‌روزرسانی برای این پیش‌نمایش قبل از انتشار نهایی تولید شود. با استفاده از ردیاب Wear OS by Google هر اشکالی را که پیدا کردید ارسال کنید. هرچه زودتر آنها را ارسال کنید، احتمال اینکه بتوانیم اصلاحات را در نسخه نهایی اضافه کنیم بیشتر است.

مسائل شناخته شده

• در برنامه همراه Wear OS، به نظر می رسد که روی گزارش اشکال پوشیدنی ضربه بزنید، اما هیچ گزارش اشکالی در واقع ایجاد نمی شود. از adb bugreport به عنوان راه حل استفاده کنید.
• پذیرش تماس تلفنی با استفاده از ساعت همیشه موفق نیست. اگر موفق نشد، کاربر باید تماس را مستقیماً از طریق تلفن بپذیرد.
• گاهی اوقات پس از جفت شدن یا راه اندازی یک برنامه از پیش بارگذاری شده، خطای «مشکلات شناسایی شده با سازگاری API» ظاهر می شود. آن پیغام خطا پس از مدت کوتاهی ناپدید می شود و بر قابلیت استفاده تأثیری نمی گذارد.
• در منوی تنظیمات ساعت و شبیه ساز، گزینه Take bug report دو بار نمایش داده می شود. برای گزارش اشکال، سعی کنید از هر یک از دو گزینه استفاده کنید، زیرا تنها یکی از آنها کاربردی است. وقتی روی گزینه عملکردی ضربه می زنید، یک نان تست نمایش داده می شود که نشان می دهد یک گزارش اشکال در حال ایجاد است.
• در نسخه چینی، ورودی صوتی باعث از کار افتادن برنامه می شود. به عنوان مثال، با جستجوی صوتی یا زمانی که از صدا برای افزودن یادآوری استفاده می‌کنید، این اتفاق می‌افتد زیرا این عملکرد از APIهای ورودی صوتی استفاده می‌کند. برای آزمایش، از ورودی صفحه کلید یا دست خط به جای ورودی صوتی استفاده کنید.
• فروشگاه اپلیکیشن Wear در نسخه چینی کار نمی کند. برنامه‌نویسان نمی‌توانند برنامه‌های جدید را با استفاده از آن کانال به‌روزرسانی یا نصب کنند. توصیه می کنیم از adb به عنوان یک راه حل برای بارگذاری جانبی برنامه خود برای آزمایش استفاده کنید.

نکات برجسته در این پیش نمایش توسعه دهنده

Developer Preview 1 شامل ویژگی های زیر برای آزمایش برنامه است:

• فعالیت در پس‌زمینه محدود: برای بهبود مدیریت انرژی، برنامه‌های موجود در پس‌زمینه دیگر نمی‌توانند از زنگ هشدار و کار استفاده کنند. استثناها شامل صفحه های ساعت و عوارضی است که کاربر انتخاب کرده است. این ویژگی به تدریج در پیش‌نمایش‌های توسعه‌دهندگان عرضه می‌شود، بنابراین ممکن است بلافاصله آن را در ساعت خود مشاهده نکنید.

  توجه: اگر برنامه شما همیشه باید اجرا شود، آن را تغییر دهید تا با استفاده از متد startForegroundService() به یک سرویس پیش زمینه تبدیل شود. برای جزئیات بیشتر به محدودیت های خدمات پس زمینه مراجعه کنید.

• محدودیت‌های استفاده برنامه‌ها از رابط‌های غیر SDK: برای بهبود سازگاری برنامه‌ها، Android P شروع به اجرای محدودیت‌های خاصی در استفاده از رابط‌های غیر SDK کرده است. برای مهاجرت از روش ها و زمینه های غیر SDK برنامه ریزی کنید. اگر هیچ معادل عمومی برای مورد استفاده شما در دسترس نیست، به ما اطلاع دهید .
• طرح زمینه سیستم رابط کاربری تاریک: از ابتدای سال 2018، Wear OS به یک تم پیش‌فرض رابط کاربری تغییر کرده است که پس‌زمینه تیره‌تری برای جریان اعلان‌ها و راه‌انداز سیستم دارد. این تغییر برای بهبود قابلیت نگاه کردن به برنامه های شما در نظر گرفته شده است. دسترسی برنامه خود را با این موضوع رابط کاربری جدید بررسی کنید.
• وقتی ساعت خاموش است رادیوها خاموش هستند : برای بهبود مدیریت انرژی، رادیو بلوتوث، رادیو Wi-Fi و رادیو سلولی وقتی ساعت برای مدت طولانی غیرفعال از بدنه تشخیص داده شود، خاموش هستند. این ویژگی به‌تدریج در پیش‌نمایش‌های برنامه‌نویس عرضه می‌شود، بنابراین ممکن است در ابتدا آن را در ساعت خود مشاهده نکنید. اگر این ویژگی باعث ایجاد چالش در فرآیند توسعه شما می شود، می توانید با استفاده از «adb» با استفاده از دستور زیر، ویژگی را غیرفعال کنید:
  adb shell settings put global off_body_radios_off_for_small_battery_enabled 0
• وقتی بلوتوث قطع می‌شود وای‌فای خاموش است: برای بهبود مدیریت انرژی، وقتی ساعت از بلوتوث قطع می‌شود، ساعت دیگر به‌طور خودکار به Wi-Fi متصل نمی‌شود. موارد استثنا شامل مورد اپلیکیشنی است که درخواست شبکه با پهنای باند بالا دارد و مورد ساعت متصل به شارژر. این ویژگی به‌تدریج در پیش‌نمایش‌های برنامه‌نویس عرضه می‌شود، بنابراین ممکن است در ابتدا آن را در ساعت خود مشاهده نکنید.

به‌روزرسانی‌های کتابخانه پشتیبانی پوشیدنی، نسخه 2.3.0

به‌روزرسانی اسناد نسخه 2.3.0 برای کتابخانه پشتیبانی پوشیدنی شامل به‌روزرسانی‌های تغییر نام تجاری است.

علاوه بر این، نسخه 2.3.0 کتابخانه شامل به روز رسانی های مربوط به ComplicationDrawable و TextRenderer برای متنی است که دارای اشیاء نشانه گذاری متصل به محدوده های متنی است. این کلاس ها مدیریت متون پوشانده را بهبود بخشیده اند. فقط زیرمجموعه خاصی از دهانه ها را می توان رندر کرد—به روش setText برای انواع دهانه هایی که می توان رسم کرد مراجعه کنید—بنابراین دهانه ها هنگام رندر شدن در صفحه ساعت نامرتب به نظر نرسند.

2018-مارس-15 Rebrand of Wear

این بخش حاوی اطلاعاتی درباره ویژگی‌های Wear OS است.

نام جدید برای Android Wear

Android Wear توسط Google به Wear OS تغییر نام داده است.

به روز رسانی حالت محیطی 2018-27 فوریه

این بخش حاوی اطلاعاتی درباره ویژگی‌های جدید Android Wear است.

کلاس جدید برای پشتیبانی از حالت محیطی

نسخه 27.1.0 کتابخانه پشتیبانی Android شامل یک کلاس جدید AmbientModeSupport است که جایگزین کلاس منسوخ شده AmbientMode می شود. به روز رسانی نمونه ها در هفته های آینده برنامه ریزی شده است.

شبیه ساز نهایی 2018-Jan-25 و بیشتر

این بخش حاوی اطلاعاتی درباره ویژگی‌های جدید Android Wear است.

شبیه ساز اندروید: به روز رسانی برای Wear

به‌روزرسانی نهایی مربوط به Wear برای شبیه‌ساز اندروید برای آزمایش برنامه‌های مبتنی بر API نسخه 26 در دسترس است.

پیشرفت‌ها در کتابخانه پشتیبانی پوشیدنی، نسخه 2.2.0

نسخه 2.2.0 کتابخانه پشتیبانی پوشیدنی شامل به‌روزرسانی‌هایی است که در زیر توضیح داده شده است.

نشانگر اعلان خوانده نشده جدید

از آنجایی که کاربران می‌خواهند از اعلان‌های خوانده نشده آگاه شوند، یک نشانگر جدید ارائه شده است: یک نقطه دایره‌ای در پایین صفحه ساعت. اگر ترجیح می‌دهید اعلان‌ها را خودتان مدیریت کنید، می‌توانید از setHideNotificationIndicator برای پنهان کردن نشانگر پیش‌فرض و نمایش خود یا setShowUnreadCountIndicator برای نمایش تعداد اعلان‌ها در نوار وضعیت استفاده کنید.

رنگ حلقه بیرونی نشانگر اعلان خوانده نشده را با روش setAccentColor سفارشی کنید.

توجه: نشانگر اعلان‌های خوانده نشده در نسخه تولیدی Wear 2.8.0 فعال نیست. در عوض پیاده سازی خود را با استفاده از آخرین شبیه ساز Wear آزمایش کنید. با شروع نسخه بعدی Wear (نسخه 2.9.0)، نشانگر اعلان های خوانده نشده به طور پیش فرض نمایش داده می شود.

بهبودهای کلاس ComplicationDrawable

کلاس ComplicationDrawable یک درخواست مجوز برای یک صفحه ساعت شروع می‌کند که وقتی سیستم مقدار TYPE_NO_PERMISSION را نشان می‌دهد، روی آن ضربه زده می‌شود، که نشان می‌دهد صفحه ساعت فاقد مجوز برای دریافت داده‌های پیچیده است.

علاوه بر این، کلاس ComplicationDrawable زمانی که بارگذاری تصاویر به پایان می رسد یا زمانی که برجسته شدن ضربه به پایان می رسد، خود را باطل می کند. برای پاسخ به این عدم اعتبار - مانند ترسیم مجدد صفحه ساعت - یک Drawable.Callback اضافه کنید.

مسائل شناخته شده

• اگر حالت تئاتر را در شبیه ساز فعال کنید، همانطور که در تغییر تنظیمات صفحه و روشنایی توضیح داده شده است، شبیه ساز می تواند در حالت تئاتر گیر کند. رفع مشکل نیاز به پاک کردن داده های شبیه ساز دارد. اجرا و توقف شبیه ساز و پاک کردن داده ها را ببینید.
• در پنجره یک شبیه ساز برای سطح API 25 یا 26، دکمه پاور کار نمی کند. به جای آن از دکمه های دیگری به جز دکمه پاور استفاده کنید. به طور خاص، برای جابه‌جایی به حالت محیطی - برای مثال، به‌عنوان اینکه کاربر صفحه را با کف دست خود پوشانده است - از دکمه پاور در نوار ابزار شبیه‌ساز در سمت راست نمایشگر استفاده کنید. برای شروع راه‌انداز برنامه در حالت تعاملی، از دکمه Home در نوار ابزار شبیه‌ساز استفاده کنید.
• در نسخه چینی شبیه ساز، اگر از روش ورودی دست خط استفاده کنید، صفحه می تواند شروع به چشمک زدن کند. سپس، وقتی روی دکمه صفحه‌کلید روی صفحه کلیک می‌کنید، صفحه‌کلید نیمی از صفحه را مسدود می‌کند.

2017-Dec-18 دسترسی جدید به خدمات Google Play

این بخش حاوی اطلاعاتی درباره ویژگی‌های جدید Android Wear است.

از کلاس GoogleApiClient مهاجرت کنید

با شروع نسخه 11.8.0 سرویس‌های Google Play، برنامه‌های Wear خود را از کلاس GoogleApiClient منتقل کنید و در عوض از اشیاء کلاینت API استفاده کنید که بر اساس کلاس GoogleApi و Tasks API هستند.

توجه: این به‌روزرسانی برای برنامه‌های Android Wear برای چین که معمولاً از نسخه 10.2.0 سرویس‌های Google Play استفاده می‌کنند، اعمال نمی‌شود.

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

• انتقال برنامه‌های Wear به GoogleApi
• دسترسی به APIهای Google
• Wearable class documentation

اجزای جدید برای اتصال با سرویس های Google Play

وقتی از کلاس‌هایی استفاده می‌کنید که کلاس GoogleApi را گسترش می‌دهند، مانند DataClient و MessageClient ، SDK خدمات Google Play اتصالات به خدمات Google Play را برای شما مدیریت می‌کند. برنامه هایی که از این کلاس ها استفاده می کنند دیگر نیازی به ایجاد و مدیریت اشیاء GoogleApiClient ندارند. برای اطلاعات بیشتر به پست وبلاگ Moving Past GoogleApiClient مراجعه کنید.

برای جایگزینی اجزای مرتبط با Wear برای اتصال به سرویس‌های Google Play، به جایگزین‌های اجزای منسوخ مراجعه کنید. برای انتشار و مشکلات شناخته شده مربوط به خدمات Google Play، به یادداشت‌های انتشار برای خدمات Google Play مراجعه کنید.

توجه: اگر برنامه خود را با آخرین نسخه سرویس های Google Play کامپایل کنید، از کاربران خواسته می شود دستگاه های خود را به آخرین نسخه به روز کنند. با این حال، یک مشکل شناخته شده برای برنامه هایی که API نسخه 26 را هدف قرار می دهند ممکن است از درخواست کاربران برای به روز رسانی دستگاه های خود جلوگیری کند. این مشکل در یادداشت‌های انتشار برای سرویس‌های Google Play توضیح داده شده است.

حالت محیطی 2017-Oct-25 و بیشتر

این بخش حاوی اطلاعاتی درباره ویژگی‌های جدید Android Wear است.

کتابخانه پشتیبانی اندروید نسخه 27.0.0: ویژگی ها و رفع اشکال

نسخه 27.0.0 کتابخانه پشتیبانی Android دارای ویژگی‌های جدیدی برای Wear است. بخش زیر را مرور کنید.

روش جدید و ترجیحی برای پشتیبانی از حالت محیطی

حالت محیطی به برنامه Wear اجازه می‌دهد تا زمانی که دستگاه بی‌حرکت می‌شود، برای کاربر قابل مشاهده باشد. کتابخانه پشتیبانی Android روشی جدید و ترجیحی برای برنامه‌های شما برای استفاده از حالت محیطی دارد. تیم Wear به دنبال بازخورد توسعه دهندگان در مورد این تغییر مهم است.

به طور خاص، استفاده از کلاس AmbientMode مزایای زیر را ارائه می دهد:

• زیر کلاس‌های Activity در کتابخانه پشتیبانی Android، مانند FragmentActivity . عملکرد برای قطعات کتابخانه پشتیبانی در دسترس است.
• اجزای معماری که از چرخه حیات آگاه هستند.
• پشتیبانی بهتر از Google Sign-In .

ثابت‌های فراداده را در کتابخانه پشتیبانی Android آشکار کنید

ثابت‌ها برای برنامه‌های Android Wear که در تگ meta-data در فایل Android Manifest استفاده می‌شوند، اکنون در کتابخانه پشتیبانی Android در دسترس هستند. برای استفاده از ثابت‌ها - برای برنامه‌های مستقل، حالت پل زدن اعلان‌ها، و تصاویر پیش‌نمایش چهره تماشا - یک مرجع به موارد زیر در بخش وابستگی‌ها در فایل build.gradle ماژول برنامه اضافه کنید، که به آخرین نسخه مخزن Google نیاز دارد:

implementation 'com.android.support:wear:27.0.0'

implementation("com.android.support:wear:27.0.0")

به‌روزرسانی‌های اکشن کشو

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

• هنگامی که آیتم های منو اصلاح می شوند، کشو عمل به درستی به روز می شود.
• اگر برای کشوی اکشن تنظیم شده باشد، عنوان به درستی نمایش داده می شود.

تورم کلاس RoundedDrawable

با فرض سطح API حداقل 24، کلاس RoundedDrawable اکنون می تواند از یک فایل XML قابل ترسیم باد شود. نقشه های سفارشی را ببینید.

کتابخانه پشتیبانی پوشیدنی، نسخه 2.1.0: پیشرفت‌ها و موارد دیگر

نسخه 2.1.0 کتابخانه پشتیبانی پوشیدنی شامل به‌روزرسانی‌هایی است که در بخش زیر توضیح داده شده است و به کتابخانه پشتیبانی Android نسخه 26.0.2 یا بالاتر نیاز دارد.

برای حالت محیطی تصاویر ایمن رایت کنید

کلاس ComplicationDrawable به شما امکان می دهد تصاویر رایت در حالت ایمن را برای حالت محیطی تهیه کنید. به طور خاص، فیلد تصویر کوچک محافظت در برابر سوختگی یک شی ComplicationData به صفحه ساعت اجازه می‌دهد یک تصویر کوچک را در نوع پیچیده SMALL_IMAGE ، در حالت محیطی، زمانی که محافظت در برابر سوختن فعال است، نمایش دهد.

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

کلاس ComplicationDrawable یک متد جدید onTap دارد که به صفحه ساعت شما اجازه می‌دهد رویدادهای ضربه را به عوارض منتقل کند. روش جدید مبتنی بر عملکرد موجود است که در آن با ضربه زدن روی صفحه ساعت، متد WatchFaceService.Engine.onTapCommand فعال می شود.

می‌توانید مختصات را با یک فراخوانی onTap به ComplicationDrawable منتقل کنید تا اقدام مرتبط با ComplicationDrawable را که حاوی مختصات ضربه‌ای است، اجرا کنید. هنگامی که متد جدید onTap فراخوانی می شود، می توانید از مقدار بازگشتی true استفاده کنید تا ببینید آیا یک ComplicationDrawable اکشن مرتبط با آن را راه اندازی کرده است یا خیر.

علاوه بر این، متد setHighlightDuration مدت زمانی را تعیین می کند که یک عارضه پس از فراخوانی متد onTap برجسته بماند.

نوار پیشرفت برای عوارض مقادیر محدوده

اگر ترجیح می‌دهید نوار پیشرفت خود را برای پیچیدگی‌های مقادیر دامنه‌ای در صفحه ساعت خود ترسیم کنید، از متد setRangedValueProgressHidden از کلاس ComplicationDrawable استفاده کنید تا پیشرفت مقدار دامنه‌ای را که توسط ComplicationDrawable ترسیم می‌شود، پنهان کنید.

نسخه بتای Android Wear 2017-Oct-02

این بخش شامل مشکلات شناخته شده برای نسخه بتا Android Wear است. برای اطلاعات در مورد برنامه بتا یا ثبت نام، به صفحه بتای Android مراجعه کنید.

مسائل شناخته شده

• Google Pay و کارت‌های آن با این نسخه بتا Android Wear کار نمی‌کنند.
• حتی اگر اتصال سلولی روشن باشد، پس از نصب بتا خاموش می شود. به عنوان یک راه حل، پس از نصب نسخه بتا، اتصال تلفن همراه را با رفتن به تنظیمات > اتصال > تلفن همراه روشن کنید.
• اگر پس از به‌روزرسانی بتا، اعلان‌ها نامنظم هستند یا وجود ندارند، یا مخاطبین همگام‌سازی نشده‌اند، ساعت خود را به تنظیمات کارخانه بازنشانی کنید.
• در آموزش Wear، که پس از راه‌اندازی ساعت شروع می‌شود، برخی از کارت‌ها به‌طور نامنظم رفتار می‌کنند، اما می‌توان آنها را به طور معمول با کشیدن انگشت حذف کرد.
• در گوشی‌های Android 6.0، اعلان‌های تماس تلفنی روی ساعت دریافت نمی‌شوند.
• مانیتورینگ ضربان قلب گاهی اوقات پس از به روز رسانی با شکست مواجه می شود. به عنوان یک راه حل، ساعت را راه اندازی مجدد کنید.
• کارت OTA در جریان گاهی اوقات نصب را فعال نمی کند. به عنوان یک راه حل، به Settings > System > About > System Updates بروید.