이 페이지에서는 Android 스튜디오의 템플릿을 사용하여 Wear OS용 첫 번째 앱을 빌드하는 방법을 안내합니다. 이 앱은 Wear OS 기기에서 정보를 한눈에 볼 수 있는 다양한 방법을 보여주고, 플랫폼에서 앱을 개발하는 데 필요한 몇 가지 권장사항을 소개합니다.
이 가이드는 Android 플랫폼 및 Android 스튜디오 IDE에 관한 사전 지식을 기반으로 합니다. Android를 처음 사용하는 경우 이 Codelab을 사용하여 앱을 만들어 보세요. Android 스튜디오의 기능에 관한 자세한 내용은 Android 스튜디오 소개 페이지를 참고하세요.
Wear OS 앱 만들기
Android 스튜디오의 최신 버전을 다운로드하고 설치한 후 다음에 따라 새 프로젝트 마법사를 완료합니다.
- Android 스튜디오를 열고 File > New > New Project로 이동합니다. New Project 창이 나타납니다.
 - Templates 창에서 Wear OS를 선택합니다. 그런 다음 기본 창에서 Empty Wear App을 선택합니다.
 - 프로젝트 이름을 지정한 후 Finish를 클릭합니다. Android 스튜디오는 필요한 종속 항목을 다운로드하고 프로젝트를 빌드합니다.
 
이제 Wear OS에서 첫 번째 앱을 실행할 준비가 되었습니다.
에뮬레이터에서 앱 실행
Wear OS 앱을 실행하는 간단한 방법은 에뮬레이터를 사용하는 것입니다.
에뮬레이터 구성
Android 스튜디오에서 에뮬레이터를 구성하려면 다음 단계를 완료하세요.
- SDK Manager에서 SDK Tools 탭을 엽니다. Android SDK Platform Tools가 최신 버전인지 확인합니다. SDK Manager를 닫습니다.
 - Tools > Device Manager로 이동합니다.
 - Create (+)를 선택합니다. Virtual Device Configuration 마법사가 표시됩니다.
 - Category 창에서 Wear OS를 선택하고 Wear OS Small Round와 같은 하드웨어 프로필을 선택합니다. Next를 클릭합니다.
 - 특정 맞춤설정이 필요하지 않으면 이 화면에서 기본 설정을 유지하세요. Android 스튜디오는 기본적으로 최신 API와 시스템 이미지를 선택합니다. Finish를 클릭합니다.
 
에뮬레이터 사용에 관한 자세한 내용은 Android Emulator에서 앱을 실행하는 방법에 관한 가이드를 참고하세요.
에뮬레이터에서 앱 열기
- 기본 툴바에서 위젯 실행을 찾습니다. 기기 드롭다운 메뉴에서 생성한 에뮬레이터를 선택하고 실행 
 버튼을 클릭하여 앱을 실행합니다. - 잠시 후 에뮬레이터에 'Hello...' 메시지가 표시됩니다.
 
실제 시계에서 앱 실행(선택사항)
실제 시계에서 앱을 실행하고 디버깅하면 전체 사용자 환경을 더 효과적으로 평가할 수 있습니다. 앱이 센서나 GPU와 같은 특정 하드웨어를 사용하는 경우 특히 중요합니다.
실제 시계에서 앱을 실행하려면 테스트할 기기를 준비한 다음 개발 머신에 연결합니다.
테스트용 시계 준비
테스트용 시계를 준비하려면 다음 단계를 완료하여 ADB 디버깅을 사용 설정하세요.
- 시계에서 설정 메뉴를 엽니다.
 - 메뉴 하단으로 이동합니다. 개발자 옵션 항목이 표시되지 않으면 다음 하위 단계를 완료합니다. 개발자 옵션을 찾은 경우에는 다음 단계로 진행합니다.
- 시스템 > 정보 또는 시스템 > 정보 > 버전을 탭합니다.
 - 빌드 번호 항목을 찾아 7번 탭합니다. 시계가 PIN 또는 패턴으로 보호되는 경우 메시지가 표시되면 PIN 또는 패턴을 입력합니다.
 
 - 설정 메뉴에서 개발자 옵션을 탭합니다.
 - ADB 디버깅 옵션을 사용 설정합니다.
 
자세한 내용은 온디바이스 개발자 옵션 구성을 참고하세요.
개발 머신에 시계 연결
일부 시계는 USB를 통해 연결할 수 있습니다. 무선 연결이 필요한 시계도 있습니다.
USB를 통해 유선 연결 설정
다음 단계에 따라 시계를 연결합니다.
- USB 케이블을 사용하여 시계를 개발 머신에 연결합니다.
 - 시계에서 이 컴퓨터에서 항상 허용을 사용 설정한 다음 확인을 탭합니다.
 
무선 연결 설정
USB 포트를 통해 시계를 디버깅할 수 없는 경우 Wi-Fi를 사용하여 기기에 연결을 참고하세요.
시계에서 앱 열기
- Run Widget (기본 툴바의 일부)에서 기기 드롭다운을 사용하여 실제 기기를 선택합니다.
 - 위젯 실행에서 실행 
 버튼을 클릭합니다. - 잠시 후 기기에 'Hello...' 메시지가 표시됩니다.
 
앱 아키텍처 계획
이제 기본 앱이 실행되므로 템플릿을 넘어설 준비가 되었습니다. 새 기능을 추가하기 전에 앱을 형성하는 주요 아키텍처 결정을 생각해 보는 것이 좋습니다. 다음 섹션에서는 고려해야 할 몇 가지 중요한 질문을 살펴봅니다.
앱 모델: 독립형, 비독립형 또는 하이브리드
앱이 페어링된 휴대전화에 얼마나 의존하는지 고려하세요.
- 하이브리드 (대부분의 앱에 권장): 가장 일반적이고 유연한 접근 방식입니다. 앱의 핵심 기능은 휴대전화 없이도 작동하지만 (예: 운동 추적) 휴대전화가 연결되면 데이터 동기화 또는 더 쉬운 구성과 같은 향상된 기능을 제공합니다.
 - 독립형: 앱이 핵심 기능을 위해 휴대전화가 필요하지 않고 완전히 자체적으로 작동합니다. 오프라인으로 작동하거나 자체 인터넷 연결을 사용하는 앱에 적합합니다. '빈 Wear 앱' 템플릿은 기본적으로 독립형 앱을 만듭니다.
 - 비독립형: 앱의 핵심 기능에 휴대전화가 필요합니다.
 
이 선택에 관한 자세한 내용과 안내는 독립형 Wear OS 앱과 비독립형 Wear OS 앱 비교를 참고하세요.
사용자 인터페이스 빌드
Wear OS용 Compose는 Wear OS 앱의 UI를 빌드하는 데 권장되는 최신 선언형 프레임워크입니다. 사용된 템플릿은 Compose로 빌드되어 시작점으로 사용하기에 적합합니다.
Compose로 빌드할 때는 Wear OS용으로 특별히 설계된 라이브러리를 사용하세요. 이러한 라이브러리는 우수한 사용자 환경에 필수적인 시계에 최적화된 구성요소를 제공합니다.
예를 들어 표준 LazyColumn 대신 TransformingLazyColumn를 사용하면 원형 화면의 가장자리에 있는 항목에 자동으로 크기 조절 및 투명도 효과가 적용됩니다.
마찬가지로 탐색의 경우 Wear OS 탐색 라이브러리의 SwipeDismissableNavHost를 사용하여 시스템의 스와이프하여 닫기 동작과 통합합니다.
데이터 저장 및 동기화
데이터 관리 방식은 핵심 아키텍처 선택입니다. 온디바이스 영속성의 경우 옵션은 모바일과 동일합니다. 키-값 데이터 또는 유형이 지정된 객체에는 DataStore를 사용하고 더 복잡한 구조화된 데이터에는 Room을 사용하는 것이 좋습니다.
- 기기에 먼저 데이터 저장: 휴대전화 연결 없이도 작동할 수 있도록 필요한 데이터를 시계에 직접 저장하는 오프라인 우선 앱을 설계합니다.
 - 휴대전화와 데이터 동기화: 사용자 설정이나 운동 데이터와 같은 데이터를 호환 휴대전화 앱과 동기화하거나 스트리밍해야 하는 경우 Data Layer API를 사용하세요. 블루투스 및 Wi-Fi를 통해 작동하는 통신 채널을 제공합니다.
 
장기 실행 작업 관리
운동이나 미디어 재생과 같은 많은 핵심 Wear OS 환경은 장기 실행됩니다. 신뢰성을 유지하고 배터리를 보존하려면 이 작업을 올바르게 관리해야 합니다.
- 사용자가 시작한 장기 실행 작업: 사용자가 이동하더라도 계속되어야 하는 작업 (예: 러닝 추적)을 시작하는 경우 포그라운드 서비스를 사용해야 합니다. Wear OS에서는 이 서비스를 Ongoing Activity API와 페어링합니다. 이렇게 하면 시계 화면에 지속적인 알림과 탭 가능한 아이콘이 생성되어 사용자가 앱으로 돌아갈 수 있습니다.
 - 지연 가능한 백그라운드 작업: 즉시 발생하지 않아도 되는 작업 (예: 주기적으로 데이터 동기화)에는 WorkManager를 사용합니다. 배터리를 인식하고 잠자기 모드와 같은 시스템 최적화를 준수하므로 긴급하지 않은 백그라운드 처리에 적합합니다.
 
앱 이상의 요소 고려: 서피스 및 전원
마지막으로 Wear OS 환경은 기본 애플리케이션 그 이상이라는 점을 기억하세요.
- 다른 화면 지원: 품질이 우수하고 매력적인 앱을 만들려면 다른 손목 최적화 화면을 지원하도록 계획하세요. 빠른 작업과 정보를 위한 타일과 중요한 데이터를 사용자의 시계 화면에 직접 표시하는 정보 표시를 만드는 것이 좋습니다.
 - 전력 효율성 계획: 웨어러블 기기에서는 배터리 수명이 중요합니다. 처음부터 앱이 전력 효율적으로 설계되도록 하세요. 이는 데이터를 가져오고, 센서를 사용하고, 백그라운드 작업을 실행하는 방법에 대해 신중하게 생각해야 함을 의미합니다. 시계가 충전될 때까지 작업을 지연하는 것이 좋은 전략인 경우가 많습니다. 자세한 내용은 전력 절약 가이드를 참고하세요.
 
추천 서비스
- 참고: JavaScript가 사용 중지되어 있으면 링크 텍스트가 표시됩니다.
 - 휴대전화에 시계 연결하기
 - Wear OS에서 Jetpack Compose 사용
 - 출시 노트