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
następujące typy:
BooleanConfiguration
ColorConfiguration
ListConfiguration
ComplicationSlot
Od wersji 2
Składnia
<Flavor id="string" displayName="string" icon="string" screenReaderText="string"> <!-- Flavor-specific child elements. --> <Configuration ... /> <ComplicationSlot .../> <Flavor/>>
W elemencie UserConfigurations
możesz umieścić elementy Flavor
,
jak w tym przykładzie:
<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>
Aby używać Flavors
, musisz dodać do
res/xml/watch_face_info.xml
:
<?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.
Atrybuty opcjonalne
Te atrybuty są opcjonalne:
icon
- Identyfikator odpowiadający zasobowi rysowalnemu wyświetlanemu w polu . Jego maksymalny rozmiar to 360 x 360 pikseli.
screenReaderText
- Identyfikator zasobu odpowiadający tekstowi, który jest używany, jeśli użytkownik ma Włączono TalkBack.
Elementy wewnętrzne
Element Flavor
musi zawierać co najmniej 1 element Configuration
i może zawierać:
mogą być opcjonalnie uwzględniane w elementach: ComplicationSlot
.
Element
Configuration
odwołuje się do wcześniej zdefiniowanej konfiguracji takich jakBooleanConfiguration
, za pomocą atrybutuid
. ElementyConfiguration
ustawiają wybraną wartość dla tej opcji konfiguracji za pomocą atrybutuoptionId
.Za pomocą elementu
ComplicationSlot
można określićDefaultProviderPolicy
dla danegoFlavor
.
Polecane dla Ciebie
- Uwaga: tekst linku wyświetla się, gdy JavaScript jest wyłączony
- Smak
- ListConfiguration
- ColorConfiguration (Konfiguracja koloru)