Aroma

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, seperti BooleanConfiguration, menggunakan atribut id. Elemen Configuration menetapkan nilai yang dipilih untuk opsi konfigurasi ini menggunakan atribut optionId.

  • Elemen ComplicationSlot dapat digunakan untuk menentukan DefaultProviderPolicy untuk Flavor tertentu.