İlk Wear OS uygulamanızı oluşturma ve çalıştırma

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österir ve platformda uygulama geliştirme ile ilgili bazı en iyi uygulamaları tanıtır.

Bu kılavuz, Android platformu ve Android Studio IDE hakkında önceden edinilmiş bazı bilgiler üzerine kurulmuştur. 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 Meet Android Studio sayfasını ziyaret edin.

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 (Dosya > Yeni > Yeni Proje) seçeneğine 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 projenizi oluşturur.

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. Uygulamanızın deneyimi veya karmaşıklığı nedeniyle telefona bağlanmanız gerekiyorsa kol saatini telefona bağlama ile ilgili kılavuza bakın.

Emülatörde uygulama çalıştırma

Wear OS uygulamanızı çalıştırmanın basit bir yolu emülatör kullanmaktı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:

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. Belirli özelleştirmelere ihtiyacınız yoksa bu ekrandaki varsayılan ayarları koruyun. Android Studio, varsayılan olarak en son API'yi ve sistem görüntüsünü seçer. Son'u tıklayın.

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

Uygulamayı emülatörde açma

1. Ana araç çubuğunda Widget'ı Çalıştır'ı bulun. Cihaz açılır menüsünden oluşturduğunuz emülatörü seçin ve uygulamayı başlatmak için Çalıştır düğmesini tıklayın.
2. Birkaç saniye sonra emülatörde "Merhaba..." mesajı görünür.

Uygulamayı fiziksel bir kol saatinde çalıştırma (isteğe bağlı)

Uygulamanızı fiziksel 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 teste hazırlamak için 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 PIN'i 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.

Daha fazla bilgi için Cihazdaki geliştirici seçeneklerini yapılandırma başlıklı makaleyi inceleyin.

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

Saatinizde USB bağlantı noktası üzerinden hata ayıklama mümkün değilse Cihazınıza kablosuz ağ kullanarak bağlanma başlıklı makaleyi inceleyin.

Uygulamayı kol saatinde açın.

1. Run Widget'ta (ana araç çubuğunun bir parçası) cihaz açılır listesini kullanarak fiziksel cihazınızı seçin.
2. Widget'ı Çalıştır'da Çalıştır düğmesini tıklayın.
3. Kısa bir süre sonra cihazınızda "Merhaba..." mesajı görünür.

Uygulama mimarinizi planlama

Artık temel bir uygulamanız çalıştığına göre şablonun ötesine geçmeye hazırsınız. Yeni özellikler eklemeye başlamadan önce uygulamanızı şekillendirecek temel mimari kararlar hakkında düşünmeniz faydalı olur. Aşağıdaki bölümlerde, göz önünde bulundurmanız gereken bazı önemli sorular ele alınmaktadır.

Uygulama modeli: Bağımsız, bağımsız olmayan veya karma

Uygulamanızın eşlenmiş bir telefona ne kadar bağlı olduğunu göz önünde bulundurun:

• Karma (çoğu uygulama için önerilir): Bu, en yaygın ve esnek yaklaşımdır. Uygulamanın temel özellikleri telefonsuz çalışır (ör. antrenman takibi). Ancak telefon bağlandığında veri senkronizasyonu veya daha kolay yapılandırma gibi gelişmiş işlevler sunar.
• Bağımsız: Uygulamanız, temel özellikler için telefon gerektirmeden tamamen kendi başına çalışır. Bu, çevrimdışı çalışabilen veya kendi internet bağlantısını kullanan uygulamalar için idealdir. "Empty Wear App" (Boş Wear Uygulaması) şablonu, varsayılan olarak bağımsız bir uygulama oluşturur.
• Bağımsız olmayan: Uygulamanızın temel işlevi için telefon gerekir.

Bu seçimle ilgili daha fazla bilgi ve rehberlik için Bağımsız ve bağımsız olmayan Wear OS uygulamaları başlıklı makaleyi inceleyin.

Kullanıcı arayüzünüzü oluşturma

Compose for Wear OS, Wear OS uygulamaları için kullanıcı arayüzleri oluşturmanın önerilen yolu olan modern bir bildirimsel çerçevedir. Kullandığınız şablon, Compose ile oluşturulduğu için iyi bir başlangıç noktası sunar.

Compose ile geliştirme yaparken Wear OS için özel olarak tasarlanmış kitaplıkları kullanın. Bunlar, mükemmel bir kullanıcı deneyimi için gerekli olan, kol saatine göre optimize edilmiş bileşenler sağlar.

Örneğin, standart LazyColumn yerine, yuvarlak ekranın kenarındaki öğelere otomatik olarak ölçeklendirme ve şeffaflık efektleri uygulayan TransformingLazyColumn öğesini kullanın.

Benzer şekilde, gezinme için SwipeDismissableNavHost öğesini Wear OS Navigation kitaplığından kullanarak sistemin kaydırarak kapatma hareketiyle entegre edin.

Veri depolama ve senkronizasyon

Verileri nasıl yönettiğiniz, temel bir mimari tercihtir. Cihazda kalıcılık için seçenekleriniz mobil cihazlardakiyle aynıdır. Anahtar-değer verileri veya türü belirlenmiş nesneler için DataStore, daha karmaşık ve yapılandırılmış veriler için ise Room önerilen modern seçeneklerdir.

• Verileri önce cihazda depolayın: Uygulamanızı önce çevrimdışı olacak şekilde tasarlayın. Gerekli verileri doğrudan kol saatinde depolayarak telefon bağlantısı olmadan da çalışmasını sağlayın.
• Verileri telefonla senkronize etme: Kullanıcı ayarları veya egzersiz verileri gibi verileri yardımcı telefon uygulamasıyla senkronize etmeniz ya da aktarmanız gerektiğinde Data Layer API'yi kullanın. Bluetooth ve kablosuz bağlantı üzerinden çalışan bir iletişim kanalı sağlar.

Uzun süren işleri yönetme

Egzersiz veya medya oynatma gibi birçok temel Wear OS deneyimi uzun sürelidir. Güvenilirliği korumak ve pil ömrünü uzatmak için bu işin doğru şekilde yönetilmesi çok önemlidir.

• Kullanıcı tarafından başlatılan ve uzun süren görevler için: Kullanıcı, ayrılsa bile devam etmesi gereken bir görev başlattığında (ör. koşu takibi) ön plan hizmeti kullanmanız gerekir. Wear OS'te bu hizmeti Ongoing Activity API ile eşleyin. Bu işlem, saat yüzünde kalıcı bir bildirim ve dokunulabilir bir simge oluşturur. Bu simge, kullanıcının uygulamanıza dönmesini sağlar.
• Ertelenebilir arka plan görevleri için: Hemen yapılması gerekmeyen işler (ör. verilerin düzenli olarak senkronize edilmesi) için WorkManager'ı kullanın. Pil kullanımına dikkat eder ve Doze modu gibi sistem optimizasyonlarına saygı duyar. Bu nedenle, acil olmayan arka plan işlemleri için iyi bir seçimdir.

Uygulamanın ötesini düşünün: Yüzeyler ve güç

Son olarak, Wear OS deneyiminin yalnızca ana uygulamadan ibaret olmadığını unutmayın.

• Diğer platformları destekleyin: Yüksek kaliteli ve ilgi çekici bir uygulama oluşturmak için bileğe göre optimize edilmiş diğer platformları desteklemeyi planlayın. Hızlı işlemler ve bilgiler için tile, önemli verileri doğrudan kullanıcının saat yüzünde göstermek için ise özellik oluşturmayı düşünebilirsiniz.
• Güç verimliliği için plan yapın: Pil ömrü, giyilebilir cihazlarda çok önemlidir. Uygulamanızı en başından itibaren güç tasarrufu sağlayacak şekilde tasarlayın. Bu bağlamda, verileri nasıl getirdiğinize, sensörleri nasıl kullandığınıza ve arka plan görevlerini nasıl çalıştırdığınıza dikkat etmeniz gerekir. Çalışmayı kol saati şarj olana kadar ertelemek genellikle iyi bir stratejidir. Güç tasarrufu kılavuzundan daha fazla bilgi edinebilirsiniz.