Smak

Flavor określa zestaw wartości konfiguracyjnych pogrupowanych jako gotowe ustawienia. Zwykle użytkownik może wybierać spośród tych smaków w aplikacji towarzyszącej.

Flavor może zawierać wartości istniejących konfiguracji, w tym te typy:

  • BooleanConfiguration
  • ColorConfiguration
  • ListConfiguration
  • ComplicationSlot

Od wersji 2

Składnia

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

Element UserConfigurations może zawierać elementy Flavor, jak w tym przykładzie:

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

Aby można było używać Flavors, do res/xml/watch_face_info.xml musisz dodać te elementy:

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

Atrybuty

Element Flavor ma te atrybuty:

Atrybuty wymagane

Wymagane są te atrybuty:

id
Unikalny identyfikator elementu Flavor.
displayName
Identyfikator zasobu odpowiadający tekstowi wyświetlanemu w reklamie towarzyszącej.
defaultValue
Ten atrybut nie jest używany i powinien być ustawiony jako pusty.

Atrybuty opcjonalne

Te atrybuty są opcjonalne:

icon
Identyfikator zasobu odpowiadający zasobowi rysowalnemu, który jest wyświetlany w elemencie towarzyszącym. Jego maksymalny rozmiar to 360 x 360 pikseli.
screenReaderText
Identyfikator zasobu odpowiadający tekstowi używany, gdy użytkownik ma włączoną funkcję TalkBack.

Elementy wewnętrzne

Element Flavor musi zawierać co najmniej 1 element Configuration i opcjonalnie może zawierać elementy ComplicationSlot.

  • Element Configuration odwołuje się do wcześniej zdefiniowanych elementów konfiguracji, takich jak BooleanConfiguration, przy użyciu atrybutu id. Elementy Configuration ustawiają wybraną wartość dla tej opcji konfiguracji za pomocą atrybutu optionId.

  • Element ComplicationSlot może służyć do określania DefaultProviderPolicy w przypadku danej wartości Flavor.