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"> <!-- 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" ... />
<!-- ... -->
<!-- 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>
Untuk 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 diisi:
id
- ID unik untuk
Flavor
. displayName
- ID resource yang sesuai dengan teks yang ditampilkan di pengiring.
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
secara opsional, sertakan elemen ComplicationSlot
.
Elemen
Configuration
merujuk pada konfigurasi yang ditentukan sebelumnya elemen, sepertiBooleanConfiguration
, menggunakan atributid
. Tujuan 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