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şturmanıza yönelik bir kılavuz sağlanmaktadır. Uygulama, Wear OS cihazlarda bilgileri bir bakışta görüntülemenin farklı yollarını gösterir ve platformda uygulama geliştirmeyle ilgili bazı en iyi uygulamaları sunar.

Bu kılavuzda, Android platformu ve Android Studio IDE hakkında önceden edinilmiş bazı bilgilerden yararlanılmaktadır. Android'de yeniyseniz bu codelab'i kullanarak 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 son sistem resimlerini 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çıp Dosya > Yeni > Yeni Proje'ye gidin. Yeni Proje penceresi açılır.
2. Şablonlar bölmesinde Wear OS'u seçin. Ardından, ana bölmede Wear Uygulamasını Boşalt'ı seçin.
3. Projenize bir ad verin ve Son'u tıklayın. Android Studio, gerekli bağımlılıkları indirir ve projenizin ilk sürümünü oluşturur.

4. Araçlar > SDK Yöneticisi'ne gidin, Paket Ayrıntılarını Göster'i tıklayın ve aşağıdaki paketleri yükleyin:

   • Wear OS 5.1 ARM 64 v8a sistem görüntüsünü ve Wear OS 5.1 Intel x86 Atom_64 sistem görüntüsünü içeren Android 15.0 ("VanillaIceCream") (API düzeyi 35-ext15).
   • Wear OS 5 ARM 64 v8a sistem görüntüsünü ve Wear OS 5 Intel x86 Atom_64 sistem görüntüsünü içeren Android 14.0 ("UpsideDownCake") (API düzeyi 34).
   • 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çeren Android 13.0 ("Tiramisu") (API düzeyi 33).
   Not: Wear OS'un en son kararlı sürümü olan Wear OS 5.1, Android 15'e dayanı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ıştırmak için başka bir cihaza bağlanması gerekmeyen bağımsız bir Wear OS uygulaması oluşturur.

Bir Wear OS uygulaması, telefon uygulamasından bağımsız olarak çalışmalıdır. Böylece kullanıcılar telefon seçiminde en yüksek esnekliğe sahip olur. Uygulamanızın deneyimi veya karmaşıklığı nedeniyle bir telefona bağlanmanız gerekiyorsa saati telefona bağlama ile ilgili kılavuzu inceleyin.

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ı uygulayın:

1. SDK Yöneticisi'nde SDK Araçları sekmesini açın. Android SDK Platform-Tools'un en son sürümüne sahip olduğunuzu onaylayı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 ve Wear OS Küçük Yuvarlak gibi bir donanım profili seçin. İleri'yi tıklayın.

5. Çin dışında kullanılan sistem resimleri için UpsideDownCake sürüm adını seçin. Bu sürüm Android 14.0'ı (Wear OS 5) hedefler. Çin'de kullanılan sistem resimleri için R sürüm adını seçin. Bu sürüm Android 11.0'u (Wear OS 3) hedefler. Cihaz tanımınızla eşleşen bir Wear OS 5 sistem resmi yüklü değilse Sürüm Adı'nın yanındaki İndir'i tıklayarak indirin. İleri'yi tıklayın.

   Not: Wear OS emülatörünün sistem resimleri, üçüncü taraf dosya ve kaynak kodu bildirimlerini içerir. Belirli bir sistem resmiyle ilgili üçü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örlerde.
   • $ANDROID_HOME/system-images/android-API_VERSION_NUMBER/android-wear-cn/ABI Çin'de kullanılan emülatörlerde

6. Emülatörünüze özelleştirme uygulamak istemiyorsanız 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 Emulator'da uygulama çalıştırma başlıklı kılavuzu inceleyin.

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şlar ve uygulamanızı açar.
3. Birkaç dakika sonra, emülatörde "Merhaba..." mesajını görürsünüz.

Emülatör kullanarak Bluetooth ses özelliğini test etme

Wear OS 4 veya sonraki sürümleri çalıştıran sistem resimlerinde emülatör, taklit edilmiş Bluetooth'u destekler. Bu sayede, çeşitli kullanım alanlarında Bluetooth seslerini test edebilirsiniz.

Son 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ı biliyor veya düşünüyorsanı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.

Fiziksel bir saatte uygulama çalıştırma (isteğe bağlı)

Uygulamanızı gerçek bir kol saatinde çalıştırıp hata ayıklama işlemi gerçekleştirmek, genel kullanıcı deneyimini daha iyi değerlendirmenize olanak tanır. Bu, özellikle uygulamanız sensör veya GPU gibi belirli donanımlara ihtiyaç duyuyorsa önemlidir.

Fiziksel bir kol saatinde uygulama çalıştırmak için cihazı teste hazırlayın ve ardından geliştirme makinenize bağlayın.

Kol saatini teste hazırlama

Kol saatinizi teste hazırlamak için aşağıdaki adımları uygulayarak ADB hata ayıklama özelliğini 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. Kol saatiniz PIN veya desenle korunuyorsa sizden istendiğinde PIN'i ya da deseni girin.
3. Ayarlar menüsünden 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 saatleri USB üzerinden bağlantı kurmanıza olanak tanır. Bazıları için kablosuz bağlantı gerekir.

USB üzerinden kablolu bağlantı oluşturma

Kol saatini bağlamak için aşağıdaki adımları uygulayı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ı oluşturma

Kol saatinizde USB bağlantı noktası yoksa kol saatini kablosuz ağ 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 senaryosu Wear OS'un belirli bir sürümüne bağlıysa USB (kablolu) veri bağlantısını destekleyen kol saatlerine yazılım resmi yükleyebilirsiniz. Örneğin, bir Google Pixel Watch 3 veya Google Pixel Watch 2 cihaza fabrika resmi ya da tam OTA resmi yükleyebilirsiniz.

Uygulamayı kol saatinde açma

1. Çalıştır > Cihaz Seç'e gidin. Cihazınıza bağlı olan kol saatini seçin.
2. Android Studio araç çubuğunda Çalıştır'ı tıklayın. Emülatör başlar ve uygulamanızı açar.
3. Birkaç dakika sonra saatte "Merhaba..." mesajı gösterilir.