Mùi vị

Phiên bản chỉ định một tập hợp các giá trị cấu hình, được nhóm thành giá trị đặt trước. Thông thường, người dùng có thể chọn trong số các Phiên bản này trong ứng dụng đồng hành.

Flavor có thể bao gồm giá trị cho các cấu hình hiện có, bao gồm các kiểu sau:

• BooleanConfiguration
• ColorConfiguration
• ListConfiguration
• ComplicationSlot

Kể từ phiên bản 2

Cú pháp

<Flavor id="string" displayName="string" icon="string"
    screenReaderText="string" defaultValue="">
    <!-- Flavor-specific child elements. -->
    <Configuration ... />
    <ComplicationSlot .../>
<Flavor/>>

Bạn có thể đưa các phần tử Flavor vào một phần tử UserConfigurations, như trong ví dụ sau:

<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>

Để sử dụng Flavors, bạn phải thêm đoạn mã sau vào res/xml/watch_face_info.xml:

<?xml version="1.0" encoding="utf-8"?>
<WatchFaceInfo>
    ...
    <MultipleInstancesAllowed value="true" />
    <FlavorsSupported value="true" />
</WatchFaceInfo>

Thuộc tính

Phần tử Flavor có các thuộc tính như sau:

Thuộc tính bắt buộc

Các thuộc tính sau đây là bắt buộc:

id

Giá trị nhận dạng duy nhất của Flavor.

displayName

Mã tài nguyên tương ứng với văn bản xuất hiện trong tệp đồng hành.

defaultValue

Thuộc tính này không được sử dụng và nên được để trống.

Thuộc tính không bắt buộc

Các thuộc tính sau đây là không bắt buộc:

icon

Mã tài nguyên tương ứng với tài nguyên có thể vẽ xuất hiện trong tệp đồng hành. Hình ảnh này phải có kích thước tối đa là 360 x 360 pixel.

screenReaderText

Mã nhận dạng tài nguyên tương ứng với văn bản được sử dụng nếu người dùng bật TalkBack.

Phần tử bên trong

Phần tử Flavor phải chứa ít nhất một phần tử Configuration và có thể tuỳ ý thêm các phần tử ComplicationSlot.

• Phần tử Configuration tham chiếu đến các phần tử cấu hình đã xác định trước đó, chẳng hạn như BooleanConfiguration, bằng thuộc tính id. Các phần tử Configuration đặt giá trị đã chọn cho tuỳ chọn cấu hình này bằng cách sử dụng thuộc tính optionId.

• Bạn có thể sử dụng phần tử ComplicationSlot để chỉ định DefaultProviderPolicy cho một Flavor nhất định.