Rasa menentukan kumpulan nilai konfigurasi, yang dikelompokkan sebagai preset. Biasanya, pengguna dapat memilih dari Rasa ini di aplikasi pendamping.
Flavor
dapat menyertakan nilai untuk konfigurasi yang ada, termasuk
jenis berikut:
BooleanConfiguration
ColorConfiguration
ListConfiguration
ComplicationSlot
Sejak versi 2
Sintaksis
<Flavor id="string" displayName="string" icon="string" screenReaderText="string" defaultValue=""> <!-- Flavor-specific child elements. --> <Configuration ... /> <ComplicationSlot .../> <Flavor/>>
Anda dapat menyertakan elemen Flavor
dalam elemen UserConfigurations
,
seperti yang ditunjukkan dalam contoh berikut:
<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>
Agar dapat menggunakan Flavors
, hal berikut harus ditambahkan ke
res/xml/watch_face_info.xml
:
<?xml version="1.0" encoding="utf-8"?>
<WatchFaceInfo>
...
<MultipleInstancesAllowed value="true" />
<FlavorsSupported value="true" />
</WatchFaceInfo>
Atribut
Elemen Flavor
memiliki atribut berikut:
Atribut wajib
Atribut berikut wajib ada:
id
- ID unik untuk
Flavor
. displayName
- ID resource yang sesuai dengan teks yang ditampilkan di pengiring.
defaultValue
- Atribut ini tidak digunakan dan harus dikosongkan.
Atribut opsional
Atribut berikut bersifat opsional:
icon
- ID resource yang sesuai dengan resource drawable yang ditampilkan di pendamping. Gambar ini harus memiliki ukuran maksimum 360x360 piksel.
screenReaderText
- ID resource yang sesuai dengan teks yang digunakan jika pengguna telah mengaktifkan TalkBack.
Elemen dalam
Elemen Flavor
harus berisi setidaknya satu elemen Configuration
dan dapat
menyertakan elemen ComplicationSlot
secara opsional.
Elemen
Configuration
mereferensikan elemen konfigurasi yang ditentukan sebelumnya, sepertiBooleanConfiguration
, menggunakan atributid
. ElemenConfiguration
menetapkan nilai yang dipilih untuk opsi konfigurasi ini menggunakan atributoptionId
.Elemen
ComplicationSlot
dapat digunakan untuk menentukanDefaultProviderPolicy
untukFlavor
tertentu.
Direkomendasikan untuk Anda
- Catatan: teks link ditampilkan saat JavaScript nonaktif
- Rasa
- ListConfiguration
- ColorConfiguration