Aroma

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

Flavor aşağıdaki türler dahil olmak üzere mevcut yapılandırmalara ait değerler içerebilir:

  • BooleanConfiguration
  • ColorConfiguration
  • ListConfiguration
  • ComplicationSlot

Sürüm 2'den 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 öğesini kullanmak için aşağıdakilerin res/xml/watch_face_info.xml öğesine eklenmesi gerekir:

<?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ılmaz 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. Bu dosyanın maksimum boyutu 360x360 piksel olmalıdır.
screenReaderText
Kullanıcıda TalkBack'i etkinleştirmişse kullanılan metne karşılık gelen kaynak kimliği.

İç öğeler

Flavor öğesi en az bir Configuration öğesi içermelidir ve isteğe bağlı olarak ComplicationSlot öğelerini içerebilir.

  • Configuration öğesi, id özelliğini kullanarak BooleanConfiguration gibi önceden tanımlanmış yapılandırma öğelerine başvuruda bulunur. 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 DefaultProviderPolicy öğesini belirtmek üzere ComplicationSlot öğesi kullanılabilir.