Wear OS에서 앱을 만들고 실행하기

이 페이지에서는 Android 스튜디오의 템플릿을 사용하여 Wear OS용 첫 번째 앱을 빌드하는 방법을 안내합니다. 이 앱은 Wear OS 기기에서 정보를 한눈에 볼 수 있는 다양한 방법을 보여주고, 플랫폼에서 앱을 개발하는 데 필요한 몇 가지 권장사항을 소개합니다.

이 가이드는 Android 플랫폼 및 Android 스튜디오 IDE에 관한 사전 지식을 기반으로 합니다. Android를 처음 사용하는 경우 이 Codelab을 사용하여 앱을 만들어 보세요. Android 스튜디오의 기능에 관한 자세한 내용은 Android 스튜디오 소개 페이지를 참고하세요.

Wear OS 앱 만들기

Android 스튜디오의 최신 버전을 다운로드하고 설치한 후 다음에 따라 '새 프로젝트' 마법사를 완료합니다.

  1. Android 스튜디오를 열고 File > New > New Project로 이동합니다. New Project 창이 나타납니다.
  2. Templates 창에서 Wear OS를 선택합니다. 그런 다음 기본 창에서 Empty Wear App을 선택합니다.
  3. 프로젝트 이름을 지정한 후 Finish를 클릭합니다. Android 스튜디오는 필요한 종속 항목을 다운로드하고 프로젝트의 초기 버전을 빌드합니다.

  4. Tools > SDK Manager로 이동하여 다음 패키지를 모두 설치합니다.

    • Android 14.0 ("UpsideDownCake) (API 수준 34): 여기에는 Wear OS 5 - ARM 64 v8a 시스템 이미지 및 Wear OS 5 - Intel x86 Atom_64 시스템 이미지가 포함됩니다.
    • Android 13.0('Tiramisu') (API 수준 33) - Wear OS 4 ARM 64 v8a 시스템 이미지 및 Wear OS 4 Intel x86 Atom_64 시스템 이미지를 포함합니다.

    SDK Manager를 닫으려면 OK를 클릭합니다.

이제 Wear OS에서 첫 번째 앱을 실행할 준비가 되었습니다.

에뮬레이터에서 앱 실행

첫 번째 Wear OS 앱을 실행하는 가장 쉬운 방법은 에뮬레이터를 구성하는 것입니다.

에뮬레이터 구성

Android 스튜디오에서 에뮬레이터를 구성하려면 다음 단계를 완료하세요.

  1. SDK Manager에서 SDK Tools 탭을 엽니다. Android SDK Platform Tools가 최신 버전인지 확인합니다.
  2. Tools > Device Manager로 이동합니다.
  3. Create (+)를 선택합니다. Virtual Device Configuration 마법사가 표시됩니다.
  4. Category 창에서 Wear OS를 선택하고 Wear OS Small Round와 같은 하드웨어 프로필을 선택합니다. Next를 클릭합니다.

  5. 중국 외부에서 사용되는 시스템 이미지의 경우 UpsideDownCake 버전 이름을 선택합니다. 이 버전은 Android 14.0 (Wear OS 5)을 타겟팅합니다. 중국에서 사용되는 시스템 이미지의 경우 R 버전 이름을 선택합니다. 이 버전은 Android 11.0(Wear OS 3)을 타겟팅합니다. 기기 정의와 일치하는 Wear OS 5 시스템 이미지가 아직 설치되어 있지 않다면 Release Name 옆의 Download를 클릭하여 다운로드합니다. Next를 클릭합니다.

    참고: Wear OS 에뮬레이터용 시스템 이미지에는 서드 파티 파일 및 소스 코드에 관한 알림이 포함되어 있습니다. 다음 디렉터리에 있는 NOTICE.txt 파일을 열어서 특정 시스템 이미지의 서드 파티 알림을 볼 수 있습니다.

    • $ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear/ABI 중국 외부에서 사용되는 에뮬레이터
    • $ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear-cn/ABI 중국에서 사용되는 에뮬레이터

  6. 에뮬레이터를 맞춤설정하지 않는 한 이 화면에 대한 모든 설정의 기본값이 유지됩니다. Finish를 클릭합니다.

에뮬레이터 사용에 관한 자세한 내용은 Android Emulator에서 앱을 실행하는 방법에 관한 가이드를 참고하세요.

에뮬레이터에서 앱 열기

  1. Run > Select Device로 이동합니다. 방금 만든 에뮬레이터를 선택합니다.
  2. Android 스튜디오 툴바에서 Run 을 클릭합니다. 에뮬레이터가 시작되고 앱이 열립니다.
  3. 잠시 후 에뮬레이터에 'Hello...' 메시지가 표시됩니다.

에뮬레이터를 사용하여 블루투스 오디오 테스트

Wear OS 4 이상을 실행하는 시스템 이미지에서 에뮬레이터는 에뮬레이션된 블루투스를 지원하므로 여러 사용 사례에서 블루투스 오디오를 테스트할 수 있습니다.

최근 시스템 이미지는 64비트 아키텍처만 지원합니다.

Wear OS 4 이상용 에뮬레이터 시스템 이미지는 x86-64 및 arm64-v8a와 같은 64비트 아키텍처만 지원합니다. Kotlin 또는 Java 프로그래밍 언어로 작성되지 않은 네이티브 코드를 앱이 사용한다고 알고 있거나 추측하는 경우 앱에 32비트 및 64비트 네이티브 라이브러리가 모두 포함되어 있는지 확인하세요.

64비트 아키텍처를 지원하는 방법을 자세히 알아보세요.

실제 시계에서 앱 실행(선택사항)

실제 시계에서 앱을 실행하고 디버깅하면 전체 사용자 환경을 더 효과적으로 평가할 수 있습니다. 앱이 센서나 GPU와 같은 특정 하드웨어를 사용하는 경우 특히 중요합니다.

실제 시계에서 앱을 실행하려면 테스트할 기기를 준비한 다음 개발 머신에 연결합니다.

테스트용 시계 준비

테스트용 시계를 준비하려면 다음 단계를 완료하여 ADB 디버깅을 사용 설정하세요.

  1. 시계에서 설정 메뉴를 엽니다.
  2. 메뉴 하단으로 이동합니다. 개발자 옵션 항목이 표시되지 않으면 다음 하위 단계를 완료합니다. 개발자 옵션을 찾은 경우에는 다음 단계로 진행합니다.
    1. 시스템 > 정보 또는 시스템 > 정보 > 버전을 탭합니다.
    2. 빌드 번호 항목을 찾아 7번 탭합니다. 시계가 PIN 또는 패턴으로 보호되는 경우 메시지가 표시되면 PIN 또는 패턴을 입력합니다.
  3. 설정 메뉴에서 개발자 옵션을 탭합니다.
  4. ADB 디버깅 옵션을 사용 설정합니다.

개발 머신에 시계 연결

일부 시계는 USB를 통해 연결할 수 있습니다. 무선 연결이 필요한 시계도 있습니다.

USB를 통해 유선 연결 설정

다음 단계에 따라 시계를 연결합니다.

  1. USB 케이블을 사용하여 시계를 개발 머신에 연결합니다.
  2. 시계에서 이 컴퓨터에서 항상 허용을 사용 설정한 다음 확인을 탭합니다.

무선 연결 설정

시계에 USB 포트가 없는 경우 Wi-Fi 또는 블루투스를 사용하여 시계를 연결하는 방법을 알아보세요.

특정 버전의 Wear OS 설치(선택사항)

앱의 테스트 사례가 특정 버전의 Wear OS에 종속된 경우 USB (유선) 데이터 연결을 지원하는 시계에 소프트웨어 이미지를 플래시할 수 있습니다. 예를 들어 Google Pixel Watch 3 또는 Google Pixel Watch 2 기기에 공장 출고 시 이미지 또는 전체 OTA 이미지를 플래시할 수 있습니다.

시계에서 앱 열기

  1. Run > Select Device로 이동합니다. 머신에 연결된 시계를 선택합니다.
  2. Android 스튜디오 툴바에서 Run 을 클릭합니다. 에뮬레이터가 시작되고 앱이 열립니다.
  3. 잠시 후 'Hello...' 메시지가 시계에 표시됩니다.