تحدد السمة 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
محدّد.
أفلام مُقترَحة لك
- ملاحظة: يظهر نص الرابط عند إيقاف JavaScript
- النكهة
- ListConfiguration
- ColorConfiguration