Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
Bu sayfada, Android Studio'daki bir şablonu kullanarak Wear OS için ilk uygulamanızı oluşturmayla ilgili bir kılavuz yer almaktadır. Uygulama, Wear OS cihazlarda bilgileri bir bakışta görmenin farklı yollarını gösteriyor ve platformda uygulama geliştirme ile ilgili bazı en iyi uygulamaları tanıtıyor.
Android Studio'nun en son sürümünü indirip yükledikten sonra "yeni proje" sihirbazını tamamlayın:
Android Studio'yu açın ve File > New > New Project'e (Dosya > Yeni > Yeni Proje) gidin. Yeni Proje penceresi açılır.
Şablonlar bölmesinde Wear OS'i seçin. Ardından, ana bölmede Empty Wear App'i (Boş Wear Uygulaması) seçin.
Projenizi adlandırın ve Bitir'i tıklayın. Android Studio, gerekli bağımlılıkları indirir ve projenizin ilk sürümünü oluşturur.
Tools > SDK Manager'a gidin, Show Package Details'ı (Paket Ayrıntılarını Göster) tıklayın ve aşağıdaki paketleri yükleyin:
Android 15.0 ("VanillaIceCream") (API düzeyi 35-ext15). Bu sürümde Wear OS 5.1 ARM 64 v8a Sistem Görüntüsü ve Wear OS 5.1 Intel x86 Atom_64 Sistem Görüntüsü bulunur.
Android 14.0 ("UpsideDownCake") (API düzeyi 34), Wear OS 5 ARM 64 v8a Sistem Görüntüsü ve Wear OS 5 Intel x86 Atom_64 Sistem Görüntüsü'nü içerir.
Android 13.0 ("Tiramisu") (API düzeyi 33), Wear OS 4 ARM 64 v8a Sistem Görüntüsü ve Wear OS 4 Intel x86 Atom_64 Sistem Görüntüsü'nü içerir.
SDK Yöneticisi'ni kapatmak için Tamam'ı tıklayın.
Artık Wear OS'te ilk uygulamanızı çalıştırmaya hazırsınız.
Emülatörde uygulama çalıştırma
İlk Wear OS uygulamanızı çalıştırmanın en kolay yolu bir emülatör yapılandırmaktır.
Emülatör yapılandırma
Android Studio'da bir emülatör yapılandırmak için aşağıdaki adımları tamamlayın:
SDK Manager'da SDK Tools (SDK Araçları) sekmesini açın. Android SDK Platform-Tools'un en yeni sürümüne sahip olduğunuzu onaylayın. SDK Yöneticisi'ni kapatın.
Araçlar > Cihaz Yöneticisi'ne gidin.
Oluştur (+)'u seçin. Sanal Cihaz Yapılandırması sihirbazı görünür.
Kategori bölmesinde Wear OS'i seçin ve Wear OS Small Round gibi bir donanım profili belirleyin. İleri'yi tıklayın.
Çin dışında kullanılan sistem görüntüleri için UpsideDownCake sürüm adını seçin. Bu sürüm Android 14.0'ı (Wear OS 5) hedefliyor. Çin'de kullanılan sistem görüntüleri için R sürüm adını seçin. Bu sürüm, Android 11.0 (Wear OS 3) sürümünü hedeflemektedir. Cihaz tanımınıza uygun bir Wear OS 5 sistem görüntüsü yüklü değilse Sürüm Adı'nın yanındaki İndir'i tıklayarak görüntüyü edinin. İleri'yi tıklayın.
Not: Wear OS emülatörü için sistem görüntüleri, üçüncü taraf dosyaları ve kaynak koduyla ilgili bildirimler içerir. Belirli bir sistem görüntüsünün üçüncü taraf bildirimlerini, aşağıdaki dizinlerden birinde bulunan NOTICE.txt dosyasını açarak görüntüleyebilirsiniz:
$ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear/ABI
Çin dışında kullanılan emülatörler için.
$ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear-cn/ABI
for emulators used in China.
Emülatörünüzü özelleştirmek istemediğiniz sürece bu ekrandaki tüm ayarların varsayılan değerini koruyabilirsiniz. Son'u tıklayın.
Çalıştır > Cihaz Seç'e gidin. Yeni oluşturduğunuz emülatörü seçin.
Android Studio araç çubuğunda Çalıştır'ı
tıklayın. Emülatör başlatılır ve uygulamanız açılır.
Kısa bir süre sonra emülatörde "Merhaba..." mesajını görmeniz gerekir.
Emülatörü kullanarak Bluetooth sesini test etme
Wear OS 4 veya daha yeni sürümlerin yüklü olduğu sistem görüntülerinde emülatör, emüle edilmiş Bluetooth'u destekler. Bu sayede, Bluetooth sesini test edebilirsiniz.
En yeni sistem görüntüleri yalnızca 64 bit mimarileri destekler
Wear OS 4 ve sonraki sürümler için emülatör sistem görüntüleri yalnızca şu 64 bit mimarileri destekler: x86-64 ve arm64-v8a. Uygulamanızın yerel kod (Kotlin veya Java programlama dillerinde yazılmamış) kullandığını biliyorsanız ya da bundan şüpheleniyorsanız uygulamanızın hem 32 bit hem de 64 bit yerel kitaplıklar içerdiğinden emin olun.
Uygulamayı fiziksel bir kol saatinde çalıştırma (isteğe bağlı)
Uygulamanızı gerçek bir kol saatinde çalıştırmak ve hatalarını ayıklamak, toplam kullanıcı deneyimini daha iyi değerlendirmenizi sağlar. Bu, özellikle uygulamanız sensörler veya GPU gibi belirli donanımlara bağlıysa önemlidir.
Bir uygulamayı fiziksel bir kol saatinde çalıştırmak için cihazı teste hazırlayın ve ardından geliştirme makinenize bağlayın.
Saati teste hazırlama
Saatinizi test için hazırlamak üzere aşağıdaki adımları uygulayarak ADB hata ayıklamayı etkinleştirin.
Kol saatinde Ayarlar menüsünü açın.
Menünün alt kısmına gidin. Geliştirici seçenekleri öğesi görünmüyorsa aşağıdaki alt adımları tamamlayın. Aksi takdirde bir sonraki adıma geçin.
Sistem > Hakkında veya Sistem > Hakkında > Sürümler'e dokunun.
Derleme numarası öğesini bulup yedi kez dokunun. PIN veya desenle korunan kol saatinizde istendiğinde bu kodu ya da deseni girin.
Wear OS'in belirli bir sürümünü yükleme (isteğe bağlı)
Uygulamanızın test durumu Wear OS'in belirli bir sürümüne bağlıysa USB (kablolu) veri bağlantısını destekleyen kol saatlerine yazılım görüntüsü yükleyebilirsiniz. Örneğin, Google Pixel Watch 3 veya Google Pixel Watch 2 cihazına fabrika görüntüsü ya da tam OTA görüntüsü yükleyebilirsiniz.
Uygulamayı kol saatinde açın.
Çalıştır > Cihaz Seç'e gidin. Makinenize bağlı kol saatini seçin.
Android Studio araç çubuğunda Çalıştır'ı
tıklayın. Emülatör başlatılır ve uygulamanız açılır.
Kısa bir süre sonra saatte "Merhaba..." mesajı görünür.
Sizin için önerilenler
Not: JavaScript kapalıyken bağlantı metni gösterilir.
Bu sayfadaki içerik ve kod örnekleri, İçerik Lisansı sayfasında açıklanan lisanslara tabidir. Java ve OpenJDK, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-07-27 UTC.
[[["Anlaması kolay","easyToUnderstand","thumb-up"],["Sorunumu çözdü","solvedMyProblem","thumb-up"],["Diğer","otherUp","thumb-up"]],[["İhtiyacım olan bilgiler yok","missingTheInformationINeed","thumb-down"],["Çok karmaşık / çok fazla adım var","tooComplicatedTooManySteps","thumb-down"],["Güncel değil","outOfDate","thumb-down"],["Çeviri sorunu","translationIssue","thumb-down"],["Örnek veya kod sorunu","samplesCodeIssue","thumb-down"],["Diğer","otherDown","thumb-down"]],["Son güncelleme tarihi: 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)"]]
tıklayın. Emülatör başlatılır ve uygulamanız açılır.