Saat Yüzü Biçimi kurulumu

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:

  1. 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 ve android.jar dahil olmak üzere diğer gerekli araçları içeriyor.

  2. 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.

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.