Bu kılavuzda, kadran yapılandırmak için ihtiyacınız olan araçlarla ilgili adımlar yer alır. ve saat Kadranı Formatı'nı kullanma, proje yapısıyla ilgili öneriler ve adımları uygulayarak yapıyı oluşturmaya yönelik araçları nasıl kullanabileceğinizi anlatacağız.
Ön koşullar
Geliştirme ortamınızı Saat Kadranı Formatı'nı kullanmaya hazırlamak için aşağıdaki kurulum adımlarını tamamlayın:
Android 14 (API düzeyi 34) veya sonraki sürümler için SDK'yı yükleyin. Kadranınız sürüm 2'ye özgü özelliklere veya davranışlara bağlı değilse, Bunun yerine Android 13 (API düzeyi 33) için SDK'yı yükleyin.
SDK,
aapt2
veandroid.jar
dahil olmak üzere diğer gerekli araçları içeriyor.Alternatif olarak, aşağıdaki bilgileri de sağlayabilecek Android Studio'yu yükleyebilirsiniz: araçlar.
Proje yapısı
Saat Kadranı Formatı'nı kullanan özel bir kadran oluşturduğunuzda Android Özel kadran dosyasını içeren App Bundle tamamen ayrı olmalıdır Android App Bundle'dan kaldırmanızı öneririz. Bazı uygulamalar mağazalar (Google Play dahil), Android App Bundle'ı yüklemenizi engelliyor hem Wear OS mantığı hem de özel bir kadran.
Kadran paketi oluştur
Kadran dosyası içeren bir Android App Bundle oluşturmak için gösterilen adımlara göz atın.
Saat Kadranı Formatı'nın kullanımını beyan etme
Yeni uygulamanızın manifest dosyasına (AndroidManifest.xml
) bir uygulama ekleyin
özelliği gibi kullanabilirsiniz. Google
Wear OS 5 veya sonraki sürümleri çalıştıran cihazlarda kadranınıza erişimi kısıtlayabilirsiniz.
Biri sürüm 2'yi, diğeri de Android'i destekleyen 2 farklı kadran APK'sı
sürüm 1'i destekler. Uygulamanızın sürümlerini yapılandırma hakkında daha fazla bilgi edinin.
<?xml version="1.0" encoding="utf-8" standalone="no"?> <manifest ...> <!-- Use SDK version 34 for version 2 of WFF, and SDK version 33 for version 1 of WFF --> <uses-sdk android:minSdkVersion="34" android:targetSdkVersion="34" /> <!-- WFF is a resource-only format, so the hasCode attribute should be set to false to reflect this. --> <application android:label="@string/watch_face_name" android:hasCode="false" ...> <property android:name="com.google.wear.watchface.format.version" android:value="2" /> </application> </manifest>
Kadran meta verilerini bildirme
Uygulamanızın res/xml
kaynak dizininde,
watch_face_info.xml
. Kadranınızın meta verilerini burada tanımlarsınız:
<?xml version="1.0" encoding="utf-8"?>
<WatchFaceInfo>
<!-- Only "Preview" is required. -->
<Preview value="@drawable/watch_face_preview" />
<Category value="CATEGORY_EMPTY" />
<AvailableInRetail value="true" />
<MultipleInstancesAllowed value="true" />
<Editable value="true" />
</WatchFaceInfo>
Bu dosyadaki alanlar aşağıdaki ayrıntıları temsil eder:
Preview
- Kadranın önizleme görüntüsünü içeren çekilebilirliğe referans verir.
Category
Kadranın kategorisini tanımlar. Bir dize veya dize,
@string/ref_name
gibi. Her cihaz üreticisi kendi verilerini, kategorilerinden birini seçin.Varsayılan değer:
empty_category_meta
(Bu kadran, birlikte gruplandırılır) diğer "boş kategori" ile kadran seçicinin altındaki kadranlar görünüm.AvailableInRetail
Kadranın cihazın perakende demo modunda kullanılabilir olup olmadığı. Bir boole değeri veya şunun gibi bir boole değerine başvuru olmalıdır:
@bool/watch_face_available_in_retail
Varsayılan değer:
false
MultipleInstancesAllowed
Kadranın birden fazla favorisi olup olmayacağı. Boole değeri olmalıdır. veya
@bool/watch_face_multiple_instances_allowed
Varsayılan değer:
false
Editable
Kadranın düzenlenebilir olup olmadığı, yani kadranın bir ayar veya en az bir düzeltilmemiş özellik. Bu, bir feed'in favoriler listesinde kadran için Düzenle düğmesini gizleyin.
Varsayılan değer: false
Kadran adını bildir
Uygulamanızın manifest dosyasında (AndroidManifest.xml
) android:label
ayarını yapın.
özelliğini kadranınızın adıyla değiştirin:
<application android:label="@string/watch_face_name" >
Kadran şekilleri için destek beyan edin (isteğe bağlı)
Bu adım yalnızca farklı boyutlarda kadranlar. Aşağıdaki koşullar karşılanıyorsa bu adımı atlayabilirsiniz: boyutuyla birlikte ölçeklendirildiğinden memnun kalırsınız.
Uygulamanızın res/xml
kaynak dizininde kadran grubunu bildirin
watch_face_shapes.xml
ürününde desteklediğiniz şekiller:
<WatchFaces>
<!-- The default shape is "CIRCLE". -->
<WatchFace shape="CIRCLE" width="300" height="300"
file="@raw/watchface"/>
<WatchFace shape="CIRCLE" width="450" height="450"
file="@raw/watchface_large_circle"/>
<WatchFace shape="RECTANGLE" width="380" height="400"
file="@raw/watchface_rectangle"/>
</WatchFaces>
Kadran ayrıntılarını bildirme
Uygulamanızın res/raw
kaynak dizininde
Kadran için destek bildirdiğinizde kullanılan file
özellik değerleri
şekilleri ekleyin.
Burada kadranınızın görünümünü ve davranışını tanımlayabilirsiniz.
her saat kadranı şeklinde görünür. Bir şekil dosyası tanımlamadıysanız,
tek bir dosya oluşturmak için watchface.xml
.
Bu sayfadaki örneği kullanarak, ham XML dosyaları şöyle olur:
res/raw/watchface.xml
res/raw/watchface_large_circle.xml
res/raw/watchface_rectangle.xml
Kök öğe her zaman WatchFace
olur:
<WatchFace width="450" height="450" shape="CIRCLE">
<!-- Remainder of your Watch Face Format definition here. -->
<!-- If this file defines a watch face for a circular device shape, place
resources used in this file in the "/res/drawable-nodpi" directory. -->
<!-- If this file defines a watch face for a rectangular or other
non-circular shape, place resources ued in this file in the
"/res/drawable-notround-nodpi" directory. -->
</WatchFace>
Kadran yayıncısını tanımlayın (isteğe bağlı)
İsteğe bağlı olarak, uygulamanızın manifest dosyasında rastgele bir dizeyi yayıncısını tanımlamak için kullanabileceğiniz araçlardır. kullandığınız sürüm:
<application ...> ... <property android:name="com.google.wear.watchface.format.publisher" android:value="{toolName}-{toolVersion}" /> </application>
Kadranınızın doğruluğunu ve performansını kontrol etme
Geliştirme sırasında ve Google Play'e yüklemeden önce doğrulayıcıyı kullanın araçlarını kullanarak kadranınızda hata olmadığından ve uyumlu olduğundan emin olun.
- Bellek kullanımını optimize etme ve bellek kullanımını kontrol etme hakkında daha fazla bilgi edinin hazırlanmasına yardımcı olur.
- Geliştirmenizin bir parçası olarak XML doğrulayıcıyı kullanma hakkında daha fazla bilgi edinin döngüsünü de takip eder.
Kadran uygulama paketinizi oluşturun
Kadranınızı içeren Android App Bundle'ı oluşturmak için şunu kullanın: Gradle derleme sistemi. Uygulama oluşturma hakkında daha fazla bilgi edinin. Gradle'a dokunun.
Bu, GitHub örneklerinde gösterilmektedir.
Sizin için önerilenler
- Not: JavaScript kapalıyken bağlantı metni gösterilir
- AAPT2
- Jetpack Compose ile ilgili temel bilgiler
- KameraX'i Kullanmaya Başlama