이 페이지에는 Wearable SDK 및 웨어러블 지원 라이브러리와 같은 Wear OS 출시 버전에 관한 정보가 포함되어 있습니다.
2024년 11월 21일 Wearable SDK 19.0.0
Wearable SDK 버전 19.0.0에는 소규모 SDK 업데이트가 포함되어 있습니다. 업데이트 항목:
- 라이브러리 종속 항목을 최신 버전으로 업데이트했습니다.
MessageOptions
매개변수가 포함된 지원되지 않는sendMessage()
API 변형을 삭제했습니다.
2023/8/31 Wearable SDK 18.1.0
Wearable SDK 버전 18.1.0에는 다음 웨어러블 지원 라이브러리 출시를 지원하도록 소규모 API 업데이트가 포함되어 있습니다. 업데이트 항목:
- 휴대전화 전환이 지원됩니다. 자세한 내용은
NodeClient.OnNodeMigratedListener
를 참고하세요. MessageClient
전송 및 답장 메시지에 관한 문서가 추가되었습니다.- API 설명 내 링크가 업데이트되었습니다.
2022/9/20 Wearable SDK 18.0.0
Wearable SDK 버전 18.0.0에는 다음 웨어러블 지원 라이브러리 출시를 지원하도록 소규모 API 업데이트가 포함되어 있습니다. 업데이트 항목:
- Android 13을 타겟팅하는 앱에 대한
WearableListenerService
지원을 제공합니다(문제 235538840). - 새로운
MessageClient.sendRequest()
메서드를 지원합니다.
2022/2/16 웨어러블 지원 라이브러리 v2.9.0
웨어러블 지원 라이브러리 버전 2.9.0에서는 나머지 모든 클래스가 지원 중단됩니다. 대신 Wear OS Jetpack 라이브러리를 사용하세요.
2021/10/29 Wear OS Jetpack 라이브러리
Wear OS Jetpack 라이브러리는 웨어러블 지원 라이브러리를 대체하며, 함께 사용하도록 설계된 것이 아닙니다. 웨어러블 지원 라이브러리는 Wear OS 3에서 작동하지 않습니다.
2021/4/27 Wearable SDK 17.1.0
Wearable SDK 버전 17.1.0에는 다음 웨어러블 지원 라이브러리 출시를 지원하도록 소규모 API 업데이트가 포함되어 있습니다.
2020/9/28 웨어러블 지원 라이브러리 v2.8.1
웨어러블 지원 라이브러리 버전 2.8.1에는 다음 변경사항이 포함되어 있습니다.
시계 화면 템플릿 사용 시 Jetifier 사용 중지 허용
이제 Android 스튜디오 시계 화면 템플릿에서는 AndroidX 종속 항목을 사용하여 Jetifier 사용 중지를 허용합니다. 이러한 수정사항은 Android 스튜디오 4.2 이상에서 시계 화면 템플릿을 사용할 때 적용됩니다.
2020/9/24 웨어러블 지원 라이브러리 v2.8.0
웨어러블 지원 라이브러리 버전 2.8.0에는 다음 변경사항이 포함되어 있습니다.
기본 비 시스템 정보 표시 제공자를 지정하는 대체 기능
이제 시계 화면에서 setDefaultComplicationProviderWithFallbacks
를 사용하여 기본적으로 사용할 비 시스템 정보 표시 제공자를 하나 이상 지정할 수 있습니다. 지정된 비 시스템 제공자가 설치된 것이 없으면 시스템은 기본 시스템 제공자를 사용하는 것으로 대체합니다.
WearableActivity 지원 중단됨
WearableActivity
가 지원 중단되었습니다. 대신 AmbientModeSupport
를 사용하세요.
SKIP_CONFIRMATION_UI 지원 중단됨
ActionConfirmationActivity.SKIP_CONFIRMATION_UI
가 지원 중단되었습니다. 이 추가 기능은 Wear 2.0 출시 이후 사용되지 않았습니다.
2020/5/15 웨어러블 지원 라이브러리 v2.7.0
웨어러블 지원 라이브러리 버전 2.7.0에는 다음 기능이 포함되어 있습니다.
시계 화면 하드웨어 가속
이제 CanvasWatchFaceService
클래스를 사용할 때 하드웨어 가속 캔버스를 요청할 수 있습니다. 하드웨어 가속을 활용하여 시계 화면 성능을 개선하고 더 많은 UI 성능 데이터에 액세스합니다.
자세한 내용은 하드웨어 가속으로 시계 화면 성능 개선을 참고하세요.
2020/4/21 웨어러블 지원 라이브러리 v2.6.0
웨어러블 지원 라이브러리 버전 2.6.0에는 다음 개선사항이 포함되어 있습니다.
Android Jetpack으로 이전
웨어러블 지원 라이브러리가 Android Jetpack으로 이전되었습니다.
이제 기존 라이브러리는 androidx
네임스페이스를 사용하여 AndroidX에서 매핑되고 액세스할 수 있으며 지원 중단된 지원 라이브러리의 모든 종속 항목이 삭제되었습니다.
이번 변경을 통해 Android 스튜디오 4.0 이상에서 웨어러블 지원 라이브러리를 사용할 수 있으며, 문제 #147972079와 같은 문제가 해결됩니다.
2019/8/28 웨어러블 지원 라이브러리 v2.5.0
웨어러블 지원 라이브러리 버전 2.5.0에는 다음 개선사항이 포함되어 있습니다.
startActivity()가 TYPE_NO_PERMISSION 정보 표시 유형으로 호출될 때 ComplicationDrawable 수정
이제 ComplicationDrawable
에는 WatchFaceService
에서 발생한 startActivity()
호출에 android.util.AndroidRuntimeException
을 피하기 위한 FLAG_ACTIVITY_NEW_TASK
가 포함되도록 하는 NEW_TASK
플래그가 포함되어 있습니다.
이 변경사항으로 인해 시계 화면을 손상시키지 않고 TYPE_NO_PERMISSION
정보 표시 유형이 권한 요청 활동을 올바르게 실행할 수 있습니다.
2018/9/25 Wearable SDK 16.0.0
Wearable SDK 버전 16.0.0은 Google Play 서비스의 필요 버전을 12.4에서 8.6으로 낮췄습니다. 이 변경사항으로 인해 Google Play 서비스 APK를 업데이트하지 않고도 기존 앱으로 Wearable SDK 최신 버전으로 업데이트할 수 있습니다.
2018/6/11 Wear OS 개발자 프리뷰 2 업데이트
Wear OS 개발자 프리뷰 2의 최근 무선 업데이트로 백그라운드 앱의 알람과 작업이 다시 사용 설정되었습니다.
이 정책 변경으로 앱 개발의 유연성이 향상되었으나 앱 대기 버킷과 관련된 사항을 포함하여 백그라운드 알람 및 작업에는 계속해서 다른 Android P 제한사항이 적용됩니다. 앱이 어느 버킷에 있든지 정상적으로 작동할 수 있도록 권장사항을 따르세요.
또한 이 업데이트는 사용자 입력 및 센서 데이터에 대한 백그라운드 앱의 액세스를 제한하여 사용자 입력 및 데이터 개인 정보 보호를 강화합니다. 앱의 요구사항에 따라서 센서 데이터에 계속 액세스하기 위해 포그라운드 서비스를 사용해야 할 수 있습니다.
2018/5/8 Wear OS 개발자 프리뷰 2
Wear OS 개발자 프리뷰 2의 특징으로는 향상된 Google 어시스턴트 환경 등을 꼽을 수 있습니다.
Wear OS by Google Issue Tracker를 사용하여 버그 또는 의견을 제출하세요. 일찍 제출해 주실수록 수정사항이 최종 버전에 포함될 가능성이 높아집니다.
알려진 문제
이 섹션에는 프리뷰 2 출시와 관련하여 알려진 문제가 수록되어 있습니다.
Wear OS 이미지 문제
- 앱을 사용하면서 시계 옆면에 있는 전원 버튼을 누르면 시계 화면으로 돌아가지 않고 이전 화면으로 돌아가는 문제가 발생할 수 있습니다.
중국용 Wear OS 이미지 문제
- 앱을 사용하면서 시계 옆면에 있는 전원 버튼을 누르면 시계 화면으로 돌아가지 않고 이전 화면으로 돌아가는 문제가 발생할 수 있습니다.
- 볼륨 관련 알림음 설정이 유지되지 않습니다. 예를 들어 시계의 알림음이 꺼짐으로 설정되었는데도 수신 전화로 인해 시계에서 벨이 울립니다. 알람 볼륨을 조정해도 변경사항이 적용되지 않습니다.
- 진행 중인 여러 알림이 올바로 표시되지 않을 수 있습니다. 예를 들어 타이머와 스톱워치가 둘 다 설정되어 있는 경우 알림이 표시되지 않습니다. 여러 개의 알림 대신 1개의 진행 중 알림으로 앱을 테스트하는 것이 좋습니다.
- 중국 버전에서 Wear 앱 스토어가 작동하지 않습니다. 개발자가 해당 채널을 사용하여 업데이트하거나 새로운 앱을 설치할 수 없습니다. `adb`를 해결 방법으로 사용하여 테스트할 애플리케이션을 사이드로드하는 것이 좋습니다.
Wear 에뮬레이터 문제
- 연결된 스마트폰으로 걸려 오는 전화 통화가 페어링된 에뮬레이터에서 수신 전화로 표시 또는 미러링되지 않습니다.
- SDK Manager를 사용하여 Android P 또는 중국 버전을 설치하거나 설치를 확인할 때 이 선택 옆에 있는 체크박스를 선택했으나 선택이 해제될 수 있습니다. 선택 해제되면 다시 한번 선택하세요.
- 에뮬레이터가 콜드 부팅을 실행할 때 '기기 내부에 문제가 있습니다. 자세한 내용은 제조업체에 문의하세요'라는 오류가 표시될 수 있습니다. 이 문제는 기능에 영향을 미치지 않습니다. 아래로 스크롤하고 확인을 클릭하여 앱 테스트를 시작하세요.
- 에뮬레이터에서 음성 답장이 작동하지 않을 수 있습니다. 예를 들어 Wear 에뮬레이터에서 Google 행아웃 메시지 알림을 받아 메시지에 음성으로 답장하려는데 'Google이 계속해서 중지됨' 오류 메시지가 발생하면서 음성으로 답장하지 못하게 됩니다.
- Instant Run이 Wear 에뮬레이터와 호환되지 않을 수 있습니다.
- `adb`를 사용하거나 버그를 신고하는 등 프로그래매틱 방식으로 스크린샷을 캡처하는 기능이 작동하지 않을 수 있습니다. 에뮬레이터 툴바에 있는 카메라 버튼을 클릭하여 스크린샷을 캡처하여 이를 해결할 수 있습니다.
Wear 에뮬레이터의 중국 버전 문제
- 연결된 스마트폰으로 걸려 오는 전화 통화가 페어링된 에뮬레이터에서 수신 전화로 표시 또는 미러링되지 않을 수 있습니다. 따라서 부재중 전화 알림이 에뮬레이터에 표시되지 않을 수 있습니다. 또한 에뮬레이터의 호출에 응답하지 못할 수 있으며, 이 경우 전화벨이 계속 울립니다.
- SDK Manager를 사용하여 Android P 또는 중국 버전을 설치하거나 설치를 확인할 때 이 선택 옆에 있는 체크박스를 선택했으나 선택이 해제될 수 있습니다. 선택 해제되면 다시 한번 선택하세요.
- 에뮬레이터가 콜드 부팅을 실행할 때 '기기 내부에 문제가 있습니다. 자세한 내용은 제조업체에 문의하세요'라는 오류가 표시될 수 있습니다. 이 문제는 기능에 영향을 미치지 않습니다. 아래로 스크롤하고 확인을 클릭하여 앱 테스트를 시작하세요.
- Instant Run이 Wear 에뮬레이터와 호환되지 않을 수 있습니다.
- `adb`를 사용하거나 버그를 신고하는 등 프로그래매틱 방식으로 스크린샷을 캡처하는 기능이 작동하지 않을 수 있습니다. 에뮬레이터 툴바에 있는 카메라 버튼을 클릭하여 스크린샷을 캡처하여 이를 해결할 수 있습니다.
Wear의 Google 어시스턴트
Wear OS에서 어시스턴트 지원 기능이 향상되어 Android 코드를 작성하지 않고도 웨어러블에 대비한 환경을 구현할 수 있습니다. 특히 Actions on Google 플랫폼용으로 빌드할 수 있으므로 사용자가 제품과 서비스를 원활히 이용하는 데 도움이 됩니다.
또한 Wear OS에서는 이제 음성과 터치로 더 빠르게 상호작용할 수 있습니다. 추천 쿼리 칩도 지원됩니다. 다음 작업을 수행합니다.
- 사용자가 상호작용을 빠르게 완료하도록 지원
- 액션의 기능과 관련해 사용자에게 힌트 제시
또한 Wear OS는 이제 목록과 캐러셀뿐 아니라 더욱 다양한 시각적 카드도 지원합니다.
따라서 DialogFlow
, 템플릿 또는 Actions SDK를 사용하여 Wear OS용 Actions on Google을 만들 수 있습니다. 또한 새로운 시계 전용 응답 템플릿을 활용할 수 있습니다. Actions on Google 권장사항은 다음과 같습니다.
- 짧고 간결한 대화상자
- 시각 및 음성 피드백을 모두 지원
Wear OS에서 어시스턴트의 이러한 향상된 기능은 Android P에 종속되지 않고 모든 Wear 2.0 사용자에게 출시될 예정입니다. Actions on Google 빌드에 관한 소개는 Google 어시스턴트 통합하기를 참고하세요.
개발자 프리뷰 2의 배터리 절약
섹션의 다음에 설명된 내용과 같이 전력 관련 기능으로 배터리 수명을 늘릴 수 있습니다. 이 개발자 프리뷰 2 섹션에 있는 정보는 개발자 프리뷰 1의 전원 관련 정보를 대체합니다.
새로운 모드: 향상된 절전 모드
시계가 향상된 절전 모드에서 작동하는 동안에는 전원이 최적화된 기본 시계 화면이 표시됩니다. 다음 기능은 모두 사용 중지됩니다.
- 무선
- 터치 스크린
- 기울여서 절전 모드 해제 기능
사용자는 측면 버튼을 짧게 눌러 시간을 볼 수 있습니다. 길게 누르면 완전 작동 모드로 돌아가 NFC 결제 또는 메시지 회신과 같은 기능을 이용할 수 있습니다. 향상된 절전 모드에서는 앱, 시계 화면, 정보 표시 데이터 제공자를 사용할 수 없다는 점을 감안하시기 바랍니다.
백그라운드 활동 제한
전력 관리를 개선하기 위해, 시계가 충전기에 있지 않으면 백그라운드에 있는 앱은 더 이상 알람과 작업을 시작할 수 없습니다. 단, 시계 화면과 활성 상태의 정보 표시는 예외입니다.
참고: 앱이 백그라운드 모니터링과 같은 이유로 항상 실행되어야 한다면
startForegroundService()
메서드를 사용하여 포그라운드 서비스를 사용하는 것이 좋습니다. 자세한 내용은 백그라운드 서비스 제한사항을 참고하세요. 건강 모니터링과 같은 예외적인 사용 사례에 포그라운드 서비스를 사용하는 것이 적절합니다.
앱 호환성 개선
앱의 호환성을 개선하기 위해 Android P는 비 SDK 인터페이스 사용에 특정 제한사항을 구현하기 시작했습니다. SDK에서 지원하지 않는 메서드와 필드에서 벗어날 계획을 세우세요. 사용 사례에 해당하는 공개 방법이 없다면 Google에 알려 주세요.
어두운 UI 시스템 테마
2018년 초부터 Wear OS는 알림 스트림과 시스템 런처를 위해 배경색이 더 어두운 기본 UI 테마로 전환했습니다. 이번 변경사항은 앱을 더욱 쉽게 한눈에 알아볼 수 있도록 마련되었습니다. 이 새로운 UI 테마를 적용할 경우 앱의 접근성을 확인하세요.
업데이트된 Codelab 사용 가능
Wear OS를 이용한 중요한 개발 방법을 탐구하는 데 도움이 되도록 업데이트된 Codelab을 제공해 드립니다. 예를 들어 Kotlin 도메인별 언어(DSL)로 실험할 수 있는 새로운 Kotlin 기반 시계 화면 Codelab을 사용해 보세요.
2018/3/27 Wear OS 개발자 프리뷰 1
이 섹션에는 Wear OS by Google의 개발자 프리뷰 1에 관한 정보가 포함되어 있습니다. 최종 프로덕션 버전 이전에 이 미리보기에 대한 여러 업데이트가 있을 것으로 예상됩니다. 발견한 버그는 Wear OS by Google Issue Tracker를 통해 제출해 주시기 바랍니다. 일찍 제출해 주실수록 최종 버전에 수정 코드를 포함할 가능성이 커집니다.
알려진 문제
- Wear OS 호환 앱에서 웨어러블 버그 신고를 탭하면 작동하는 것처럼 보이지만 실제 버그 신고는 생성되지 않습니다.
adb bugreport
를 해결 방법으로 사용합니다. - 시계로 전화를 받는 기능이 올바로 작동하지 않을 때가 있습니다. 이런 경우 사용자는 직접 스마트폰으로 전화를 받아야 합니다.
- 'API 호환성 문제 감지됨' 오류가 미리 로드된 앱을 페어링하거나 실행한 후에 발생하는 경우가 있습니다. 이 오류 메시지는 잠시 후에 사라지며 사용성에 영향을 미치지 않습니다.
- 시계와 에뮬레이터의 설정 메뉴에서 버그 신고 옵션이 두 번 표시됩니다. 둘 중 하나만 작동하기 때문에 버그 신고를 받으려면 두 옵션을 각각 사용해 보세요. 작동하는 옵션을 탭하면 버그 신고가 생성 중임을 보여주는 토스트 메시지가 표시됩니다.
- 중국 버전에서 음성 입력을 하면 앱이 다운됩니다. 예를 들어 음성 검색을 사용하거나 음성으로 알림을 추가하면 이런 문제가 발생합니다. 이 기능이 음성 입력 API를 사용하기 때문입니다. 테스트하려면 음성 입력 대신 키보드나 필기 입력을 사용하세요.
- 중국 버전에서 Wear 앱 스토어가 작동하지 않습니다. 개발자가 해당 채널을 사용하여 업데이트하거나 새로운 앱을 설치할 수 없습니다. `adb`를 해결 방법으로 사용하여 테스트할 애플리케이션을 사이드로드하는 것이 좋습니다.
이번 개발자 프리뷰의 주요 사항
개발자 프리뷰 1에는 앱 테스트를 위한 다음 기능이 포함되어 있습니다.
-
제한된 백그라운드 활동: 전력 관리를 개선하기 위해 백그라운드에서 실행되는 앱은 더 이상 알람과 작업을 사용할 수 없습니다. 사용자가 선택한 정보 표시와 시계 화면은 예외입니다. 이 기능은 개발자 프리뷰에서 점진적으로 배포될 예정이므로 현재 사용 중인 시계에서 바로 확인하지 못할 수도 있습니다.
참고: 앱이 항상 실행되어야 한다면
startForegroundService()
메서드를 사용하여 포그라운드 서비스가 되도록 수정하세요. 자세한 내용은 백그라운드 서비스 제한사항을 참고하세요. - 앱의 비 SDK 인터페이스 사용 제한: 앱 호환성을 개선하기 위해 Android P는 특정 비 SDK 인터페이스 사용에 제한을 구현하기 시작했습니다. SDK에서 지원하지 않는 메서드와 필드에서 벗어날 계획을 세우세요. 사용 사례에 해당하는 공개 방법이 없다면 Google에 알려주세요.
- 어두운 UI 시스템 테마: 2018년 초부터 Wear OS는 알림 스트림과 시스템 런처를 위해 배경색이 더 어두운 기본 UI 테마로 전환했습니다. 이렇게 변경한 목적은 앱을 더욱 쉽게 한눈에 알아볼 수 있도록 하기 위한 것입니다. 이 새로운 UI 테마를 적용할 경우 앱의 접근성을 확인하세요.
- 시계가 몸에서 떨어지면 무선 통신 기능 종료: 전력 관리를 개선하기 위해 시계가 몸에서 일정 시간 이상 떨어져 있으면 블루투스, Wi-Fi, 셀룰러의 무선 기능이 모두 꺼집니다. 이 기능은 개발자 프리뷰에서 점진적으로 배포될 예정이므로 현재 사용 중인 시계에서 초기에는 확인하지 못할 수도 있습니다. 이 기능으로 인해 개발 프로세스에 문제가 발생하는 경우 다음 명령어로 'adb'를 사용하여 이 기능을 사용 중지할 수 있습니다.
adb shell settings put global off_body_radios_off_for_small_battery_enabled 0
- 블루투스 연결이 끊기면 Wi-Fi 기능 종료: 전력 관리를 개선하기 위해 시계가 블루투스에서 연결이 끊어지면 더 이상 Wi-Fi에 자동으로 연결하지 않습니다. 앱에서 고대역폭의 네트워크를 요구하는 경우와 시계가 충전기에 연결된 경우는 예외입니다. 이 기능은 개발자 프리뷰에서 점진적으로 배포될 예정이므로 현재 사용 중인 시계에서 초기에는 확인하지 못할 수도 있습니다.
웨어러블 지원 라이브러리 v2.3.0으로 업데이트
웨어러블 지원 라이브러리의 v2.3.0 문서 업데이트에는 리브랜딩 업데이트가 있습니다.
또한 라이브러리 v2.3.0에는 텍스트 범위에 연결된 마크업 객체가 있는 텍스트의 경우
ComplicationDrawable
및
TextRenderer
와 관련된 업데이트가 포함되어 있습니다.
이러한 클래스는 스팬 텍스트 처리를 개선했습니다.
스팬의 특정 하위 집합만 렌더링될 수 있어(그릴 수 있는 스팬 유형은
setText
메서드 참고) 시계 화면에서 렌더링된 스팬이 부자연스럽지 않습니다.
2018/3/15 Wear의 리브랜딩
이 섹션에는 Wear OS의 특징에 대한 정보가 포함되어 있습니다.
Android Wear의 새 이름
Android Wear의 이름이 Wear OS by Google로 바뀝니다.
2018/2/27 대기 모드 업데이트
이 섹션에는 새로운 Android Wear 기능에 대한 정보가 포함되어 있습니다.
대기 모드 지원을 위한 새로운 클래스
27.1.0 버전의 Android 지원 라이브러리에는 현재 지원 중단된
AmbientMode
클래스를 대체하는 새로운 클래스
AmbientModeSupport
가 포함되어 있습니다. 앞으로 몇 주 내에 샘플 업데이트가 계획되어 있습니다.
2018/1/25 최종 에뮬레이터 등
이 섹션에는 새로운 Android Wear 기능에 대한 정보가 포함되어 있습니다.
Android Emulator: Wear 업데이트
Android Emulator의 최종 Wear 관련 업데이트를 사용하여 API 버전 26 기반 앱을 테스트할 수 있습니다.
웨어러블 지원 라이브러리 v2.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의 에뮬레이터 창 내에서 전원 버튼이 작동하지 않습니다. 전원 버튼이 아닌 버튼을 대신 사용하세요. 특히 사용자가 손바닥으로 화면을 가리는 경우와 같이 대기 모드로 전환하려면 디스플레이 오른쪽에 있는 에뮬레이터 툴바의 전원 버튼을 사용하세요. 대화형 모드에서 애플리케이션 런처를 시작하려면 에뮬레이터 툴바에 있는 홈 버튼을 사용하세요.
- 중국 버전의 에뮬레이터에서는 필기 입력 방법을 사용할 경우 화면이 깜박이기 시작할 수 있습니다. 이때 터치 키보드 버튼을 클릭하면 키보드가 화면의 절반을 차단합니다.
2017/12/18 Google Play 서비스에 대한 새로운 액세스
이 섹션에는 새로운 Android Wear 기능에 대한 정보가 포함되어 있습니다.
GoogleApiClient 클래스에서 다른 클래스로 이전
Google Play 서비스 버전 11.8.0부터 Wear 앱을 GoogleApiClient
클래스에서 이전하고
GoogleApi
클래스와 Tasks API에 기반하는 API 클라이언트 객체를 대신 사용합니다.
참고: 이 업데이트는 일반적으로 Google Play 서비스 버전 10.2.0을 사용하는 중국용 Android Wear 앱에는 적용되지 않습니다.
자세한 내용은 다음을 참고하세요.
- Wear 앱을 GoogleApi로 이전
- Google API 액세스
-
Wearable
class documentation
New components for connecting with Google Play services
When you use classes that extend the
GoogleApi
class, such as
DataClient
and
MessageClient
, the Google Play services SDK manages
connections to Google Play services for you. Apps that use these classes no longer need to
create and manage GoogleApiClient
objects. See the blog post
Moving Past GoogleApiClient for more information.
For the replacements of Wear-related components for connecting to Google
Play services, see
Replacements for deprecated components.
For releases and known issues related to
Google Play services, see the Release Notes for
Google Play services.
Note: If you compile your app with the latest version of
Google Play services, users are prompted to update their devices to that
latest version. However, a known issue for apps that target API version
26 might prevent users from being prompted to update their devices. This
issue is described in the Release Notes for
Google Play services.
2017-Oct-25 Ambient mode and more
This section contains information about new Android Wear features.
Android Support Library, v27.0.0: Features and bugfixes
The
27.0.0 version of the Android Support Library contains new features
for Wear. Review the following section.
New, preferred way to support ambient mode
Ambient mode lets a Wear app remain visible to a user when the
device goes idle. The Android Support Library has a new,
preferred way for your apps to use ambient mode. The Wear team seeks
developer feedback about this significant change.
Specifically, using the
AmbientMode
class offers the following benefits:
- The
Activity
subclasses in the Android Support Library, such as
FragmentActivity
. Functionality for
support library fragments is available.
-
Architecture components, which are
lifecycle aware.
- Better support for Google
Sign-In.
Manifest metadata constants in the Android Support Library
Constants for Android Wear apps, used in the meta-data
tag
in the Android Manifest file, are now
available in the Android Support Library. To use the constants—for
standalone apps, notification bridging mode, and watch face preview
images—add a reference to the following in the dependencies section of
the app module's build.gradle
file, which requires the latest
version of the Google Repository:
Groovy
implementation 'com.android.support:wear:27.0.0'
Kotlin
implementation("com.android.support:wear:27.0.0")
Action drawer updates
Updates are available to the
WearableActionDrawerView
class, which is used for creating a wearable
action drawer. In the latest version:
- When menu items are modified, the action drawer properly updates.
- If set for an action drawer, the title displays correctly.
Inflation of the RoundedDrawable class
Assuming an API level of at least 24, the
RoundedDrawable
class can now be inflated from a drawable XML file;
see
Custom drawables.
Wearable Support Library, v2.1.0: Enhancements and more
The
2.1.0 version of the Wearable Support Library includes the updates
described in the following section, and requires Android Support Library version 26.0.2 or
higher.
Supply burn-in-safe images for ambient mode
The
ComplicationDrawable
class lets you supply burn-in-safe
images for ambient mode. Specifically, a
ComplicationData
object's burn-in protection small
image field lets a watch face display a small image in the
SMALL_IMAGE
complication type, in ambient mode, when burn-in
protection is enabled.
Tap event updates for complications
The
ComplicationDrawable
class has a new onTap
method
that lets your watch face pass tap events to complications. The new
method builds on the existing functionality in which a tap on the watch
face triggers the
WatchFaceService.Engine.onTapCommand
method.
You can pass the coordinates to a ComplicationDrawable
with
an onTap
call to launch the action associated with the
ComplicationDrawable
that contains the tap coordinates. When
the new onTap
method is called, you can use a return value
of true
to see whether a ComplicationDrawable
launched the action associated with it.
Additionally, the setHighlightDuration
method sets the
duration for a complication to remain highlighted after the
onTap
method is called.
Progress bar for ranged value complications
If you prefer to draw your own progress bar for ranged value
complications in your watch face, use the
setRangedValueProgressHidden
method of the
ComplicationDrawable
class to hide the ranged value progress
that's drawn by the ComplicationDrawable
.
2017-Oct-02 Android Wear beta
Date: 2017-Oct-02
Build: OWP4.170828.008
Supported device: LG Watch Sport
This section contains known issues for an Android Wear beta release. For
information about the beta program or to enroll,
see the
Android beta page.
Known issues
- Google Pay and its cards do not function with this Android Wear beta
release.
- Even if cellular connectivity is on, it is turned off after the beta
is installed. As a workaround, turn on cellular connectivity after
the beta is installed by navigating to
Settings > Connectivity > Cellular.
- If notifications are erratic or missing after a beta update,
or contacts were not synced, factory-reset your watch.
- In the Wear tutorial, which starts after a watch is set up, some cards
behave erratically, but they can be dismissed normally with a swipe.
- On Android 6.0 phones, phone call notifications are not
received on the watch.
- Heart rate monitoring sometimes fails after an update. As a workaround,
reboot the watch.
- The OTA card in the stream sometimes fails to enable an installation.
As a workaround, navigate to
Settings > System > About > System Updates.