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

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

2026-آوریل-28 SDK پوشیدنی 20.0.1

نسخه ۲۰.۰.۱ کیت توسعه نرم‌افزاری پوشیدنی شامل به‌روزرسانی‌های جزئی SDK است. این به‌روزرسانی‌ها عبارتند از:

  • رفع آسیب‌پذیری. به برنامه‌هایی که API سطح ۳۷ یا بالاتر را هدف قرار می‌دهند، توصیه می‌شود حداقل از این نسخه SDK استفاده کنند.
  • اکنون مصنوعات با فایل‌های امضای .asc همراه منتشر می‌شوند تا از صحت آنها اطمینان حاصل شود. به صورت اختیاری، می‌توانید تأیید امضا را فعال کنید .

۲۰۲۴-نوامبر-۲۱ SDK پوشیدنی ۱۹.۰.۰

نسخه ۱۹.۰.۰ کیت توسعه نرم‌افزاری گجت‌های پوشیدنی (Wearable SDK) شامل به‌روزرسانی‌های جزئی SDK است. این به‌روزرسانی‌ها عبارتند از:

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

۲۰۲۳-آگوست-۳۱ کیت توسعه نرم‌افزار پوشیدنی ۱۸.۱.۰

نسخه ۱۸.۱.۰ کیت توسعه نرم‌افزاری گجت‌های پوشیدنی (Wearable SDK) شامل به‌روزرسانی‌های جزئی API برای پشتیبانی از نسخه بعدی کتابخانه پشتیبانی گجت‌های پوشیدنی است. به‌روزرسانی‌ها شامل موارد زیر هستند:

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

۲۰۲۲-سپتامبر-۲۰ کیت توسعه نرم‌افزار پوشیدنی ۱۸.۰.۰

نسخه ۱۸.۰.۰ کیت توسعه نرم‌افزاری گجت‌های پوشیدنی (Wearable SDK) شامل به‌روزرسانی‌های جزئی API برای پشتیبانی از نسخه بعدی کتابخانه پشتیبانی گجت‌های پوشیدنی است. به‌روزرسانی‌ها شامل موارد زیر هستند:

  • پشتیبانی WearableListenerService برای برنامه‌هایی که اندروید ۱۳ را هدف قرار می‌دهند—شماره ۲۳۵۵۳۸۸۴۰ .
  • متد جدید MessageClient.sendRequest() ‎.

کتابخانه پشتیبانی پوشیدنی نسخه ۲.۹.۰، ۲۰۲۲-فوریه-۱۶

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

کتابخانه جت‌پک Wear OS، ۲۹ اکتبر ۲۰۲۱

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

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

نسخه ۱۷.۱.۰ کیت توسعه نرم‌افزاری گجت‌های پوشیدنی (Wearable SDK) شامل به‌روزرسانی‌های جزئی API برای پشتیبانی از نسخه بعدی کتابخانه پشتیبانی گجت‌های پوشیدنی (Wearable Support Library) است.

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

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

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

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

کتابخانه پشتیبانی پوشیدنی نسخه ۲.۸.۰، ۲۰۲۰-سپتامبر-۲۴

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

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

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

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

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

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

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

کتابخانه پشتیبانی پوشیدنی نسخه ۲.۷.۰، ۱۵ مه ۲۰۲۰

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

شتاب سخت‌افزاری برای واچ فیس‌ها

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

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

کتابخانه پشتیبانی پوشیدنی نسخه ۲.۶.۰، ۲۰۲۰-آوریل-۲۱

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

مهاجرت به جت‌پک اندروید

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

این تغییر همچنین به شما امکان می‌دهد از کتابخانه‌های Wearable Support در اندروید استودیو ۴.۰ و بالاتر استفاده کنید که مشکلاتی مانند شماره #۱۴۷۹۷۲۰۷۹ را حل می‌کند.

کتابخانه پشتیبانی پوشیدنی‌ها نسخه ۲.۵.۰، ۲۸ آگوست ۲۰۱۹

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

رفع مشکل Complication Drawable هنگام استفاده از نوع Complication TYPE_NO_PERMISSION

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

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

2018-سپتامبر-25 SDK پوشیدنی 16.0.0

نسخه ۱۶.۰.۰ کیت توسعه نرم‌افزاری گجت‌های پوشیدنی، نسخه مورد نیاز سرویس‌های گوگل پلی را از نسخه ۱۲.۴ به نسخه ۸.۶ کاهش می‌دهد. این تغییر به برنامه‌های موجود اجازه می‌دهد تا بدون نیاز به به‌روزرسانی APK سرویس‌های گوگل پلی، به آخرین نسخه کیت توسعه نرم‌افزاری گجت‌های پوشیدنی به‌روزرسانی شوند.

به‌روزرسانی ۱۱ ژوئن ۲۰۱۸ به پیش‌نمایش دوم توسعه‌دهندگان Wear OS

به‌روزرسانی اخیر سیستم‌عامل Wear OS Developer Preview 2 که از طریق اینترنت بی‌سیم (OTA) انجام شد، آلارم‌ها و وظایف مربوط به برنامه‌های پس‌زمینه را دوباره فعال کرده است.

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

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

۸ مه ۲۰۱۸، پیش‌نمایش دوم توسعه‌دهندگان Wear OS

نسخه دوم پیش‌نمایش توسعه‌دهندگان Wear OS دارای ویژگی‌هایی مانند تجربه بهبود یافته دستیار گوگل است.

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

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

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

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

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

مشکلات سیستم عامل Wear OS برای چین

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

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

  • ممکن است چندین اعلان مداوم به درستی نمایش داده نشوند. برای مثال، اگر هم تایمر و هم کرنومتر تنظیم شده باشند، اعلان‌ها نمایش داده نمی‌شوند. توصیه می‌کنیم برنامه خود را با یک اعلان مداوم به جای بیش از یک اعلان آزمایش کنید.

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

مشکلات شبیه‌ساز Wear

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

  • وقتی از SDK manager برای نصب یا تأیید آخرین نسخه اندروید P یا نسخه چین استفاده می‌کنید، کادرهای انتخاب کنار این گزینه‌ها می‌توانند پس از انتخاب، از حالت انتخاب خارج شوند. اگر از حالت انتخاب خارج شدند، دوباره آنها را انتخاب کنید.

  • وقتی شبیه‌ساز، بوت سرد (Cold Boot) را انجام می‌دهد، ممکن است خطای زیر نمایش داده شود: «یک مشکل داخلی در دستگاه شما وجود دارد. برای جزئیات بیشتر با سازنده تماس بگیرید.» این موضوع تاثیری بر عملکرد ندارد. برای شروع آزمایش برنامه، روی تأیید (OK) کلیک کنید.

  • ممکن است پاسخ صوتی روی شبیه‌ساز کار نکند. برای مثال، اگر در شبیه‌ساز Wear اعلانی برای پیام Google Hangouts دریافت کنید و سعی کنید از طریق صدا به پیام پاسخ دهید، پیام خطای «Google مرتباً متوقف می‌شود» نمایش داده می‌شود و شما نمی‌توانید از طریق صدا پاسخ دهید.

  • ممکن است Instant Run با شبیه‌ساز Wear سازگار نباشد.

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

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

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

  • وقتی از SDK manager برای نصب یا تأیید آخرین نسخه اندروید P یا نسخه چین استفاده می‌کنید، کادرهای انتخاب کنار این گزینه‌ها می‌توانند پس از انتخاب، از حالت انتخاب خارج شوند. اگر از حالت انتخاب خارج شدند، دوباره آنها را انتخاب کنید.

  • وقتی شبیه‌ساز بوت سرد را انجام می‌دهد، ممکن است خطای زیر نمایش داده شود: «یک مشکل داخلی در دستگاه شما وجود دارد. برای جزئیات بیشتر با سازنده تماس بگیرید.» این موضوع بر عملکرد تأثیری ندارد. برای شروع آزمایش برنامه، روی تأیید کلیک کنید.

  • ممکن است Instant Run با شبیه‌ساز Wear سازگار نباشد.

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

دستیار گوگل در گجت‌های پوشیدنی

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

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

  • به کاربران کمک کنید تا تعاملات را به سرعت انجام دهند

  • به کاربران در مورد قابلیت اکشن خود نکاتی را ارائه دهید

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

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

  • دیالوگ کوتاه و مختصر

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

این بهبودها برای دستیار گوگل در Wear OS به اندروید P وابسته نیستند و برای همه کاربران Wear 2.0 منتشر می‌شوند. برای آشنایی با ساخت Actions در گوگل، به بخش «ادغام با دستیار گوگل» مراجعه کنید.

صرفه‌جویی در مصرف باتری در پیش‌نمایش توسعه‌دهندگان ۲

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

حالت جدید: صرفه‌جویی در مصرف باتری پیشرفته

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

  • رادیوها

  • صفحه لمسی

  • ویژگی کج کردن برای بیدار شدن

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

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

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

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

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

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

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

آزمایشگاه‌های کد به‌روز شده در دسترس هستند

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

۲۷ مارس ۲۰۱۸، پیش‌نمایش توسعه‌دهندگان Wear OS ۱

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

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

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

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

پیش‌نمایش توسعه‌دهندگان ۱ شامل ویژگی‌های زیر برای آزمایش برنامه است:

  • فعالیت محدود در پس‌زمینه: برای بهبود مدیریت مصرف انرژی، برنامه‌های در پس‌زمینه دیگر نمی‌توانند از هشدارها و کارها استفاده کنند. موارد استثنا شامل صفحه‌های ساعت و ویژگی‌هایی است که کاربر انتخاب کرده است. این ویژگی به تدریج در پیش‌نمایش‌های توسعه‌دهندگان ارائه می‌شود، بنابراین ممکن است بلافاصله آن را در ساعت خود مشاهده نکنید. توجه: اگر برنامه شما همیشه باید اجرا شود، آن را با استفاده از متد startForegroundService() به یک سرویس پیش‌زمینه تبدیل کنید. برای جزئیات بیشتر به محدودیت‌های سرویس پس‌زمینه مراجعه کنید.
  • محدودیت‌های استفاده برنامه‌ها از رابط‌های غیر SDK: برای بهبود سازگاری برنامه‌ها، اندروید P شروع به اجرای محدودیت‌های خاصی در استفاده از رابط‌های غیر SDK کرده است. برای مهاجرت از روش‌ها و فیلدهای غیر SDK برنامه‌ریزی کنید. اگر معادل عمومی برای مورد استفاده شما در دسترس نیست، به ما اطلاع دهید .
  • تم سیستم رابط کاربری تیره: از ابتدای سال ۲۰۱۸، Wear OS به یک تم رابط کاربری پیش‌فرض تغییر یافته است که پس‌زمینه تیره‌تری برای پخش اعلان‌ها و لانچر سیستم دارد. این تغییر برای بهبود قابلیت مرور اجمالی برنامه‌های شما در نظر گرفته شده است؛ با این تم رابط کاربری جدید، دسترسی به برنامه خود را بررسی کنید.
  • خاموش بودن رادیوها وقتی ساعت از بدن جدا می‌شود : برای بهبود مدیریت انرژی، رادیو بلوتوث، رادیو وای‌فای و رادیو تلفن همراه وقتی ساعت برای مدت طولانی از بدن جدا تشخیص داده شود، خاموش می‌شوند. این ویژگی به تدریج در پیش‌نمایش‌های توسعه‌دهندگان ارائه خواهد شد، بنابراین ممکن است در ابتدا آن را روی ساعت خود نبینید. اگر این ویژگی در فرآیند توسعه شما ایجاد مشکل می‌کند، می‌توانید با استفاده از دستور زیر، این ویژگی را با استفاده از adb غیرفعال کنید: adb shell settings put global off_body_radios_off_for_small_battery_enabled 0
  • وای‌فای هنگام قطع بلوتوث خاموش است: برای بهبود مدیریت مصرف انرژی، ساعت دیگر هنگام قطع اتصال بلوتوث به طور خودکار به وای‌فای متصل نمی‌شود. موارد استثنا شامل مواردی است که برنامه‌ای درخواست شبکه با پهنای باند بالا می‌کند و همچنین مواردی که ساعت به شارژر متصل است. این ویژگی به تدریج در پیش‌نمایش‌های توسعه‌دهندگان ارائه خواهد شد، بنابراین ممکن است در ابتدا آن را در ساعت خود مشاهده نکنید.

به‌روزرسانی‌های کتابخانه پشتیبانی پوشیدنی، نسخه ۲.۳.۰

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

علاوه بر این، نسخه ۲.۳.۰ کتابخانه شامل به‌روزرسانی‌هایی مربوط به ComplicationDrawable و TextRenderer برای متنی است که اشیاء نشانه‌گذاری به محدوده‌های متنی متصل شده‌اند. این کلاس‌ها، مدیریت متون spanned را بهبود بخشیده‌اند. فقط زیرمجموعه خاصی از spanها را می‌توان رندر کرد - برای انواع spanهایی که می‌توانند ترسیم شوند، به متد setText مراجعه کنید - بنابراین spanها هنگام رندر شدن در صفحه ساعت، نامرتب به نظر نمی‌رسند.

۱۵ مارس ۲۰۱۸، تغییر برند پوشاک

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

نام جدید برای اندروید ویر

گوگل، سیستم عامل اندروید ویر (Android Wear) را به Wear OS تغییر نام داد.

به‌روزرسانی حالت محیطی ۲۷ فوریه ۲۰۱۸

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

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

نسخه ۲۷.۱.۰ کتابخانه پشتیبانی اندروید شامل یک کلاس جدید به نام AmbientModeSupport است که جایگزین کلاس منسوخ‌شده AmbientMode می‌شود. به‌روزرسانی‌های نمونه‌ها در هفته‌های آینده برنامه‌ریزی شده‌اند.

2018-ژانویه-25 شبیه‌ساز نهایی و موارد دیگر

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

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

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

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

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

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

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

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

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

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

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

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

  • اگر حالت تئاتر را در شبیه‌ساز فعال کنید، همانطور که در تغییر تنظیمات صفحه و روشنایی توضیح داده شده است، شبیه‌ساز ممکن است در حالت تئاتر گیر کند. رفع این مشکل نیاز به پاک کردن داده‌های شبیه‌ساز دارد؛ به بخش اجرا و توقف شبیه‌ساز و پاک کردن داده‌ها مراجعه کنید.

  • در پنجره یک شبیه‌ساز برای API سطح ۲۵ یا ۲۶، دکمه پاور کار نمی‌کند. به جای آن از دکمه‌های دیگری غیر از دکمه پاور استفاده کنید. به طور خاص، برای تغییر به حالت محیطی - به عنوان مثال، انگار که کاربر صفحه را با کف دست خود پوشانده است - از دکمه پاور در نوار ابزار شبیه‌ساز در سمت راست صفحه نمایش استفاده کنید. برای شروع اجرای برنامه در حالت تعاملی، از دکمه Home در نوار ابزار شبیه‌ساز استفاده کنید.

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

دسترسی جدید به سرویس‌های گوگل پلی از تاریخ ۲۰۱۷ تا ۱۸ دسامبر

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

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

با شروع از نسخه ۱۱.۸.۰ سرویس‌های گوگل پلی، برنامه‌های Wear خود را از کلاس GoogleApiClient خارج کرده و در عوض از اشیاء کلاینت API که مبتنی بر کلاس GoogleApi و Tasks API هستند، استفاده کنید.

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

اجزای جدید برای اتصال به سرویس‌های گوگل پلی

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

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

۲۵ اکتبر ۲۰۱۷ حالت محیطی و موارد دیگر

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

کتابخانه پشتیبانی اندروید، نسخه ۲۷.۰.۰: ویژگی‌ها و رفع اشکالات

نسخه ۲۷.۰.۰ کتابخانه پشتیبانی اندروید شامل ویژگی‌های جدیدی برای Wear است. بخش زیر را مرور کنید.

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

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

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

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

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

گرووی 

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

کاتلین 

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

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

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

  • وقتی آیتم‌های منو تغییر می‌کنند، کشوی اکشن به درستی به‌روزرسانی می‌شود.

  • اگر برای کشوی اکشن تنظیم شده باشد، عنوان به درستی نمایش داده می‌شود.

تورم کلاس RoundedDrawable

با فرض سطح API حداقل ۲۴، کلاس RoundedDrawable اکنون می‌تواند از یک فایل XML قابل ترسیم، inflate شود؛ به بخش custom drawables مراجعه کنید.

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

نسخه ۲.۱.۰ کتابخانه پشتیبانی پوشیدنی شامل به‌روزرسانی‌های شرح داده شده در بخش زیر است و به نسخه ۲۶.۰.۲ یا بالاتر کتابخانه پشتیبانی اندروید نیاز دارد.

تصاویر بدون سوختگی را برای حالت محیطی ارائه دهید

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

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

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

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

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

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

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

۲ اکتبر ۲۰۱۷، نسخه بتای اندروید ور

  • تاریخ: 2017-اکتبر-02
  • ساخت: OWP4.170828.008
  • دستگاه پشتیبانی شده: ساعت هوشمند ال‌جی واچ اسپورت

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

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

  • گوگل پی و کارت‌های آن با این نسخه بتای اندروید ویر کار نمی‌کنند.
  • حتی اگر اتصال سلولی روشن باشد، پس از نصب نسخه بتا خاموش می‌شود. به عنوان یک راه حل، پس از نصب نسخه بتا، با رفتن به تنظیمات > اتصال > تلفن همراه، اتصال سلولی را روشن کنید.
  • اگر اعلان‌ها بعد از به‌روزرسانی بتا نامنظم یا ناپدید شدند، یا مخاطبین همگام‌سازی نشدند، ساعت خود را به تنظیمات کارخانه برگردانید.
  • در آموزش Wear که پس از راه‌اندازی ساعت شروع می‌شود، برخی از کارت‌ها رفتار نامنظمی دارند، اما می‌توان آنها را به طور عادی با کشیدن انگشت رد کرد.
  • در گوشی‌های اندروید ۶.۰، اعلان‌های تماس تلفنی روی ساعت دریافت نمی‌شوند.
  • گاهی اوقات پس از به‌روزرسانی، پایش ضربان قلب از کار می‌افتد. به عنوان یک راه حل، ساعت را مجدداً راه‌اندازی کنید.
  • کارت OTA موجود در استریم گاهی اوقات نمی‌تواند نصب را فعال کند. به عنوان راه حل، به تنظیمات > سیستم > درباره > به‌روزرسانی‌های سیستم بروید.