Bu kılavuzda, Kadran Biçimini kullanarak kadranı yapılandırmak için ihtiyacınız olan araçlar, proje yapısıyla ilgili bazı öneriler ve bu yapıyı oluşturmak için gerekli araçların uygulanmasıyla ilgili adım adım açıklamalı kılavuz bulunmaktadır.
Ön koşullar
Geliştirme ortamınızı Saat Kadranı Biçimini kullanmaya hazırlamak için aşağıdaki kurulum adımlarını tamamlayın:
- Android 13 (API düzeyi 33) veya sonraki sürümler için SDK'yı yükleyin. SDK,
aapt2
veandroid.jar
dahil olmak üzere diğer gerekli araçları içerir. bundletool
komut satırı programını yükleyin.- Uygulamanın, kadran tasarımınızı içeren hata ayıklama sürümünü imzalayın. Android Studio'da imzalı bir Android App Bundle oluşturabilir veya hata ayıklama derlemenizi manuel olarak imzalayabilirsiniz.
Proje yapısı
Saat Kadranı Biçimini kullanan özel bir saat yüzü oluşturduğunuzda, özel saat yüzü dosyasını içeren Android App Bundle, Wear OS uygulamanızın mantığını içeren Android App Bundle'dan tamamen ayrı olmalıdır. Google Play gibi bazı uygulama mağazaları hem Wear OS mantığını hem de özel kadranı içeren Android App Bundle'ları yüklemenizi engeller.
Saat yüzü grubu oluştur
Kadran dosyası içeren bir Android App Bundle oluşturmak için aşağıdaki bölümlerde gösterilen adımları tamamlayın.
Saat kadranı biçimi kullanımını beyan etme
Yeni uygulamanızın manifest dosyasına (AndroidManifest.xml
), Saat Kadranı Biçimini kullandığınızı belirten bir uygulama özelliği ekleyin:
<?xml version="1.0" encoding="utf-8" standalone="no"?> <manifest ...> <application ...> <property android:name="com.google.wear.watchface.format.version" android:value="1" /> </application> </manifest>
Kadran meta verilerini bildirme
Uygulamanızın res/xml
kaynak dizininde watch_face_info.xml
adlı yeni bir dosya oluşturun. 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 resmini içeren çekilebilir malzemeye referans verir.
Category
Kadranın kategorisini tanımlar. Bir dize veya
@string/ref_name
gibi bir dizeye başvuru olmalıdır. Her cihaz üreticisi kendi kadran kategorilerini tanımlayabilir.Varsayılan değer:
empty_category_meta
, bu kadranı, kadran seçici görünümünün en altındaki diğer "boş kategori" kadranlar ile birlikte gruplandırır.AvailableInRetail
Kadranın, cihazın perakende demo modunda kullanılabilir olup olmadığı. Boole değeri veya
@bool/watch_face_available_in_retail
gibi bir boole değerine başvuru olmalıdır.Varsayılan değer:
false
MultipleInstancesAllowed
Kadranda birden fazla favori olup olamayacağı. Boole değeri veya
@bool/watch_face_multiple_instances_allowed
gibi bir boole değerine başvuru olmalıdır.Varsayılan değer:
false
Editable
Kadranın düzenlenebilir olup olmadığı. Diğer bir deyişle, kadranda bir ayar veya en az bir sabit olmayan komplikasyon vardır. Bu, favoriler listesinde saat yüzüne ilişkin Düzenle düğmesini göstermek veya gizlemek için kullanılır.
Varsayılan değer: false
Kadran adını bildirme
Uygulamanızın manifest dosyasında (AndroidManifest.xml
) android:label
özelliğini kadranınızın adına ayarlayın:
<application android:label="@string/watch_face_name" >
Kadran şekillerini destekleme
Uygulamanızın res/xml
kaynak dizininde, desteklediğiniz kadran şekillerini tanımlayın:
<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 şekilleri için destek belirttiğinizde kullanılan file
özellik değerlerine karşılık gelen dosyalar oluşturun. Bu bölümde, kadranınızın görünümünü ve davranışını her kadran şekli için tanımlarsınız.
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
şeklindedir:
<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ı belirleyin (isteğe bağlı)
İsterseniz uygulamanızın manifest dosyasında, kadran yayıncısını ya da kullandığınız araç adı ve sürümü tanımlamak için kullanabileceğiniz rastgele bir dize beyan edebilirsiniz:
<application ...> ... <property android:name="com.google.wear.watchface.format.publisher" android:value="{toolName}-{toolVersion}" /> </application>
Kadranınızın uygulama paketini oluşturun
Kadranınızı içeren Android App Bundle'ı derlemek için bundletool
kullanın. bundletool
kullanarak uygulama oluşturma hakkında daha fazla bilgi edinin.
Uygulama paketinizi yayınlamaya hazır hale getirmeyle ilgili GitHub örneklerine ve Google Play'e göndermeden önce doğruluğu kontrol etmek için kullanılan doğrulayıcı araçlarına bakın.
Sizin için önerilenler
- Not: Bağlantı metni JavaScript kapalıyken görüntülenir
- Son kullanılanlarda ve uygulama geçmişinde göster
- Başlangıç ekranı ekleme
- Kartlarla etkileşimde bulunma