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 jakBooleanConfiguration
, przy użyciu atrybutuid
. ElementyConfiguration
ustawiają wybraną wartość dla tej opcji konfiguracji za pomocą atrybutuoptionId
.Element
ComplicationSlot
może służyć do określaniaDefaultProviderPolicy
w przypadku danej wartościFlavor
.
Polecane dla Ciebie
- Uwaga: tekst linku wyświetla się, gdy JavaScript jest wyłączony
- Smak
- ListConfiguration
- ColorConfiguration (Konfiguracja koloru)