Wear OS'te uygulama oluşturup çalıştı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.

Bu kılavuz, Android platformu ve Android Studio IDE ile ilgili bazı ön bilgilere dayanmaktadır. Android'e yeni başladıysanız bu codelab'i kullanarak bir uygulama oluşturun. Android Studio'nun özellikleri hakkında daha fazla bilgi edinmek için Android Studio ile Tanışın sayfasını ziyaret edin.

Not: Emülatör için kullanılabilen en yeni sistem görüntülerini kullanmak istiyorsanız Android Studio Hedgehog veya sonraki bir sürümü yükleyin.

Wear OS uygulaması oluşturma

Android Studio'nun en son sürümünü indirip yükledikten sonra "yeni proje" sihirbazını tamamlayın:

1. Android Studio'yu açın ve File > New > New Project'e (Dosya > Yeni > Yeni Proje) gidin. Yeni Proje penceresi açılır.
2. Şablonlar bölmesinde Wear OS'i seçin. Ardından, ana bölmede Empty Wear App'i (Boş Wear Uygulaması) seçin.
3. 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.

4. 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.
   Not: Wear OS'in en son kararlı sürümü olan Wear OS 5.1, Android 15'e dayanmaktadır.

   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.

Not: Yeni Proje sihirbazı, varsayılan olarak çalışmak için başka bir cihaza bağlanması gerekmeyen bağımsız bir Wear OS uygulaması oluşturur.

Wear OS uygulamaları, telefon uygulamalarından bağımsız olarak çalışmalı ve kullanıcılara telefon seçiminde en fazla esnekliği sunmalıdır. Uygulamanızın deneyimi veya karmaşıklığı nedeniyle telefona bağlanmanız gerekiyorsa saati telefona bağlama ile ilgili kılavuza bakın.

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.

Not: Wear OS uygulamalarınızı Çin'de kullanıma sunmayı planlıyorsanız Çin için Wear OS uygulamaları oluşturma sayfasını da ziyaret edin.

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:

1. 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.
2. Araçlar > Cihaz Yöneticisi'ne gidin.
3. Oluştur (+)'u seçin. Sanal Cihaz Yapılandırması sihirbazı görünür.
4. Kategori bölmesinde Wear OS'i seçin ve Wear OS Small Round gibi bir donanım profili belirleyin. İleri'yi tıklayın.

5. Ç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.

6. 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.

Emülatörleri kullanma hakkında daha fazla bilgi için Android Emülatör'de uygulamaları çalıştırma hakkındaki kılavuza bakın.

Uygulamayı emülatörde açma

1. Çalıştır > Cihaz Seç'e gidin. Yeni oluşturduğunuz emülatörü seçin.
2. Android Studio araç çubuğunda Çalıştır'ı tıklayın. Emülatör başlatılır ve uygulamanız açılır.
3. 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.

64 bit mimarileri destekleme hakkında daha fazla bilgi edinin.

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.

1. Kol saatinde Ayarlar menüsünü açın.
2. 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.
   1. Sistem > Hakkında veya Sistem > Hakkında > Sürümler'e dokunun.
   2. Derleme numarası öğesini bulup yedi kez dokunun. PIN veya desenle korunan kol saatinizde istendiğinde bu kodu ya da deseni girin.
3. Ayarlar menüsünde Geliştirici seçenekleri'ne dokunun.
4. ADB hata ayıklama seçeneğini etkinleştirin.

Kol saatini geliştirme makinesine bağlama

Bazı kol saatlerinde USB üzerinden bağlantı kurabilirsiniz. Diğerleri için kablosuz bağlantı gerekir.

USB üzerinden kablolu bağlantı kurma

Aşağıdaki adımları uygulayarak kol saatini bağlayın:

1. USB kablosu kullanarak kol saatini geliştirme makinenize bağlayın.
2. Kol saatinde Bu bilgisayardan her zaman izin ver'i etkinleştirin ve Tamam'a dokunun.

Kablosuz bağlantı kurma

Kol saatinizde USB bağlantı noktası yoksa kol saatini kablosuz veya Bluetooth kullanarak nasıl bağlayacağınızı öğrenin.

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.

1. Çalıştır > Cihaz Seç'e gidin. Makinenize bağlı kol saatini seçin.
2. Android Studio araç çubuğunda Çalıştır'ı tıklayın. Emülatör başlatılır ve uygulamanız açılır.
3. Kısa bir süre sonra saatte "Merhaba..." mesajı görünür.