Android Emulator를 사용하면 가상 기기에서 Wear OS 애플리케이션을 테스트할 수 있습니다. 이 기능의 대부분은 기본 Android Emulator 문서에 설명되어 있습니다. 이 페이지에서는 Wear OS 개발과 관련된 기능, 테스트 기능, 문제 해결 팁에 중점을 둡니다.
기본 설정 안내는 Wear OS에서 앱 만들기 및 실행하기를 참고하세요.
Wear OS 테스트 기능
에뮬레이터는 Wear OS 기능을 테스트하기 위한 전문 도구를 제공합니다.
블루투스 오디오 테스트
에뮬레이터에서 블루투스 오디오 테스트를 참고하세요.
센서 시뮬레이션
에뮬레이터는 데이터 유형에 따라 툴바에서 센서 데이터를 시뮬레이션하는 다양한 방법을 제공합니다.
- 건강 서비스 데이터:
- 에뮬레이터 툴바에서 전용 건강 관리 서비스 패널에 직접 액세스합니다 (하트 아이콘
참고). 이 패널을 사용하면 운동 측정항목과 같은 건강 관리 서비스 관련 데이터를 세밀하게 제어하여 시뮬레이션할 수 있습니다. 자세한 내용은 건강 관리 서비스로 센서 데이터 시뮬레이션을 참고하세요.
- 에뮬레이터 툴바에서 전용 건강 관리 서비스 패널에 직접 액세스합니다 (하트 아이콘
- 기타 센서 (예: 위치, 자세, 심박수):
- 다른 센서 유형의 경우 에뮬레이터 툴바에서 더보기 버튼 (...)을 클릭하여 Extended Controls 창을 엽니다.
- 위치: 확장 컨트롤 > 위치로 이동하여 단일 GPS 포인트를 제공하거나 경로를 시뮬레이션합니다. 이는 통합 위치 정보 제공자 API로 앱을 테스트하고 대략적인 위치 처리를 확인하는 데 유용합니다.
- 기기 자세 (가속도계 및 자이로스코프): Extended Controls > Virtual Sensors > Device Pose로 이동합니다. 회전 (X-Rot, Y-Rot, Z-Rot) 및 움직임 (X, Y, Z) 슬라이더를 조정하여 동작 기반 상호작용을 테스트합니다.
- 심박수 및 추가 센서: 확장 컨트롤 > 가상 센서 > 추가 센서로 이동합니다. 심박수 및 주변 온도, 자기장, 근접, 조도, 기압, 상대 습도와 같은 기타 센서를 시뮬레이션합니다.
시계 입력 시뮬레이션
- 터치 및 동작: 표준 마우스 상호작용은 터치를 모방합니다.
실제 버튼 (회전하는 측면 버튼 및 베젤 포함):
, 버튼 2 
)과 손바닥으로 가리기와 같은 기타 물리적 상호작용을 시뮬레이션할 수 있습니다.
기기를 기울여 
뒤로 스와이프합니다 
. 
기기 페어링
에뮬레이터는 실제 휴대전화 또는 가상 휴대전화와의 페어링을 지원합니다. Android 스튜디오의 기기 관리자에서 Wear OS 에뮬레이터 페어링 지원을 사용하여 안내에 따라 설정합니다. 자세한 내용은 휴대전화에 시계 연결하기를 참고하세요.
중요한 고려사항
테스트할 때는 다음 주요 기술 및 성능 고려사항을 참고하세요.
64비트 아키텍처만 (최근 이미지)
Wear OS 4 (API 33) 이상의 에뮬레이터 시스템 이미지는 64비트 아키텍처 (x86-64, arm64-v8a)만 지원합니다.
성능 차이
에뮬레이터 성능(특히 배터리 소모 및 렌더링 속도 관련)은 실제 기기와 크게 다를 수 있습니다. 최종 성능 검증 및 배터리 최적화를 위해 항상 실제 하드웨어에서 테스트하세요.
알려진 문제
이 섹션에는 Wear OS 에뮬레이터와 관련된 일반적인 문제가 나열되어 있습니다. 일반적인 에뮬레이터 문제는 기본 Android Emulator의 알려진 문제 해결 페이지를 참고하세요.
- 손목 기울기 센서 경고:
the host has not provided value yet for sensorHandle=16와 같은 로그 메시지가 반복적으로 표시될 수 있습니다. 무시해도 됩니다. - 타일 렌더러:
DashedArcLine객체와circularProgressIndicator()로 구성된 요소가 API 36 에뮬레이터에서 올바르게 렌더링되지 않을 수 있습니다.