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ğıdakiler de dahil olmak üzere mevcut yapılandırmalara ilişkin değerleri içerebilir: şu türler:

• BooleanConfiguration
• ColorConfiguration
• ListConfiguration
• ComplicationSlot

Sürüm 2'den itibaren

Sözdizimi

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

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

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

  <!-- The defaultValue is required. Set this attribute to the ID
       of the flavor that the system should show by default. -->
  <Flavors defaultValue="1">
    <Flavor id="1" displayName="1st flavor" icon="flavor_1_preview">
        <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">
        <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ğıdaki öğeler res/xml/watch_face_info.xml:

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

İsteğe bağlı özellikler

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

icon

Aşağıdaki tabloda gösterilen çekilebilir kaynağa karşılık gelen kaynak kimliği: yardımcı olur. Bu dosyanın maksimum boyutu 360x360 piksel olmalıdır.

screenReaderText

Kullanıcının özelliği TalkBack etkin.

İç öğeler

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

• Configuration öğesi, önceden tanımlanmış yapılandırmaya başvuruyor öğelerini id özelliğini kullanarak BooleanConfiguration gibi öğelere ayarlayın. İlgili içeriği oluşturmak için kullanılan Configuration öğeleri, bu yapılandırma seçeneği için seçilen değeri belirler (optionId özelliğini kullanarak)

• ComplicationSlot öğesi, Belirli bir Flavor için DefaultProviderPolicy.