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

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