Category 창에서 Wear OS를 선택하고 Wear OS Small Round와 같은 하드웨어 프로필을 선택합니다. Next를 클릭합니다.
중국 외부에서 사용되는 시스템 이미지의 경우 UpsideDownCake 버전 이름을 선택합니다. 이 버전은 Android 14.0 (Wear OS 5)을 타겟팅합니다. 중국에서 사용되는 시스템 이미지의 경우 R 버전 이름을 선택합니다. 이 버전은 Android 11.0(Wear OS 3)을 타겟팅합니다. 기기 정의와 일치하는 Wear OS 5 시스템 이미지가 아직 설치되어 있지 않다면 버전 이름 옆의 Download를 클릭하여 다운로드합니다. 다음을 클릭합니다.
참고: 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
중국에서 사용되는 에뮬레이터
에뮬레이터를 맞춤설정하지 않는 한 이 화면에 대한 모든 설정의 기본값이 유지됩니다. Finish를 클릭합니다.
Android 스튜디오 툴바에서 Run을 클릭합니다. 에뮬레이터가 시작되고 앱이 열립니다.
잠시 후 에뮬레이터에 'Hello...' 메시지가 표시됩니다.
에뮬레이터를 사용하여 블루투스 오디오 테스트
Wear OS 4 이상을 실행하는 시스템 이미지에서 에뮬레이터는 에뮬레이션된 블루투스를 지원하므로 여러 사용 사례에서 블루투스 오디오를 테스트할 수 있습니다.
최근 시스템 이미지는 64비트 아키텍처만 지원합니다.
Wear OS 4 이상의 에뮬레이터 시스템 이미지는 x86-64 및 arm64-v8a이라는 64비트 아키텍처만 지원합니다. Kotlin 또는 Java 프로그래밍 언어로 작성되지 않은 네이티브 코드를 앱이 사용한다고 알고 있거나 추측하는 경우 앱에 32비트 및 64비트 네이티브 라이브러리가 모두 포함되어 있는지 확인하세요.
앱의 테스트 사례가 특정 버전의 Wear OS에 종속된 경우 USB (유선) 데이터 연결을 지원하는 시계에 소프트웨어 이미지를 플래시할 수 있습니다. 예를 들어 Google Pixel Watch 3 또는 Google Pixel Watch 2 기기에 공장 출고 시 이미지 또는 전체 OTA 이미지를 플래시할 수 있습니다.
시계에서 앱 열기
Run > Select Device로 이동합니다. 머신에 연결된 시계를 선택합니다.
Android 스튜디오 툴바에서 Run을 클릭합니다. 에뮬레이터가 시작되고 앱이 열립니다.
이 페이지에 나와 있는 콘텐츠와 코드 샘플에는 콘텐츠 라이선스에서 설명하는 라이선스가 적용됩니다. 자바 및 OpenJDK는 Oracle 및 Oracle 계열사의 상표 또는 등록 상표입니다.
최종 업데이트: 2025-07-27(UTC)
[null,null,["최종 업데이트: 2025-07-27(UTC)"],[],[],null,["# Create and run an app on Wear OS\n\nThis page provides a guide for you to build your first app for Wear OS, using a\ntemplate from Android Studio. The app showcases the different ways to view\ninformation at a glance on Wear OS devices, and introduces some best practices\nfor developing apps on the platform.\n\nThis guide builds upon some prior knowledge about the Android platform and the\n[Android Studio IDE](/studio). If you're completely new to Android, [create an app\nusing this codelab](/codelabs/basic-android-kotlin-compose-first-app#1). To learn more about Android Studio's capabilities, visit\nthe [Meet Android Studio](/studio/intro) page.\n| **Note:** To use the latest system images that are available for the emulator, install Android Studio Hedgehog or later.\n\nCreate a Wear OS app\n--------------------\n\nAfter you download and install the latest version of Android Studio, complete\nthe \"new project\" wizard:\n\n1. Open Android Studio, and then go to **File \\\u003e New \\\u003e New Project** . The **New Project** window appears.\n2. In the **Templates** pane, select **Wear OS** . Then, in the main pane, select **Empty Wear App**.\n3. Name your project, and then click **Finish**. Android Studio downloads the necessary dependencies and builds the initial version of your project.\n4. Go to [**Tools \\\u003e SDK Manager**](/studio/intro/update#sdk-manager), click **Show Package Details**, and\n install the following packages:\n\n - **Android 15.0 (\"VanillaIceCream\")** (API level 35-ext15), which includes the **Wear OS 5.1 ARM 64 v8a System Image** and the **Wear OS 5.1 Intel x86 Atom_64 System Image**.\n - **Android 14.0 (\"UpsideDownCake\")** (API level 34), which includes the **Wear OS 5 ARM 64 v8a System Image** and the **Wear OS 5 Intel x86 Atom_64 System Image**.\n - **Android 13.0 (\"Tiramisu\")** (API level 33), which includes the **Wear OS 4 ARM 64 v8a System Image** and the **Wear OS 4 Intel x86 Atom_64\n System Image**.\n\n | **Note:** The latest stable version of Wear OS, Wear OS 5.1, is based on Android 15.\n\n To close the SDK Manager, click **OK**.\n\nYou're now ready to run your first app on Wear OS.\n| **Note:** By default, the **New Project** wizard creates a standalone, independent Wear OS app that doesn't need to connect to another device in order to run. \n|\n| A Wear OS app should work independently of a phone app, giving users the greatest flexibility in their choice of phones. If your app's experience or complexity requires you to connect to a phone, see the guide on how to [connect\n| a watch to a phone](/training/wearables/get-started/connect-phone).\n\nRun an app on the emulator\n--------------------------\n\nThe easiest way to run your first Wear OS app is to configure an emulator.\n| **Note:** If you plan to make your Wear OS apps available in China, also visit the [Create Wear OS apps for China](/training/wearables/apps/creating-app-china) page.\n\n### Configure an emulator\n\nTo configure an emulator in Android Studio, complete the following steps:\n\n1. In the SDK Manager, Open the **SDK Tools** tab. Confirm that you have the latest version of **Android SDK Platform-Tools**. Close the SDK Manager.\n2. Go to **Tools \\\u003e Device Manager**.\n3. Select **Create (+)** . The **Virtual Device Configuration** wizard appears.\n4. In the **Category** pane, select **Wear OS** and choose a hardware profile, such as **Wear OS Small Round** . Click **Next**.\n5. For system images used outside of China, select the **UpsideDownCake**\n release name. This release targets Android 14.0 (Wear OS 5). For\n system images used in China, select the **R** release name. This release\n targets Android 11.0 (Wear OS 3). If you don't already have a Wear OS 5\n system image installed that matches your device definition, click\n **Download** next to the **Release Name** to get it. Click **Next**.\n\n **Note:** System images for the Wear OS emulator include notices of\n third-party files and source code. You can view third-party notices for a\n particular system image by opening the `NOTICE.txt` file, which\n is in one of the following directories:\n - `$ANDROID_HOME/system-images/android-`\u003cvar translate=\"no\"\u003eAPI_VERSION_NUMBER\u003c/var\u003e`/android-wear/`\u003cvar translate=\"no\"\u003eABI\u003c/var\u003e for emulators used outside of China.\n - `$ANDROID_HOME/system-images/android-`\u003cvar translate=\"no\"\u003eAPI_VERSION_NUMBER\u003c/var\u003e`/android-wear-cn/`\u003cvar translate=\"no\"\u003eABI\u003c/var\u003e for emulators used in China.\n6. You can keep the default value for all the settings on this screen, unless\n you want to customize your emulator. Click **Finish**.\n\nFor more information about using emulators, see the guide about how to [run apps\non the Android Emulator](/studio/run/emulator).\n\n### Open the app in the emulator\n\n1. Go to **Run \\\u003e Select Device**. Choose the emulator that you just created.\n2. In the Android Studio toolbar, click **Run** . The emulator starts and opens your app.\n3. After a few moments, you should see a \"Hello...\" message in the emulator.\n\n### Test Bluetooth audio using the emulator\n\nOn system images the run Wear OS 4 or higher, the emulator supports emulated\nBluetooth, which lets you [test Bluetooth audio](/training/wearables/apps/test-bluetooth-audio) across several use cases.\n\n### Recent system images only support 64-bit architectures\n\nThe emulator system images for Wear OS 4 and higher only support these 64-bit\narchitectures: `x86-64` and `arm64-v8a`. If you know or suspect that your app\nuses native code (that isn't written in the Kotlin or Java programming\nlanguages), check that your app includes both 32-bit and 64-bit native\nlibraries.\n\nLearn more about how to [support 64-bit architectures](/google/play/requirements/64-bit).\n\nRun an app on a physical watch (optional)\n-----------------------------------------\n\nRunning and debugging your app on an actual watch lets you better evaluate the\ntotal user experience. This is particularly important if your app relies on\nspecific hardware, such as sensors or a GPU.\n\nTo run an app on a physical watch, prepare the device for testing, and then\nconnect it to your development machine.\n\n### Prepare watch for testing\n\nTo prepare your watch for testing, enable ADB debugging by completing the\nfollowing steps.\n\n1. On the watch, open the **Settings** menu.\n2. Go to the bottom of the menu. If no **Developer options** item appears, complete the following sub-steps. Otherwise, continue to the next step.\n 1. Tap **System \\\u003e About** or **System \\\u003e About \\\u003e Versions**.\n 2. Find the **Build number** item and tap it seven times. If your watch is protected by a PIN or pattern, enter it when prompted to do so.\n3. From the **Settings** menu, tap **Developer options**.\n4. Enable the **ADB debugging** option.\n\n### Connect watch to development machine\n\nSome watches let you connect over USB. Others require a wireless connection.\n\n#### Set up a wired connection over USB\n\nConnect the watch using the following steps:\n\n1. Using a USB cable, connect the watch to your development machine.\n2. On the watch, enable **Always allow from this computer** , and then tap **OK**.\n\n#### Set up a wireless connection\n\nIf your watch lacks a USB port, learn how to [connect a watch using Wi-Fi or\nBluetooth](/training/wearables/apps/debugging).\n\n### Install a specific version of Wear OS (optional)\n\nIf your app's test case depends on a specific version of Wear OS, you can flash\na software image onto watches that support a USB (wired) data connection. For\nexample, you can flash a [factory image](https://developers.google.com/android/images-watch) or a [full OTA image](https://developers.google.com/android/ota-watch)\nonto a Google Pixel Watch 3 or Google Pixel Watch 2 device.\n\n### Open the app on the watch\n\n1. Go to **Run \\\u003e Select Device**. Choose the watch that is connected to your machine.\n2. In the Android Studio toolbar, click **Run** . The emulator starts and opens your app.\n3. After a few moments, you should see a \"Hello...\" message appear on the watch.\n\nRecommended for you\n-------------------\n\n- Note: link text is displayed when JavaScript is off\n- [Integrate custom C/C++ build systems using Ninja (experimental)](/build/cxx-ninja)\n- [Vulkan validation layers on Android](/ndk/guides/graphics/validation-layer)\n- [Release notes](/training/wearables/versions/5/release-notes)"]]
을 클릭합니다. 에뮬레이터가 시작되고 앱이 열립니다.