시계에서 직접 실행되는 Wear OS 앱을 통해 센서, GPU와 같은 하드웨어에 액세스할 수 있습니다. 웨어러블 앱은 Android 소프트웨어 개발 키트(SDK)를 사용하는 다른 앱과 비슷하지만 디자인과 기능 면에서 다릅니다.
Wear OS 앱은 전화 앱과는 별개로 작동하여 사용자가 휴대전화를 자유롭게 선택할 수 있도록 해야 합니다. 자세한 내용은 독립형 Wear OS 앱과 비독립형 Wear OS 앱 비교를 참고하세요.
참고: Wear OS 앱 디버그에 설명된 대로 USB나 Wi-Fi, 블루투스를 사용하여 실제 시계에서 앱을 테스트할 수 있습니다. 실제 시계에서 앱을 디버깅하면 전체 사용자 환경을 더 효과적으로 평가할 수 있습니다. Android 스튜디오의 시계 에뮬레이터를 사용하여 다양한 화면 모양과 크기로 앱을 테스트할 수도 있습니다.
환경 설정
Android 스튜디오의 최신 버전을 설치합니다. Android 스튜디오에서 앱을 만드는 방법에 관한 자세한 내용은 프로젝트 개요를 참고하세요.
SDK Manager를 사용하여 Wear OS를 지원하는 최신 버전의 Android 플랫폼인 Android 11(API 수준 30)이 있는지 확인합니다.
중국에서 Wear OS 앱을 제공할 계획이라면 중국용 Wear OS 앱 만들기를 참고하세요.
Wear OS 앱 만들기
Android 스튜디오의 New Project 마법사를 사용하여 Wear OS 앱 프로젝트를 만들 수 있습니다.
Wear OS 프로젝트 시작
Android 스튜디오에서 프로젝트를 만들려면 다음 단계를 완료하세요.
- File > New > New Project를 클릭합니다.
- Project Template 창에서 Wear OS 탭을 클릭하고 Empty Compose Activity를 선택한 후 Next를 클릭합니다.
New Project 창에서 프로젝트 이름을 지정하고 표준 프로젝트 정보를 입력한 다음 Finish를 클릭합니다.
Android 스튜디오가 데이터 제공자용 앱 모듈로 프로젝트를 만듭니다.
-
앱 모듈의
build.gradle
파일에서 다음을 실행합니다.android
섹션에서compileSdkVersion
이 33으로 설정되었는지 확인합니다.android
섹션에서targetSdkVersion
이 30으로 설정되었는지 확인합니다.dependencies
섹션을 Wear OS 관련 종속 항목으로 바꿉니다.
- Android 매니페스트 파일에서
<uses-feature>
태그가 정의되어 있는지 확인합니다. 다음 예와 같이android:name="android.hardware.type.watch"
를 정의합니다.<manifest> ... <uses-feature android:name="android.hardware.type.watch" /> ... </manifest>
- Android 스튜디오 프로젝트를 동기화합니다. 새 모듈에서 코드를 실행하려면 다음 섹션에 나온 단계를 참고하세요.
에뮬레이터 시작 및 Wear OS 앱 실행
에뮬레이터를 사용하려면 Android Virtual Device(AVD)를 구성합니다. SDK Manager에서 제공하는 Android SDK 플랫폼 도구의 최신 버전이 있는지 확인합니다.
다음과 같이 AVD를 구성하고 앱을 실행합니다.
- Android 스튜디오에서 Tools > AVD Manager를 선택하여 Android Virtual Device Manager를 엽니다.
- Create Virtual Device를 클릭합니다.
- Category 창에서 Wear OS를 선택하고 하드웨어 프로필을 선택합니다. Next를 클릭합니다.
- 다운로드할 시스템 이미지를 선택합니다. 예를 들어 API Level이 30이고 Target이 'Android 11.0(Wear OS)'인 이미지를 선택합니다. Next를 클릭한 후 Finish를 클릭합니다.
- Android Virtual Device Manager를 닫습니다.
-
Android 스튜디오 툴바의 대상 기기 메뉴에서 방금 만든 AVD를 선택한 후 Run
을 클릭합니다.
AVD가 시작되고 잠시 후에 앱을 실행합니다. 'Hello...' 메시지가 표시됩니다.
AVD 사용에 관한 자세한 내용은 Android Emulator에서 앱 실행을 참고하세요.
Wear OS 프로젝트 업데이트
기존 프로젝트가 있다면 settings.gradle
파일을 업데이트해야 할 수 있습니다. google()
을 사용하여 Google Maven 저장소를 표시해야 합니다. 관련 정보는 Google의 Maven 저장소를 참고하세요.
Android 스튜디오 프로젝트의 settings.gradle
파일에 다음을 포함합니다.
dependencyResolutionManagement { ... repositories { google() jcenter() } }
경고: JCenter 저장소는 2021년 3월 31일 읽기 전용으로 변경되었습니다. 자세한 내용은 JCenter 서비스 업데이트를 참고하세요.
시계 설정
시계에 앱을 배포하는 방법은 휴대전화에 앱을 배포하는 경우와 비슷합니다.
이 섹션에서는 시계에 USB 포트가 있다고 가정합니다. 시계에 USB 포트가 없는 경우 Wi-Fi 또는 블루투스를 통해 시계를 연결하는 방법을 참고하세요.
다음과 같이 시계에서 adb
디버깅을 사용 설정합니다.
- 시계에서 설정 메뉴를 엽니다.
- 메뉴의 맨 아래로 스크롤합니다. 개발자 옵션 항목이 없는 경우 시스템, 정보를 차례로 탭합니다.
- 빌드 번호를 일곱 번 탭합니다.
- 설정 메뉴에서 개발자 옵션을 탭합니다.
- ADB 디버깅을 사용 설정합니다.
다음 단계에 따라 시계를 연결합니다.
- 시계에 앱을 직접 설치할 수 있도록 USB를 사용하여 시계를 컴퓨터에 연결합니다.
- 시계에서 이 컴퓨터에서 항상 허용을 탭하고 확인을 탭합니다.
시계를 연결한 후 앱 빌드 및 실행에 설명된 대로 배포 대상을 선택하여 앱을 실행합니다.
휴대전화 설정
이 섹션에는 Wear OS 호환 앱을 사용하여 휴대전화를 설정하는 방법에 관한 정보가 포함되어 있습니다.
참고: Wear OS 앱은 독립형이며 휴대전화와는 별개로 작동하는 것이 좋습니다. 그러나 Wear OS 앱이 모바일 앱에 종속된다면 최신 Wear OS 호환 앱으로 휴대전화를 업데이트하는 방법에 관한 다음 정보를 참고하세요.
호환 앱의 Android 버전 사용
Android 휴대전화에서 Wear OS by Google 스마트시계 앱 등록정보로 이동합니다. 업데이트를 탭하여 앱을 다운로드하고 설치합니다. 설치 후에는 앱에 자동 업데이트가 선택되어 있는지 확인합니다. 다운로드한 앱 업데이트의 '개별 Android 앱을 자동으로 업데이트하는 방법' 섹션을 참고하세요. 열기를 탭하여 앱을 시작합니다.
시계와 Android 휴대전화 페어링
휴대전화에 호환 앱을 설치한 후 필요하다면 더 이상 사용하지 않는 시계를 페어링 해제합니다. 그런 다음 휴대전화를 새로운 이미지의 시계에 페어링합니다. 이렇게 하려면 다음 단계를 완료하세요.
- 휴대전화의 기기 목록에서 시계 기기 이름을 선택합니다. 페어링 코드가 휴대전화와 시계에 표시됩니다. 코드가 일치하는지 확인합니다.
- 페어링을 탭하여 페어링 절차를 계속합니다. 시계가 휴대전화에 연결되면 확인 메시지가 표시됩니다. 휴대전화에 휴대전화의 계정이 나열된 화면이 표시됩니다.
- 추가할 Google 계정을 선택하고 시계와 동기화합니다.
- 화면 잠금을 확인하고 비밀번호를 입력하여 휴대전화에서 시계로 계정 복사를 시작합니다.
- 마법사의 안내에 따라 페어링 절차를 완료합니다.
iPhone용 호환 앱
iOS 호환 앱은 iOS 8.2 이상을 실행하는 휴대전화에서 사용할 수 있습니다. 설치하려면 다음 단계를 따르세요.
- iPhone에서 App Store를 방문하여 Wear OS by Google 호환 앱을 다운로드하고 설치합니다.
- 시계와 휴대전화에 관한 안내에 따라 페어링 절차를 시작합니다. 자세한 내용은 시계 설정 문제 해결 페이지를 참고하세요.
시계 에뮬레이터와 기기 페어링
직접 또는 Wear OS 에뮬레이터 페어링 어시스턴트를 사용하여 시계 Android Virtual Device(AVD) 또는 에뮬레이터에 기기를 페어링할 수 있습니다.
Wear OS 에뮬레이터 페어링 어시스턴트 사용
참고: Wear OS 에뮬레이터 페어링 어시스턴트를 사용하려면 휴대전화에서 Android 11(API 수준 30) 이상을 실행하고 Google Play 스토어가 설치되어 있어야 합니다. 또한 Wear 에뮬레이터가 API 수준 28 이상을 실행해야 최신 어시스턴트 기능을 사용할 수 있습니다. 에뮬레이션된 기기의 시스템 이미지를 업그레이드하려면 SDK Manager를 사용하세요.
Wear OS 에뮬레이터 페어링 어시스턴트를 사용하면 Wear 에뮬레이터를 더 쉽게 관리하고 연결할 수 있습니다. Wear 기기 여러 대를 가상 또는 실제 휴대전화 한 대와 페어링할 수 있습니다. 또한 Android 스튜디오는 이전에 페어링된 기기가 실행될 때 이를 기억하고 다시 페어링합니다.
두 기기를 페어링하려면 다음 단계를 따르세요.
- 아직 만들지 않았다면 Wear 에뮬레이터를 만듭니다.
-
기기 관리도구에서 페어링하려는 기기 옆에 있는 더보기 메뉴 아이콘을 클릭하고 Pair Wearable을 선택합니다.
그림 1. Wear 에뮬레이터와 페어링할 수 있는 기기의 더보기 메뉴 - 그러면 Wear OS 에뮬레이터 페어링 어시스턴트가 실행됩니다. 휴대전화 항목에서 Pair Wearable을 선택했다면 사용 가능한 Wear 기기 목록이 표시됩니다. Wear 기기로 시작한 경우 사용 가능한 휴대전화 목록이 표시됩니다. 페어링할 기기를 선택하고 다음을 클릭합니다.
- Android 스튜디오가 실행되고 기기를 준비하는 데는 몇 분 정도 걸릴 수 있습니다. 휴대전화에 Wear OS 호환 앱이 설치되어 있지 않다면 표시되는 메시지에 따라 Play 스토어에 로그인하여 앱을 설치한 후 설정하세요.
- 휴대전화의 Wear OS 앱에서 기기를 페어링하려면 더보기 메뉴를 클릭하고 에뮬레이터와 페어링을 선택합니다.
기기가 페어링되면 기기 관리도구가 페어링된 기기 옆에 작은 아이콘을 표시합니다. 더보기 드롭다운 메뉴를 클릭하고 세부정보 보기를 선택하여 페어링된 기기 목록을 확인할 수도 있습니다.

시계 AVD와 휴대전화 페어링
개발용 시계 AVD에서 Google 계정을 사용하려는 경우 다음을 실행하여 휴대전화를 시계 AVD와 페어링하고 Google 계정을 동기화할 수 있습니다.
- 휴대전화 설정 단계를 따릅니다.
- 휴대전화에서 개발자 옵션 및 USB 디버깅을 사용 설정합니다.
- USB를 통해 휴대전화를 컴퓨터에 연결합니다.
-
다음 명령어를 사용하여 휴대전화가 연결될 때마다 연결된 휴대전화로 AVD의 통신 포트를 전달합니다.
adb -d forward tcp:5601 tcp:5601
- 휴대전화의 Wear OS 호환 앱에서 표준 페어링 프로세스를 시작합니다. 예를 들어 시작 화면에서 설정 버튼을 탭합니다. 또는 기존 시계가 이미 페어링된 경우 왼쪽 상단 메뉴에서 새 시계 추가를 탭합니다.
- 휴대전화의 Wear OS 호환 앱에서 더보기 메뉴를 탭한 후 에뮬레이터와 페어링을 탭합니다.
- 설정 아이콘을 탭합니다.
- 기기 설정에서 에뮬레이터를 탭합니다.
- 계정을 탭하고 Google 계정을 선택합니다. 마법사의 단계에 따라 계정을 에뮬레이터와 동기화합니다. 필요한 경우, 화면 잠금 기기 비밀번호와 Google 계정 비밀번호를 입력하여 계정 동기화를 시작합니다.
여러 Wear 기기에 휴대전화 연결
두 번째 Wear 기기를 가상 또는 실제 휴대전화에 연결하려면 초기 페어링과 동일한 단계를 따릅니다. 기기 관리도구에서 페어링하려는 휴대전화나 Wear 기기를 찾고 더보기 메뉴 아이콘을 클릭하여 Pair Wearable을 클릭합니다.
프로젝트에 Wear OS 모듈 추가
Android 스튜디오에서 기존 프로젝트에 Wear OS 기기용 모듈을 추가하여 모바일 앱의 코드를 재사용할 수 있습니다.
기존 프로젝트에서 Wear OS 모듈 만들기
Wear OS 모듈을 만들려면 기존 Android 스튜디오 프로젝트를 열고 다음 작업을 실행하세요.
- File > New > New Module을 클릭합니다.
- New Module 창에서 Wear OS Module을 선택하고 Next를 클릭합니다.
- Configure the new module에서 다음을 입력합니다.
- Application/Library Name: 새 모듈의 앱 런처 아이콘 제목입니다.
- Module Name: 소스 코드 및 리소스 파일의 폴더 이름입니다.
- Package Name: 모듈 코드의 자바 네임스페이스입니다. 이 문자열은 모듈의 Android 매니페스트 파일에서
package
속성으로 추가됩니다. - Minimum SDK: 앱 모듈이 지원하는 플랫폼의 가장 낮은 버전입니다. 예를 들어 API 26: Android 8.0을 선택합니다.
이 값은
build.gradle
파일의minSdkVersion
속성을 설정하며, 나중에 수정할 수 있습니다.
- Next를 클릭합니다. 여러 코드 템플릿 옵션이 표시됩니다. Blank Wear OS Activity를 선택하고 Next를 클릭합니다.
- Configure Activity 창에서 Activity Name, Layout Name, Source Language에 관해 기본값을 적용하거나 값을 입력합니다. Finish를 클릭합니다.
Android 스튜디오에서 새 모듈의 파일을 만들고 동기화합니다. Android 스튜디오는 Wear OS에 필요한 모든 종속 항목도 새 모듈의 빌드 파일에 추가합니다. 새 모듈이 화면 왼쪽의 Project 창에 나타납니다. 새 모듈의 폴더가 보이지 않으면 창에 Android 뷰가 표시되는지 확인합니다.
새 Wear OS 모듈의 build.gradle
파일에 다음을 포함합니다.
-
android
섹션에서compileSdkVersion
의 값을 33으로,targetSdkVersion
의 값을 30으로 설정합니다. - 필요한 종속 항목을 추가합니다. 자세한 내용은 종속 항목 선언을 참고하세요.
- Android 스튜디오 프로젝트를 동기화합니다. 새 모듈에서 코드를 실행하려면 에뮬레이터 시작 및 Wear OS 앱 실행을 참고하세요.
라이브러리 포함
참고: Wear OS 개발에는 프로젝트 설정, 라이브러리 포함, 패키징을 제공하는 Android 스튜디오를 사용하세요.
Android 스튜디오의 Project Wizard를 사용할 때 마법사가 적절한 모듈의 build.gradle
파일에 있는 종속 항목을 가져옵니다.
그러나 종속 항목이 모든 앱에 필요한 것은 아닙니다.
종속 항목에 관한 아래 정보를 검토하세요.
기존 Wear OS 프로젝트를 최신 SDK 버전으로 업데이트하려면 Wear OS 프로젝트 시작 섹션에 나열된 설정을 사용합니다.
알림
알림의 종속 항목에 관한 자세한 내용은 Wear에서 알림 만들기를 참고하세요.
Wear OS용 UI 빌드
Compose는 Wear OS 앱용 사용자 인터페이스를 빌드하는 데 권장되는 방식입니다. Wear OS용 Compose는 Wear OS 폼 팩터를 위해 설계된 구성요소를 20개 넘게 제공합니다. 이는 뷰 기반 레이아웃에서 사용할 수 있는 구성요소보다 훨씬 많습니다. 이러한 구성요소는 Wear OS용 최신 Material Design 가이드라인을 준수하는 사용자 환경을 만드는 데 도움이 되도록 설계되었습니다.
그러나 뷰로 빌드하려면 Wear OS UI 라이브러리의 종속 항목을 추가합니다. 자세한 내용은 Wear OS에서 뷰 기반 UI 빌드를 참고하세요.
Play 서비스 및 Wearable Data Layer API
앱이 데이터 동기화 및 전송(Data Layer API 사용)이나 다른 이유로 Google Play 서비스를 사용한다면 Google Play 서비스의 최신 버전이 필요합니다. 이러한 API를 사용하지 않는 경우 종속 항목을 제거합니다.
시계의 전력 절약
시계가 유휴 상태이거나 사용자가 손바닥으로 화면을 가리면 시계는 대화형 모드에서 대기 모드로 전환됩니다.
시계의 전력을 절약하려면 대기 모드를 사용하지 마세요. 앱이 활성 상태일 때 시계가 시스템 대기 모드로 전환되고 사용자가 지정된 시간 내에 시계와 다시 상호작용하면 해당 앱이 사용자에게 가장 먼저 표시됩니다.
특정 사용 사례에 맞게 앱의 대기 모드를 재정의하는 것이 좋습니다. 예를 들어 사용자가 달리기를 추적하며 시간을 계속 확인해야 한다면 대기 모드를 재정의합니다.
대기 모드로 전환될 수 있는 시계 앱을 상시 사용 설정 앱이라고 합니다. 아래에서는 상시 사용 설정 앱의 두 가지 작동 모드를 설명합니다.
- 대화형
- 이 모드에서는 유동적인 애니메이션과 전체 색상을 사용합니다. 또한 앱이 입력에 응답합니다.
- 대기
- 이 모드에서는 흑백 그래픽으로 화면을 렌더링하고 입력 힌트를 표시하지 않습니다. 이 표시 모드는 Android 5.1 이상을 실행하는 기기에서만 지원됩니다.
자세한 내용과 권장사항은 Wear OS에서 앱 표시 유지를 참고하세요.