طعم دهنده

Flavor مجموعه ای از مقادیر پیکربندی را مشخص می کند که به عنوان یک پیش تنظیم گروه بندی شده اند. به طور معمول، کاربر می تواند از بین این طعم ها در برنامه همراه انتخاب کند.

یک Flavor می‌تواند شامل مقادیری برای پیکربندی‌های موجود باشد، از جمله انواع زیر:

  • BooleanConfiguration
  • ColorConfiguration
  • ListConfiguration
  • ComplicationSlot

از نسخه 2

نحو

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

همانطور که در مثال زیر نشان داده شده است، می توانید عناصر Flavor را در یک عنصر UserConfigurations قرار دهید:

<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 با استفاده از ویژگی id به عناصر پیکربندی تعریف شده قبلی مانند BooleanConfiguration ارجاع می دهد. عناصر Configuration مقدار انتخاب شده را برای این گزینه پیکربندی با استفاده از ویژگی optionId تنظیم می کند.

  • عنصر ComplicationSlot را می توان برای تعیین DefaultProviderPolicy برای یک Flavor مورد استفاده قرار داد.

{% کلمه به کلمه %} {% آخر کلمه %} {% کلمه به کلمه %} {% آخر کلمه %}