Вкус

Вариант определяет набор значений конфигурации, сгруппированных в виде предустановок. Обычно пользователь может выбрать один из этих вариантов в сопутствующем приложении.

Flavor может включать значения для существующих конфигураций, включая следующие типы:

  • BooleanConfiguration
  • ColorConfiguration
  • ListConfiguration
  • ComplicationSlot

Начиная с версии 2

Синтаксис

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

Вы можете включить элементы Flavor в элемент UserConfigurations , как показано в следующем примере:

<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 , необходимо добавить в res/xml/watch_face_info.xml следующее:

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

Атрибуты

Элемент Flavor имеет следующие атрибуты:

Обязательные атрибуты

Обязательны следующие атрибуты:

id
Уникальный идентификатор Flavor .
displayName
Идентификатор ресурса, соответствующий тексту, отображаемому в сопутствующем сообщении.

Дополнительные атрибуты

Следующие атрибуты являются необязательными:

icon
Идентификатор ресурса, соответствующий ресурсу, который можно использовать, который показан в сопутствующем документе. Максимальный размер должен составлять 360x360 пикселей.
screenReaderText
Идентификатор ресурса, соответствующий тексту, который используется, если у пользователя включен TalkBack .

Внутренние элементы

Элемент Flavor должен содержать хотя бы один элемент Configuration и при необходимости может включать элементы ComplicationSlot .

  • Элемент Configuration ссылается на ранее определенные элементы конфигурации, такие как BooleanConfiguration , используя атрибут id . Элементы Configuration устанавливают выбранное значение для этого параметра конфигурации с помощью атрибута optionId .

  • Элемент ComplicationSlot можно использовать для указания DefaultProviderPolicy для данного Flavor .

{% дословно %} {% дословно %} {% дословно %} {% дословно %}