Aroma

Aroma, hazır ayar olarak gruplandırılmış bir dizi yapılandırma değerini belirtir. Tipik olarak kullanıcı, tamamlayıcı uygulamada bu Aromalar arasından seçim yapabilir.

Bir Flavor, aşağıdaki türler de dahil olmak üzere mevcut yapılandırmalar için değerler içerebilir:

  • BooleanConfiguration
  • ColorConfiguration
  • ListConfiguration
  • ComplicationSlot

2. sürümden itibaren

Sözdizimi

<Flavor id="string" displayName="string" icon="string"
    screenReaderText="string" defaultValue="">
    <!-- Flavor-specific child elements. -->
    <Configuration ... />
    <ComplicationSlot .../>
<Flavor/>>

Aşağıdaki örnekte gösterildiği gibi bir UserConfigurations öğesine Flavor öğeleri ekleyebilirsiniz:

<UserConfigurations>
  <!-- Configuration definitions go here -->
  <ColorConfiguration id="themeColor" ... />
  <!-- ... -->

  <Flavors>
    <Flavor id="1" displayName="1st flavor" icon="flavor_1_preview" defaultValue="">
        <Configuration id="themeColor" optionId="0"/>
        <ComplicationSlot slotId="0">
            <DefaultProviderPolicy
                defaultSystemProvider="DAY_OF_WEEK"
                defaultSystemProviderType="SHORT_TEXT"/>
        </ComplicationSlot>
    </Flavor>

    <Flavor id="2" displayName="2nd flavor" icon="flavor_2_preview" defaultValue="">
        <Configuration id="themeColor" optionId="1"/>
        <ComplicationSlot slotId="0">
            <DefaultProviderPolicy
                defaultSystemProvider="WATCH_BATTERY"
                defaultSystemProviderType="SHORT_TEXT"/>
        </ComplicationSlot>
    </Flavor>
  </Flavors>
</UserConfigurations>

Flavors özelliğini kullanmak için aşağıdakiler res/xml/watch_face_info.xml ürününe eklenmelidir:

<?xml version="1.0" encoding="utf-8"?>
<WatchFaceInfo>
    ...
    <MultipleInstancesAllowed value="true" />
    <FlavorsSupported value="true" />
</WatchFaceInfo>

Özellikler

Flavor öğesi aşağıdaki özelliklere sahiptir:

Gerekli özellikler

Aşağıdaki özellikler gereklidir:

id
Flavor için benzersiz bir tanımlayıcı.
displayName
Tamamlayıcıda gösterilen metne karşılık gelen kaynak kimliği.
defaultValue
Bu özellik kullanılmıyor ve boş olarak ayarlanmalıdır.

İsteğe bağlı özellikler

Aşağıdaki özellikler isteğe bağlıdır:

icon
Tamamlayıcıda gösterilen çekilebilir kaynağa karşılık gelen kaynak kimliği. Dosya boyutu maksimum 360x360 piksel olmalıdır.
screenReaderText
Kullanıcı TalkBack'i etkinleştirdiğinde kullanılan metne karşılık gelen bir kaynak kimliği.

İç öğeler

Flavor öğesi, en az bir Configuration öğesi içermelidir. İsteğe bağlı olarak ComplicationSlot öğelerini de içerebilir.

  • Configuration öğesi, id özelliğini kullanarak önceden tanımlanmış yapılandırma öğelerine (ör. BooleanConfiguration) referans verir. Configuration öğeleri, optionId özelliğini kullanarak bu yapılandırma seçeneği için seçilen değeri ayarlar.

  • Belirli bir Flavor için ComplicationSlot öğesi, DefaultProviderPolicy öğesini belirtmek amacıyla kullanılabilir.