النكهة

تحدد السمة Flavor (النكهة) مجموعة من قيم الضبط التي يتم تجميعها كإعداد مسبق. عادةً ما يمكن للمستخدم الاختيار من بين هذه النكهات في التطبيق المصاحب.

يمكن أن تتضمَّن Flavor قيمًا للإعدادات الحالية، بما في ذلك الأنواع التالية:

• BooleanConfiguration
• ColorConfiguration
• ListConfiguration
• ComplicationSlot

اعتبارًا من الإصدار 2

بناء الجملة

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

يمكنك تضمين عناصر Flavor داخل عنصر UserConfigurations، كما هو موضّح في المثال التالي:

<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

رقم تعريف مصدر مطابق للنص المعروض في الإعلان المصاحب.

defaultValue

هذه السمة غير مُستخدَمة، ويجب ضبطها على أنّها فارغة.

السمات الاختيارية

السمات التالية اختيارية:

icon

رقم تعريف مورد مطابق للمورد القابل للرسم الذي يظهر في الإعلان المصاحب. ويجب أن يبلغ الحد الأقصى للحجم 360 × 360 بكسل.

screenReaderText

رقم تعريف مصدر يتوافق مع النص المُستخدَم في حال تفعيل TalkBack لدى المستخدم.

العناصر الداخلية

يجب أن يحتوي العنصر Flavor على عنصر Configuration واحد على الأقل، ويمكن أن يتضمّن عناصر ComplicationSlot إذا أردت.

• يشير العنصر Configuration إلى عناصر ضبط محدّدة سابقًا، مثل BooleanConfiguration، باستخدام السمة id. تحدّد عناصر Configuration القيمة المختارة لخيار الإعداد هذا باستخدام السمة optionId.

• يمكن استخدام العنصر ComplicationSlot لتحديد DefaultProviderPolicy لعنصر Flavor محدّد.