향

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

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

• BooleanConfiguration
• ColorConfiguration
• ListConfiguration
• ComplicationSlot

버전 2 이후

문법

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

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

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

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입니다.

defaultValue

이 속성은 사용되지 않으며 빈 상태로 설정해야 합니다.

선택사항 속성

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

icon

컴패니언에 표시되는 드로어블 리소스에 해당하는 리소스 ID입니다. 최대 크기는 360x360픽셀입니다.

screenReaderText

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

내부 요소

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

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

• ComplicationSlot 요소는 지정된 Flavor의 DefaultProviderPolicy를 지정하는 데 사용할 수 있습니다.