향

맛은 사전 설정으로 그룹화된 구성 값의 집합을 지정합니다. 일반적으로 사용자는 호환 앱에서 이러한 맛 중에서 선택할 수 있습니다.

Flavor에는 다음을 포함한 기존 구성 값이 포함될 수 있습니다. 다음 유형:

• BooleanConfiguration
• ColorConfiguration
• ListConfiguration
• ComplicationSlot

버전 2 이후

구문

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

UserConfigurations 요소 내에 Flavor 요소를 포함할 수 있습니다. 다음과 같습니다.

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

Flavors를 사용하려면 다음을 추가해야 합니다. res/xml/watch_face_info.xml:

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

속성

Flavor 요소는 다음과 같은 속성을 포함합니다.

필수 속성

다음 속성은 필수입니다.

id

Flavor의 고유 식별자입니다.

displayName

컴패니언에 표시되는 텍스트에 해당하는 리소스 ID입니다.

선택사항 속성

다음 속성은 선택사항입니다.

icon

아래에 표시된 드로어블 리소스에 해당하는 리소스 ID 지정할 수 있습니다. 최대 크기는 360x360픽셀입니다.

screenReaderText

사용자가 TalkBack을 사용 설정한 경우 사용되는 텍스트에 해당하는 리소스 ID입니다.

내부 요소

Flavor 요소는 하나 이상의 Configuration 요소를 포함해야 하며 선택적으로 ComplicationSlot 요소를 포함합니다.

• Configuration 요소는 이전에 정의된 구성을 참조합니다. 요소(예: BooleanConfiguration)를 사용하여 id 속성을 사용합니다. 이 Configuration 요소는 이 구성 옵션에 선택된 값을 설정합니다. optionId 속성 사용

• ComplicationSlot 요소를 사용하여 주어진 Flavor의 DefaultProviderPolicy