Wear OS 최신 버전으로 업그레이드
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
Wear 2.0에서 업그레이드
이 가이드에서는 Wear OS의 업그레이드 과정을 설명합니다.
Android 관련 변경사항
Wear 2.0은 API 수준 25~API 수준 28의 여러 Android 버전을 포함합니다.
참고: Android 10(API 수준 29)용 Wear OS 버전은 없습니다.
Wear OS 앱이 Wear OS 2.0(API 수준 28)을 타겟팅하는 경우 업그레이드 작업은 대부분 Android 9(API 수준 28)에서 Android 11(API 수준 30)로의 플랫폼 변경사항을 처리하는 것입니다.
Android 10(API 수준 29)용 Wear OS 버전은 없으므로 compileSdkVersion 및 targetSdkVersion 필드를 28에서 30으로 변경할 때 이러한 변경사항을 한 번에 모두 처리해야 합니다.
참고: 앱에서 compileSdkVersion 또는 targetSdkVersion을 변경하지 않더라도 앱이 API 수준 29와 호환되는지 확인합니다.
Wear OS 관련 변경사항
Wear OS 2.0에는 카드, 정보 표시, 앱, 시계 화면 등 여러 노출 영역이 있습니다. 앱을 업그레이드할 때는 사용자 인터페이스를 수정하여 최신 디자인 가이드라인을 통합해야 합니다.
API 수준 30에는 Ongoing Activity API가 포함되어 있습니다.
진행 중인 활동을 사용하면 Wear OS 사용자 인터페이스 내 추가 노출 영역에 진행 중 알림이 표시될 수 있으므로 사용자가 장기 실행 활동에 더 많이 참여할 수 있습니다.
참고: 알파 시계 화면 API의 일부 기능은 API 수준 30 이상을 실행하는 기기에서만 사용할 수 있습니다.
시작할 버전 선택
대부분의 개발자는 API 수준 30을 타겟팅하는 견고한 앱을 빌드하고 가장 일반적인 Android 버전을 타겟팅할 수 있을 만큼 minSdkVersion 버전을 낮게 유지합니다. 예를 들어 Wear 2.0 기기 지원을 허용하려면 minSdkVersion을 25로 설정합니다.
Android 개발 경험이 있다면 Wear OS에도 이러한 지식의 상당 부분을 활용할 수 있습니다.
차이점을 알아보려면 Wear OS 개발과 모바일 개발 비교를 참고하세요.
참고: API 수준 30 Wear OS 에뮬레이터 시스템 이미지는 개발자 프리뷰 상태에 있습니다. 최신 업데이트는 출시 노트를 참고하세요.
Wear OS용 Jetpack 라이브러리
Wear OS용 Jetpack 라이브러리는 웨어러블 지원 라이브러리와 유사한 기능을 포함하고 Wear OS 3을 더 효과적으로 지원하는 라이브러리 세트입니다.
Wear OS용 Jetpack 라이브러리는 웨어러블 지원 라이브러리를 대체하며, 함께 사용하도록 설계되지 않았습니다. 웨어러블 지원 라이브러리는 Wear OS 3에서 작동하지 않습니다.
자세한 내용은
안정적인 Wear OS Jetpack 라이브러리 블로그 게시물을 참고하세요.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-26(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-26(UTC)"],[],[],null,["# Upgrade to the latest version of Wear OS\n\nUpgrade from Wear 2.0\n---------------------\n\n\nThis guide describes the upgrade process for Wear OS.\n\n### Android-specific changes\n\n\nWear 2.0 encompasses multiple Android versions, from API level 25 through\nAPI level 28.\n\n**Note:** There is no version of Wear OS for Android 10 (API Level 29).\n\n\nIf your Wear OS app targets Wear OS 2.0 (API level 28), then most of the work\nto upgrade is handling the platform changes from Android 9 (API level 28) to\nAndroid 11 (API level 30).\n\nThere is no version of Wear OS for Android 10 (API Level 29), you need to handle those\nchanges all at once when you change your `compileSdkVersion` and\n`targetSdkVersion` fields from 28 to 30.\n\n**Note:** Even if you don't change the `compileSdkVersion` or\n`targetSdkVersion` in your app, ensure that your app is\n[compatible](https://developer.android.com/about/versions/11/migration#compat) with API Level 29.\n\n### Changes specific to Wear OS\n\n\n[Tiles](/training/articles/wear-tiles),\n[complications](/training/wearables/watch-faces/complications),\napps, [watch faces](/training/wearables/watch-faces), and many other surfaces\nexist in Wear OS 2.0. When you upgrade your app, you must revise your user interfaces\nto incorporate the latest design guidelines.\n\n\nAlso, API level 30 includes the\n[Ongoing Activity API](/reference/androidx/wear/ongoing/OngoingActivity).\nAn [ongoing activity](/training/wearables/ongoing-activity) lets an\nongoing notification appear on additional surfaces within the Wear OS user\ninterface, which lets users stay more engaged with long-running activities.\n\n**Note:** Some features of alpha watch face APIs are available only on\ndevices running API level 30 or higher.\n\nChoose a version to start with\n------------------------------\n\n\nMost developers build a solid app that targets API level 30 and\nleave the `minSdkVersion` version low enough to target the most prevalent Android\nversions. For example, to enable support for Wear 2.0 devices, set your `minSdkVersion`\nto 25.\n\n\nIf you have experience with Android development, much of that knowledge is applicable to Wear OS.\nTo find out what differs, read\n[Wear OS versus mobile development](/training/wearables/wear-v-mobile).\n\n\n**Note** : The API level 30 Wear OS emulator system image is in Developer\nPreview. See the\n[release notes](https://androidstudio.googleblog.com/2021/05/android-studio-arctic-fox-beta-1.html)\nfor the latest updates.\n\nJetpack libraries for Wear OS\n-----------------------------\n\n\nThe [Jetpack libraries for Wear OS](/jetpack/androidx/releases/wear) are a set of\nlibraries that contain similar functionality to the Wearable Support library and better support\nfor Wear OS 3.\n\n\nThe Jetpack libraries for Wear OS are replacements for the Wearable Support Library and aren't\ndesigned to be used together. The Wearable Support Library does not work on Wear OS 3.\n\n\nFor more information, see the blog post\n[Wear OS Jetpack libraries now in stable](https://android-developers.googleblog.com/2021/09/wear-os-jetpack-libraries-now-in-stable.html)."]]
