آزمایش کنید که برنامه شما چگونه تغییرات رفتاری را کنترل می کند
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
Wear OS 5 مبتنی بر Android 14 (سطح API 34) است. وقتی برنامه Wear OS خود را برای استفاده در Wear OS 5 آماده میکنید، تغییرات رفتار سیستم را که بر همه برنامههای Android 14 تأثیر میگذارد و همچنین تغییرات برنامههایی که Android 14 را هدف قرار میدهند، کنترل کنید.
Wear OS 5 تغییراتی را که بر همه برنامهها تأثیر میگذارد
تغییرات رفتاری زیر بر موارد استفاده و کتابخانههایی که مختص Wear OS هستند تأثیر میگذارد. این تغییرات بر همه برنامههایی که در Wear OS 5 یا بالاتر اجرا میشوند، بدون در نظر گرفتن نسخه SDK هدف، تأثیر میگذارد.
داشبورد حریم خصوصی
Wear OS 5 پشتیبانی از داشبورد حریم خصوصی را اضافه میکند، که به کاربران یک دید متمرکز از مصرف دادههای هر برنامه ارائه میدهد.
ساعتهای جدید فقط چهرههایی را نشان میدهند که از فرمت Watch Face استفاده میکنند
ساعتهایی که با Wear OS 5 یا بالاتر راهاندازی میشوند، فقط از ساعتهایی پشتیبانی میکنند که از فرمت Watch Face استفاده میکنند. به همین دلیل، توصیه می کنیم به استفاده از فرمت Watch Face مهاجرت کنید.
تغییرات Wear OS 5 بر برنامه هایی که اندروید 14 را هدف قرار می دهند تأثیر می گذارد
تغییرات زیر تنها در صورتی بر برنامه شما تأثیر می گذارد که نسخه SDK هدف خود را به Android 14 به روز کنید ، نسخه ای که Wear OS 5 مبتنی بر آن است.
برنامه های همیشه روشن می توانند به پس زمینه منتقل شوند
با شروع در Wear OS 5، سیستم برنامههای همیشه روشن را پس از اینکه در حالت محیطی برای مدت زمان مشخصی قابل مشاهده بودند، به پسزمینه منتقل میکند . کاربران می توانند زمان وقفه را در تنظیمات سیستم پیکربندی کنند.
برنامههای ضبط تمرین باید نوع خدمات پیشزمینه را اعلام کنند
اگر برنامه شما تمرین را به عنوان بخشی از جلسه تمرین کاربر در دستگاههایی که Wear OS 5 یا بالاتر دارند ضبط میکند، باید نوع سرویس پیشزمینه health
را در سرویس پیشزمینه که ExerciseClient
را فراخوانی میکند، مشخص کنید. علاوه بر این، اگر برنامه شما می تواند اطلاعات مکان را در طول جلسه تمرین نظارت کند، باید نوع سرویس پیش زمینه location
را نیز مشخص کنید.
برخی از دستگاه های خارج از مچ دست مدت بیشتری باز می مانند
در دستگاههای پشتیبانیشده که دارای سیستمعامل Wear OS 5 یا بالاتر هستند، اگر کاربر تشخیص مچ را خاموش کند و سپس دستگاه را از مچ خود خارج کند، سیستم دستگاه را برای مدت زمان طولانیتری نسبت به حالت قبلی باز نگه میدارد .
اگر برنامه شما به سطح بالاتری از امنیت نیاز دارد - مانند هنگام نمایش دادههای بالقوه حساس یا خصوصی - بررسی کنید که آیا تشخیص مچ فعال است یا خیر.
محتوای قابل کشیدن ممکن است با نقاط فعال سازی اشاره سیستم همپوشانی داشته باشد
با شروع در Wear OS 5، این سیستم با ژستهای رویداد حرکتی جدا از پیمایش اشارهای که در رابط کاربری سیستم استفاده میشود، برخورد میکند.
اگر رابط کاربری برنامه شما شامل فضاهای قابل کشیدن بزرگی است که با نواحی اشاره سیستم همپوشانی دارند، ممکن است لازم باشد مستطیل های حذف اشاره سیستم را برای این نماها اضافه کنید. برای انجام این کار، setSystemGestureExclusionRects()
را فراخوانی کنید تا به رابط کاربری سیستم دستور دهد که حرکات ناوبری را در مناطق داده شده نادیده بگیرد. این شبیه به نحوه برخورد با حرکات متناقض برنامه در برنامه تلفن همراهتان است تا یک تجربه رابط کاربری لبه به لبه ارائه دهید.
میتوانید از API setSystemGestureExclusionRects()
استفاده کنید تا رابط کاربری سیستم به درخواستهای اشاره متفاوت پاسخ دهد. برای مثال، رابط کاربری سیستم ممکن است نکات رابط کاربری اضافی، مانند یک نوار افقی، برای تأیید قصد کاربر نشان دهد.
محدودیت برای مقاصد ضمنی و معلق
اگر از کاشیها در برنامهتان استفاده میکنید، بررسی کنید که آیا مقاصد شما تحت تأثیر محدودیتهای مقاصد ضمنی و معلق قرار میگیرد یا خیر.
برخی از اعلانها هنوز قابل رد نیستند
هنگام استفاده از نسخه دستی برنامه خود در دستگاهی که دارای Android 14 (سطح API 34) یا بالاتر است، کاربران میتوانند اعلانهایی را که در نسخههای قبلی غیرقابل رد کردن بودند، رد کنند .
با این حال، در Wear OS 5 و بالاتر، این اعلانها هنوز قابل رد نیستند.
تغییرات دیگر از اندروید 14
تغییرات زیر از Android 14 به احتمال زیاد بر برنامه Wear OS شما تأثیر می گذارد.
تغییرات اندروید 14 که همه برنامه ها را تحت تاثیر قرار می دهد
تغییرات Android 14 که بر برنامه هایی که سطح API 34 را هدف قرار می دهند تأثیر می گذارد
{% کلمه به کلمه %}
{% آخر کلمه %} برای شما توصیه می شود
{% کلمه به کلمه %} {% آخر کلمه %}
محتوا و نمونه کدها در این صفحه مشمول پروانههای توصیفشده در پروانه محتوا هستند. جاوا و OpenJDK علامتهای تجاری یا علامتهای تجاری ثبتشده Oracle و/یا وابستههای آن هستند.
تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2025-07-29 بهوقت ساعت هماهنگ جهانی."],[],[],null,["# Test how your app handles behavior changes\n\nWear OS 5 is based on Android 14 (API level 34). When you prepare your\nWear OS app for use on Wear OS 5, handle the system\n[behavior changes that affect all apps in Android 14](/about/versions/14/behavior-changes-all), as well as the\n[changes for apps that target Android 14](/about/versions/14/behavior-changes-14).\n| **Caution:** Before you upload your app to the Play Store, [target Android 14](/training/wearables/versions/5/update-target-sdk) and [configure an emulator](/training/wearables/get-started/creating#configure-emulator) to test your app.\n\nWear OS 5 changes affecting all apps\n------------------------------------\n\nThe following behavior changes affect use cases and libraries that are specific\nto Wear OS. These changes affect all apps that run on Wear OS 5 or higher,\nregardless of target SDK version.\n\n### Privacy dashboard\n\nWear OS 5 adds support for the [privacy dashboard](/training/wearables/principles#privacy-dashboard), which offers\nusers a centralized view of each app's data usage.\n\n### New watches only show watch faces that use Watch Face Format\n\nWatches that launch with Wear OS 5 or higher only support watch faces that use\nthe [Watch Face Format](/training/wearables/wff). For this reason, we recommend that you migrate to\nusing the Watch Face Format.\n\nWear OS 5 changes affecting apps that target Android 14\n-------------------------------------------------------\n\nThe following changes affect your app only if you [update your target SDK\nversion to Android 14](/training/wearables/versions/5/update-target-sdk), the version on which Wear OS 5 is based.\n\n### Always-on apps can move to the background\n\nStarting in Wear OS 5, the [system moves always-on apps to the background](/training/wearables/always-on#background)\nafter they're visible in ambient mode for a certain period of time. Users can\nconfigure the timeout in system settings.\n\n### Exercise-recording apps must declare a foreground service type\n\nIf your app records exercise as part of a user's workout session on devices that\nrun Wear OS 5 or higher, you must\n[specify the `health` foreground service type](/health-and-fitness/guides/health-services/active-data#structure) in the foreground service that\ninvokes [`ExerciseClient`](/reference/kotlin/androidx/health/services/client/ExerciseClient). Additionally, if your app can monitor location\ninformation during the workout session, you must also specify the `location`\nforeground service type.\n\n### Some off-wrist devices stay unlocked longer\n\nOn supported devices that run Wear OS 5 or higher, if the user turns off wrist\ndetection and then takes the device off of their wrist, the\n[system keeps the device unlocked for a longer period of time](/training/wearables/apps/auth-wear#device-unlocked-longer) than it would\notherwise.\n\nIf your app requires a higher level of security---such as when displaying\npotentially sensitive or private data---check whether wrist detection is enabled.\n\n### Draggable content might overlap system gesture activation points\n\nStarting in Wear OS 5, the system treats motion event gestures\nseparately from gesture navigation used in the system's UI.\n\nIf your app's UI includes large draggable spaces that overlap system gesture\nareas, you might need to add system gesture exclusion rectangles for these\nviews. To do so, call [`setSystemGestureExclusionRects()`](/reference/android/view/View#setSystemGestureExclusionRects(java.util.List%3Candroid.graphics.Rect%3E)) to instruct the\nsystem UI to ignore navigation gestures in the given areas. This is similar to\nhow you [handle conflicting app gestures](/develop/ui/views/touch-and-input/gestures/gesturenav#conflicting-gestures) in your mobile app to provide an\nedge-to-edge UI experience.\n\nYou can use the `setSystemGestureExclusionRects()` API to have the system UI\nrespond to gesture requests differently. For example, the system UI might show\nadditional UI hints, like a horizontal bar, to confirm the user's intent.\n\n### Restrictions to implicit and pending intents\n\nIf you use [tiles](/training/wearables/tiles) in your app, check whether your\nintents are affected by the [restrictions to implicit and pending intents](/about/versions/14/behavior-changes-14#safer-intents).\n\n### Some notifications are still non-dismissible\n\nWhen using the handheld version of your app on a device that runs Android 14\n(API level 34) or higher, [users can dismiss notifications](/about/versions/14/behavior-changes-all#non-dismissable-notifications) that, on\nprevious versions, were non-dismissible.\n\nOn Wear OS 5 and higher, however, these notifications are still non-dismissible.\n\nOther changes from Android 14\n-----------------------------\n\nThe following changes from Android 14 are most likely to affect your Wear OS\napp.\n\n### Android 14 changes that affect all apps\n\n- [Schedule exact alarms are denied by default](/about/versions/14/behavior-changes-all#schedule-exact-alarms)\n- [Context-registered broadcasts are queued while apps are cached](/about/versions/14/behavior-changes-all#pending-broadcasts-queued)\n- [Additional reason an app can be placed in the restricted standby\n bucket](/about/versions/14/behavior-changes-all#triggers-to-restricted-bucket)\n\n### Android 14 changes that affect apps targeting API level 34\n\n- [Foreground service types are required](/about/versions/14/behavior-changes-14#fgs-types)\n- [Non-linear font scaling](/about/versions/14/features#non-linear-font-scaling) (only affects view-based UI elements)\n- [Enforcement of `BLUETOOTH_CONNECT` permission in `BluetoothAdapter`](/about/versions/14/behavior-changes-14#enforce-bluetooth_connect)\n- [`JobScheduler` reinforces callback and network behavior](/about/versions/14/behavior-changes-14#jobscheduler-reinforces-behavior)\n- [Runtime-registered broadcasts receivers must be explicitly exported or not\n exported](/about/versions/14/behavior-changes-14#runtime-receivers-exported)\n- [Safer dynamic code loading](/about/versions/14/behavior-changes-14#safer-dynamic-code-loading)\n- [Additional restrictions on starting activities from the background](/about/versions/14/behavior-changes-14#background-activity-restrictions)\n- [User can grant partial access to photos and videos](/about/versions/14/behavior-changes-14#partial-photo-library-access)\n\nRecommended for you\n-------------------\n\n- Note: link text is displayed when JavaScript is off\n- [Privacy changes in Android 10](/about/versions/10/privacy/changes)\n- [Connect to a GATT server {:#connect}](/develop/connectivity/bluetooth/ble/connect-gatt-server)\n- [Communicate in the background](/develop/connectivity/bluetooth/ble/background)"]]