ज़ायका

फ़्लेवर, कॉन्फ़िगरेशन वैल्यू का एक सेट होता है. इसे प्रीसेट के तौर पर ग्रुप किया जाता है. आम तौर पर, उपयोगकर्ता साथी ऐप्लिकेशन में इन फ़्लेवर में से चुन सकते हैं.

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
कंपैनियन में दिखने वाले टेक्स्ट से जुड़ा संसाधन आईडी.

ऐसे एट्रिब्यूट जो ज़रूरी नहीं हैं

ये एट्रिब्यूट ज़रूरी नहीं हैं:

icon
ड्रॉ किए जा सकने वाले संसाधन का संसाधन आईडी, जो साथी. इसका साइज़ ज़्यादा से ज़्यादा 360x360 पिक्सल होना चाहिए.
screenReaderText
टेक्स्ट से जुड़ा संसाधन आईडी. इसका इस्तेमाल तब किया जाता है, जब उपयोगकर्ता के पास TalkBack चालू किया गया.

इनर एलिमेंट

Flavor एलिमेंट में कम से कम एक Configuration एलिमेंट होना चाहिए. इसके लिए यह ज़रूरी है कि वैकल्पिक रूप से ComplicationSlot एलिमेंट शामिल करें.

  • Configuration एलिमेंट पहले से तय किए गए कॉन्फ़िगरेशन का रेफ़रंस देता है एलिमेंट, जैसे कि BooleanConfiguration, id एट्रिब्यूट का इस्तेमाल करके. कॉन्टेंट बनाने Configuration एलिमेंट, इस कॉन्फ़िगरेशन विकल्प के लिए चुनी गई वैल्यू सेट करता है इसके लिए, optionId एट्रिब्यूट का इस्तेमाल करें.

  • ComplicationSlot एलिमेंट का इस्तेमाल, यह बताने के लिए किया जा सकता है कि किसी दिए गए Flavor के लिए DefaultProviderPolicy.