앱이 동작 변경사항을 처리하는 방식 테스트
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Wear OS 5는 Android 14 (API 수준 34)를 기반으로 합니다.
Wear OS 5에서 사용할 Wear OS 앱, 시스템 처리
Android 14의 모든 앱에 영향을 미치는 동작 변경사항과
Android 14를 타겟팅하는 앱의 변경사항을 확인하세요.
모든 앱에 영향을 미치는 Wear OS 5 변경사항
다음 동작 변경사항은
Wear OS로 이전했습니다. 이러한 변경사항은 Wear OS 5 이상에서 실행되는 모든 앱에 영향을 미칩니다.
대상 SDK 버전과 관계없이
개인 정보 대시보드
Wear OS 5는 다음을 제공하는 개인 정보 대시보드에 대한 지원을 추가합니다.
각 앱의 데이터 사용량을 한곳에서 볼 수 있습니다.
새로운 시계에는 워치 페이스 형식을 사용하는 시계 화면만 표시됩니다.
Wear OS 5 이상으로 출시되는 시계는
워치 페이스 형식 따라서 Google에서는
워치 페이스 형식을 사용합니다.
Android 14를 타겟팅하는 앱에 영향을 미치는 Wear OS 5 변경사항
다음 변경사항은 타겟 SDK를 업데이트하는 경우에만 앱에 영향을 미칩니다.
Wear OS 5의 기반이 되는 버전인 Android 14로 업그레이드했습니다.
항상 켜져 있는 앱을 백그라운드로 이동할 수 있음
Wear OS 5부터 시스템은 상시 사용 설정 앱을 백그라운드로 이동합니다.
일정 시간 동안 대기 모드에서 표시된 후 표시될 수 있습니다. 사용자가 할 수 있는 작업
시스템 설정에서 제한 시간을 구성합니다.
운동 기록 앱은 포그라운드 서비스 유형을 선언해야 함
앱이 다음과 같은 기기에서 사용자의 운동 세션의 일부로 운동을 기록하는 경우
Wear OS 5 이상을 실행하는 경우
health
포그라운드 서비스 유형을 지정해야 하는 포그라운드 서비스에서
ExerciseClient
를 호출합니다. 또한 앱에서 위치를 모니터링할 수 있는 경우
운동 세션 중 정보를 전달하려면 location
도 지정해야 합니다.
포그라운드 서비스 유형입니다.
일부 손목에서 착용하지 않은 기기가 잠금 해제 상태로 유지됨
Wear OS 5 이상을 실행하는 지원되는 기기에서 사용자가 손목을 끄는 경우
감지한 다음 기기를 손목에서 풀고
시스템이 잠금 해제 상태를 유지하는 데 걸리는 시간보다
없습니다.
앱에 더 높은 수준의 보안이 요구되는 경우(예:
민감할 수 있는 데이터나 비공개 데이터—손목 감지가 사용 설정되어 있는지 확인하세요.
드래그 가능한 콘텐츠가 시스템 동작 활성화 지점과 겹칠 수 있음
Wear OS 5부터 시스템은 모션 이벤트 동작을 처리합니다.
동작 탐색과 별도로 구현됩니다.
앱 UI에 시스템 동작과 겹치는 드래그 가능한 큰 공간이 포함된 경우
이러한 영역을 위해 시스템 동작 제외 직사각형을 추가해야 할 수도 있습니다.
할 수 있습니다. 이렇게 하려면 setSystemGestureExclusionRects()
를 호출하여
시스템 UI를 사용하여 지정된 영역에서 탐색 동작을 무시할 수 있습니다. 이것은
모바일 앱에서 충돌하는 앱 동작을 처리하여
더 넓은 화면 UI 환경을 제공합니다.
setSystemGestureExclusionRects()
API를 사용하여 시스템 UI를 만들 수 있습니다.
동작 요청에 다르게 응답합니다. 예를 들어 시스템 UI가
추가적인 UI 힌트(예: 가로 막대)를 제공하여 사용자의 의도를 확인합니다.
암시적 인텐트와 대기 중인 인텐트 제한사항
앱에서 카드를 사용하는 경우
인텐트는 암시적 인텐트와 대기 중인 인텐트에 대한 제한사항의 영향을 받습니다.
여전히 일부 알림을 닫을 수 없음
Android 14를 실행하는 기기에서 휴대기기 버전의 앱을 사용하는 경우
(API 수준 34) 이상에서는 사용자가 알림을 닫을 수 있습니다.
닫을 수 없었습니다.
하지만 Wear OS 5 이상에서는 이러한 알림을 여전히 닫을 수 없습니다.
Android 14의 기타 변경사항
다음 Android 14 변경사항이 Wear OS에 영향을 미칠 가능성이 높습니다.
있습니다.
모든 앱에 영향을 미치는 Android 14 변경사항
API 수준 34를 타겟팅하는 앱에 영향을 미치는 Android 14 변경사항
추천 서비스
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[[["이해하기 쉬움","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-27(UTC)"],[],[],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)"]]