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 các giá trị cho cấu hình hiện có, bao gồm các loại sau:

  • BooleanConfiguration
  • ColorConfiguration
  • ListConfiguration
  • ComplicationSlot

Kể từ phiên bản 2

Cú pháp

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

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

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

Để sử dụng Flavors, bạn phải thêm mục 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 quảng cáo đồng hành.

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 quảng cáo đồ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ể có thể bao gồm các phần tử ComplicationSlot.

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

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