Kadran bir hizmettir Wear OS uygulamasında paket haline getirilir. Kullanıcı kullanılabilir bir kadranı seçtiğinde, kadran açılır ve hizmet geri çağırma yöntemleri çağrılır.
Bir kullanıcı, kadranları olan bir Wear uygulaması yüklediğinde kol saati kadran seçici aracılığıyla kol saatinde mevcut olduğundan emin olun. Alternatif olarak kullanıcı, eşlenen telefondaki tamamlayıcı uygulamadan bir kadran seçebilir.
Bu sayfada, bir Wear OS projesinin kadranları içerecek şekilde nasıl yapılandırılacağı ve .
Kadran projesi oluşturma
Not: Wear OS geliştirme için Android Studio'yu kullanmanızı öneririz. proje kurulumu, kitaplığa dahil olma ve paketleme kolaylığı sağlar.
Aşağıdaki adımları uygulayarak proje oluştur kadranınız için Android Studio'da:
- Dosya > Yeni > Yeni proje.
- Proje şablonu seçin penceresinde Wear sekmesini tıklayın, ardından Seçenekler listesinden Kadran'ı seçip İleri'yi tıklayın.
- Projenizi yapılandırın penceresinde şunu kabul edin: varsayılan değerleri belirleyip Son'u tıklayın.
Android Studio, kadran hizmetiniz için app
modülüyle bir proje oluşturur.
Bağımlılıklar
Android Studio, gerekli bağımlılıkları build.gradle
dosyanıza otomatik olarak ekler.
dosyası olarak da kaydedebilir. Bağımlılıklar arasında
AndroidX
kadran kitaplığı; bkz.
kod örneğini ziyaret edin.
Giyilebilir cihaz destek kitaplığı API referansı
Referans dokümanlarda, Google Dokümanlar'da kullandığınız sınıflar hakkında saat yüzlerini uygulayabilirsiniz. Göz atın: API referansı dokümanlarına bakın.
İzinleri bildirme
Kadran için WAKE_LOCK
izni gereklidir.
Hem Wear OS uygulamasının manifest dosyalarına aşağıdaki izni ekle
ve manifest
öğesinin altındaki cep telefonu uygulaması:
<manifest ...> <uses-permission android:name="android.permission.WAKE_LOCK" /> <!-- Required for complications to receive complication data and open the provider chooser. --> <uses-permission android:name="com.google.android.wearable.permission.RECEIVE_COMPLICATION_DATA"/> ... </manifest>
Doğrudan başlatma desteği
Kullanıcı kilidini açmadan önce aşağıdaki adımları uygulayarak kadranınızı kullanılabilir hale getirmeniz gerekir Doğrudan Başlatma kılavuzu:
- Şuradaki hizmetiniz için
android:directBootAware
özelliğinitrue
olarak ayarlayın: manifest dosyanız. - Kadranınız bilgileri içinde depolamalıdır Şifrelenmiş depolama alanı.
Hizmet ve geri çağırma yöntemlerini uygulama
Wear OS'teki kadranlar
WatchFaceService
.
Bir WatchFaceService
uygulamak için üç nesne oluşturmak gerekir: a
UserStyleSchema
, bir ComplicationSlotsManager
ve bir
WatchFace
.
Bu üç nesne,
WatchFaceService
, aşağıdaki örnekte gösterilmiştir:
Kotlin
class CustomWatchFaceService : WatchFaceService() { /** * The specification of settings the watch face supports. * This is similar to a database schema. */ override fun createUserStyleSchema(): UserStyleSchema = // ... /** * The complication slot configuration for the watchface. */ override fun createComplicationSlotsManager( currentUserStyleRepository: CurrentUserStyleRepository ): ComplicationSlotsManager = // ... /** * The watch face itself, which includes the renderer for drawing. */ override suspend fun createWatchFace( surfaceHolder: SurfaceHolder, watchState: WatchState, complicationSlotsManager: ComplicationSlotsManager, currentUserStyleRepository: CurrentUserStyleRepository ): WatchFace = // ... }
Kadran hizmetini kaydedin
Kadran hizmetini uyguladıktan sonra uygulamayı manifest dosyasına kaydedin dosyası oluşturabilirsiniz. Kullanıcılar bu uygulamayı yüklediğinde, sistem bu uygulama ile ilgili bilgileri kadranı Wear OS tamamlayıcı uygulamasında ve giyilebilir cihazdaki kadran seçme aracında.
Aşağıdaki örnekte, kadran uygulamasının nasıl kaydedileceği gösterilmektedir
altında
<application>
öğesi:
<service android:name=".AnalogWatchFaceService" android:label="@string/analog_name" android:permission="android.permission.BIND_WALLPAPER" > <meta-data android:name="android.service.wallpaper" android:resource="@xml/watch_face" /> <meta-data android:name="com.google.android.wearable.watchface.preview_circular" android:resource="@drawable/preview_analog_circular" /> <intent-filter> <action android:name="android.service.wallpaper.WallpaperService" /> <category android:name= "com.google.android.wearable.watchface.category.WATCH_FACE" /> </intent-filter> </service>
Wear OS by Google tamamlayıcı uygulaması ve giyilebilir cihazdaki kadran seçme aracı, önizlemeyi kullanır.
aşağıdaki durumlarda, com.google.android.wearable.watchface.preview_circular
meta veri girişi tarafından tanımlanan resim
kullanıcılara cihazda yüklü tüm kadranları sunmak. Bu çekilebilirliği elde etmek için
kadranı Wear OS cihazınızda veya bir emülatör örneğinde çalıştırıp
ekran görüntüsü al. Wear'da
önizleme görüntüsü genellikle 320x320 piksel boyutundadır.
android.service.wallpaper
meta veri girişi
wallpaper
içeren watch_face.xml
kaynak dosyası
öğesini kullanın:
<?xml version="1.0" encoding="UTF-8"?> <wallpaper xmlns:android="http://schemas.android.com/apk/res/android" />
Giyilebilir uygulamanızda birden fazla kadran bulunabilir. manifesto dosyasını yükleyebilirsiniz.
İlgili kaynaklar
Aşağıdaki ilgili kaynaklara bakın: