يتم تعديل المجموعة العادية من رموز الإيموجي سنويًا من قِبل يونيكود، لأنّ استخدام رموز الإيموجي يزداد بسرعة في جميع أنواع التطبيقات.
إذا كان تطبيقك يعرض محتوى على الإنترنت أو يتيح إدخال نص، ننصح بشدة بإتاحة أحدث خطوط الرموز التعبيرية. بخلاف ذلك، قد يتم عرض الرموز التعبيرية اللاحقة على شكل مربّع صغير يُعرف باسم tofu (☐) أو تسلسلات رموز تعبيرية أخرى معروضة بشكلٍ غير صحيح.
لا يمكن لإصدارات Android 11 (المستوى 30 لواجهة برمجة التطبيقات) والإصدارات الأقدم تحديث خط الرموز التعبيرية، لذا يجب تحديث التطبيقات التي تعرض الرموز التعبيرية على هذه الإصدارات يدويًا.
في ما يلي أمثلة على الرموز التعبيرية الحديثة.
أمثلة | الإصدار |
---|---|
🫠 🫱🏼🫲🏿 🫰🏽 | 14.0 (أيلول/سبتمبر 2021) |
😶🌫️ 🧔🏻♀️ 🧑🏿❤️🧑🏾 | 13.1 (أيلول/سبتمبر 2020) |
🥲 🥷🏿 🐻❄️ | 13.0 (آذار/مارس 2020) |
🧑🏻🦰 🧑🏿🦯 👩🏻🤝👩🏼 | 12.1 (تشرين الأول/أكتوبر 2019) |
🦩 🦻🏿 👩🏼🤝👩🏻 | 12.0 (شباط/فبراير 2019) |
توفّر مكتبة androidx.emoji2:emoji2
توافقًا أسهل مع الإصدارات القديمة من Android. مكتبة emoji2
هي مكتبة تابعة مكتبة
AppCompat
ولا تتطلّب
أي إعدادات إضافية للعمل.
إتاحة رموز الإيموجي في ميزة "الإنشاء"
توفّر مجموعة بيانات المنتجات (BOM) لشهر آذار (مارس) 2023 (واجهة مستخدم Compose 1.4) إمكانية استخدام أحدث إصدار من الرموز التعبيرية، بما في ذلك التوافق مع الإصدارات القديمة من Android حتى IDE 21. تتناول هذه الصفحة كيفية ضبط رموز الإيموجي الحديثة في نظام View. اطّلِع على صفحة الرموز التعبيرية في ميزة "الإنشاء" للحصول على مزيد من المعلومات.
المتطلّبات الأساسية
للتأكّد من أنّ تطبيقك يعرض الرموز التعبيرية الجديدة بشكل صحيح، يمكنك تشغيله على جهاز يعمل بالإصدار Android 10 (المستوى 29 من واجهة برمجة التطبيقات) أو إصدار أقل. تتضمّن هذه الصفحة رموزًا تعبيرية حديثة يمكنك عرضها للاختبار.
استخدام AppCompat لتوفير أحدث رموز الإيموجي
AppCompat
يتضمّن الإصدار 1.4 ميزة استخدام الرموز التعبيرية.
لاستخدام AppCompat
لتفعيل الرموز التعبيرية، اتّبِع الخطوات التالية:
تأكَّد من أنّ وحدتك تعتمد على إصدار مكتبة
AppCompat
1.4.0-alpha01 أو إصدار أحدث.build.gradle // Ensure version is 1.4.0-alpha01 or higher. implementation "androidx.appcompat:appcompat.$appcompatVersion"
تأكَّد من أنّ جميع الأنشطة التي تعرض نصًا تمدّد فئة
AppCompatActivity
.Kotlin
MyActivity.kt class MyActivity: AppCompatActivity { ... }
Java
MyActivity.java class MyActivity extends AppCompatActivity { ... }
يمكنك اختبار عملية الدمج من خلال تشغيل تطبيقك على جهاز يعمل بنظام التشغيل Android 10 أو إصدار أقدم وعرض سلسلة الاختبار التالية. تأكَّد من أنّ جميع الأحرف معروضة بشكل صحيح.
- الإصدار 14.0: 🫠 و🫱🏼🫲🏿 و🫰🏽
- 13.1: 😶🌫️ و🧔🏻♀️ و🧑🏿❤️🧑🏾
- الإصدار 13.0: 🥲 و🥷🏿 و🐻❄️
- 12.1: 🧑🏻🦰 و🧑🏿🦯 و👩🏻🤝👩🏼
- الإصدار 12.0: 🦩 و🦻🏿 و👩🏼🤝👩🏻
يعرض تطبيقك تلقائيًا الرموز التعبيرية المتوافقة مع الإصدارات القديمة على جميع الأجهزة التي
توفّر فيها خدمة مزوّد خطوط قابل للتنزيل ومتوافق مع emoji2
، مثل الأجهزة التي
تعمل بنظام خدمات Google Play.
إذا كان تطبيقك يستخدم AppCompat ولكنه يعرض رمز tofu (☐)
في بعض الحالات، قد يعرض تطبيقك رمزًا تعبيريًا لفول الصويا بدلاً من الرمز التعبيري المناسب، حتى إذا
أضفت مكتبة AppCompat
. في ما يلي التفسيرات والحلول المحتملة.
تشغيل التطبيق على جهاز تم تثبيت نظام التشغيل عليه مؤخرًا أو على محاكي جديد
محو بيانات "خدمات Google Play" للتطبيق لمحو أي ذاكرة تخزين مؤقت للخطوط قد تحدث أثناء بدء التشغيل يؤدي ذلك عادةً إلى حلّ المشكلة بعد بضع ساعات.
لمحو بيانات التطبيق، اتّبِع الخطوات التالية:
افتح الإعدادات على جهاز Android.
انقر على التطبيقات والإشعارات.
انقر على عرض كل التطبيقات أو معلومات التطبيق.
انتقِل بين التطبيقات وانقر على خدمات Google Play.
انقر على مساحة التخزين وذاكرة التخزين المؤقت.
انقر على محو ذاكرة التخزين المؤقت.
لا يستخدم تطبيقك فئة مرتبطة بالنص في مكتبة AppCompat.
يمكن أن يحدث ذلك إذا لم تُوسِّع AppCompatActivity
أو إذا أنشأت مثيلًا لمحاولة
عرض في الرمز البرمجي، مثل TextView
. تحقَّق مما يلي:
- تم تمديد النشاط لمدة
AppCompatActivity
. - في حال إنشاء طريقة العرض في الرمز البرمجي، استخدِم
AppCompat
الفئة الفرعية الصحيحة.
يُنشئ AppCompatActivity
تلقائيًا AppCompatTextView
بدلاً من
TextView
عند تضخيم ملف XML، لذا لا تحتاج إلى تعديل ملف XML.
لا يتيح الهاتف الاختباري استخدام الخطوط القابلة للتنزيل.
تأكَّد من أنّ DefaultEmojiCompatConfig.create
يعرض إعدادًا غير صفري.
محاكي يعمل بمستوى واجهة برمجة تطبيقات أقدم لم يُحدِّث "خدمات Google Play"
عند استخدام محاكي على مستوى واجهة برمجة تطبيقات أقدم، قد تحتاج إلى تحديث
حِزمة "خدمات Google Play" المضمّنة لنظام التشغيل emoji2
للعثور على مقدّم الخطوط. لإجراء ذلك،
سجِّل الدخول إلى "متجر Google Play" على المحاكي.
للتأكّد من تثبيت إصدار متوافق، اتّبِع الخطوات التالية:
نفِّذ الأمر التالي:
adb shell dumpsys package com.google.android.gms | grep version
تأكَّد من أنّ
versionCode
أعلى من211200000
.
إتاحة رموز الإيموجي بدون حزمة AppCompat
إذا لم يكن بإمكان تطبيقك تضمين AppCompat
، يمكنه استخدام emoji2
مباشرةً. يتطلب هذا الإجراء
مزيدًا من العمل، لذا لا تستخدِم هذه الطريقة إلا إذا تعذّر على تطبيقك استخدام AppCompat
.
لتفعيل الرموز التعبيرية بدون مكتبة AppCompat
، اتّبِع الخطوات التالية:
في ملف
build.gradle
الخاص بتطبيقك، أدرِجemoji2
وemoji2-views
.build.gradle def emojiVersion = "1.0.0-alpha03" implementation "androidx.emoji2:emoji2:$emojiVersion" implementation "androidx.emoji2:emoji2-views:$emojiVersion"
توفّر وحدة
emoji2-views
فئات فرعية منTextView
وButton
وEditText
التي تنفّذEmojiCompat
. لا تستخدِمه في تطبيق يتضمّنAppCompat
، لأنّه ينفِّذEmojiCompat
من قَبل.في ملف XML والرموز البرمجية، استخدِم
EmojiTextView
أوEmojiEditText
أوEmojiButton
بدلاً منTextView
أوEditText
أوButton
في أيّ مكان تستخدم فيه هذه الرموز.activity_main.xml <androidx.emoji2.widget.EmojiTextView ... /> <androidx.emoji2.widget.EmojiEditText ... /> <androidx.emoji2.widget.EmojiButton ... />
من خلال تضمين وحدة
emoji2
، يستخدم النظام موفِّر ملفّات الخطوط التلقائية القابلة للتنزيل لتحميل خط الرموز التعبيرية تلقائيًا بعد بدء تشغيل التطبيق بفترة قصيرة. ليس هناك حاجة إلى إجراء مزيد من الإعدادات.لاختبار عملية الدمج، افتح تطبيقك على جهاز يعمل بنظام التشغيل Android 11 أو إصدار أقل ويعرض سلاسل الاختبار التالية. تأكَّد من أنّ جميع الأحرف معروضة بشكل صحيح.
- الإصدار 14.0: 🫠 و🫱🏼🫲🏿 و🫰🏽
- 13.1: 😶🌫️ و🧔🏻♀️ و🧑🏿❤️🧑🏾
- الإصدار 13.0: 🥲 و🥷🏿 و🐻❄️
- 12.1: 🧑🏻🦰 و🧑🏿🦯 و👩🏻🤝👩🏼
- الإصدار 12.0: 🦩 و🦻🏿 و👩🏼🤝👩🏻
استخدام EmojiCompat بدون التطبيقات المصغّرة
يستخدم EmojiCompat
EmojiSpan
لمحاولة
عرض الصور الصحيحة. لذلك، يجب تحويل أي عنصر
CharSequence
معيّن إلى عنصر
Spanned
يتضمّن EmojiSpan
عنصرًا.
توفّر فئة EmojiCompat طريقة process()
لتحويل CharSequences
إلى عناصر Spanned
. باستخدام هذه الطريقة، يمكنك استدعاء process()
في
الخلفية وتخزين النتائج مؤقتًا، ما يؤدي إلى تحسين أداء تطبيقك.
Kotlin
val processed = EmojiCompat.get().process("neutral face \uD83D\uDE10")
Java
CharSequence processed = EmojiCompat.get().process("neutral face \uD83D\uDE10");
استخدام EmojiCompat لمحرّري طرق الإدخال
تسمح فئة EmojiCompat
للوحات المفاتيح بعرض الرموز التعبيرية المتوافقة مع التطبيق الذي تتم تفاعله معه. يمكن لمحرّري أساليب الإدخال
(IME) استخدام الرمز
getEmojiMatch()
للتحقّق مما إذا كان EmojiCompat
قادرًا على عرض رمز emojy. تأخذ هذه الطريقة CharSequence
رمزًا تعبيريًا وتُعرِض true
إذا كان EmojiCompat
قادرًا على رصد الرمز التعبيري وعرضه.
يمكن أن تتحقّق لوحة المفاتيح أيضًا من إصدار EmojiCompat
الذي يتيحه التطبيق
لتحديد الرموز التعبيرية التي سيتم عرضها في لوحة الألوان. للتحقّق من الإصدار، يمكن للوحة المفاتيح البحث عن المفاتيح التالية في حِزمة
EditorInfo.extras
، إذا كانت متاحة:
-
EDITOR_INFO_METAVERSION_KEY
: يمثّل إصدار البيانات الوصفية لرموز الإيموجي التي يستخدمها التطبيق. إذا لم يكن هذا المفتاح متوفّرًا، يعني ذلك أنّ التطبيق لا يستخدمEmojiCompat
. -
EDITOR_INFO_REPLACE_ALL_KEY
: إذا كان المفتاح متوفّرًا وتم ضبطه علىtrue
، سيضبط التطبيقEmojiCompat
لاستبدال كل الرموز التعبيرية، حتى إذا كانت متوفّرة في النظام.
مزيد من المعلومات حول كيفية ضبط مثيل برمجي لأجل مكتبة EmojiCompat
استخدام الرموز التعبيرية في طرق العرض المخصّصة
إذا كان تطبيقك يتضمّن طرق عرض مخصّصة هي
فئات فرعية مباشرة أو غير مباشرة من TextView
، مثل Button
أو
Switch
أو EditText
، ويمكن لهذه الطرق عرض
محتوى من إنشاء المستخدمين، يجب أن تطبّق كلّ طريقة
EmojiCompat
.
تختلف العملية حسب ما إذا كان تطبيقك يستخدم مكتبة AppCompat
.
إضافة طرق عرض مخصّصة للتطبيقات التي تستخدم حزمة AppCompat
إذا كان تطبيقك يستخدم AppCompat
، يمكنك توسيع نطاق تنفيذ AppCompat
بدلاً من
تنفيذ النظام الأساسي. استخدِم الجدول التالي كدليل لكيفية
توسيع نطاق مشاهدات قناتك في AppCompat
:
بدلاً من التمديد... | تمديد |
---|---|
TextView
|
AppCompatTextView
|
EditText
|
AppCompatEditText
|
ToggleButton
|
AppCompatToggleButton
|
Switch
|
SwitchCompat
|
Button
|
AppCompatButton
|
CheckedTextView
|
AppCompatCheckedTextView
|
RadioButton
|
AppCompatRadioButton
|
CheckBox
|
AppCompatCheckBox
|
AutoCompleteTextView
|
AppCompatAutoCompleteTextView
|
MultiAutoCompleteTextView
|
AppCompatMultiAutoCompleteTextView
|
إضافة طرق عرض مخصّصة للتطبيقات التي لا تتضمّن حزمة AppCompat
إذا كان تطبيقك لا يستخدم AppCompat
، استخدِم أدوات مساعدة دمج العرض في وحدة
emoji2-views-helper
المصمّمة للاستخدام في طرق العرض المخصّصة. هذه هي
العناصر المساعدة التي تستخدمها مكتبة AppCompat
لتوفير إمكانية استخدام رموز الإيموجي.
أكمِل الخطوات التالية لإتاحة جداول الاطّلاع المخصّصة للتطبيقات التي لا تستخدم
AppCompat
.
إضافة مكتبة
emoji2-views-helper
:implementation "androidx.emoji2:emoji2-views-helper:$emojiVersion"
اتّبِع التعليمات لتضمين رمز
EmojiTextViewHelper
أوEmojiEditTextHelper
في طرق العرض المخصّصة لتطبيقك.يمكنك اختبار عملية الدمج من خلال تشغيل تطبيقك على جهاز يعمل بنظام التشغيل Android 10 أو إصدار أقدم وعرض سلسلة الاختبار التالية. تأكَّد من أنّ جميع الأحرف معروضة بشكل صحيح.
- الإصدار 14.0: 🫠 و🫱🏼🫲🏿 و🫰🏽
- 13.1: 😶🌫️ و🧔🏻♀️ و🧑🏿❤️🧑🏾
- الإصدار 13.0: 🥲 و🥷🏿 و🐻❄️
- 12.1: 🧑🏻🦰 و🧑🏿🦯 و👩🏻🤝👩🏼
- الإصدار 12.0: 🦩 و🦻🏿 و👩🏼🤝👩🏻
ميزات اختيارية لمعالجة emoji2
بعد تضمين مكتبة emoji2
في تطبيقك، يمكنك إضافة ميزات
اختيارية موضّحة في هذا القسم.
ضبط emoji2 لاستخدام خط مختلف أو موفِّر خط قابل للتنزيل
لضبط emoji2
لاستخدام خط مختلف أو مقدّم خط قابل للتنزيل، اتّبِع
الخطوات التالية:
أوقِف العلامة
EmojiCompatInitializer
من خلال إضافة ما يلي إلى البيان:<provider android:name="androidx.startup.InitializationProvider" android:authorities="${applicationId}.androidx-startup" android:exported="false" tools:node="merge"> <meta-data android:name="androidx.emoji2.text.EmojiCompatInitializer" tools:node="remove" /> </provider>
نفّذ أيًا مما يلي:
استخدِم الإعدادات التلقائية من خلال الاتصال بـ
DefaultEmojiCompatConfiguration.create(context)
.أنشئ الإعدادات الخاصة بك لتحميل الخطوط من مصدر آخر باستخدام
EmojiCompat.Config
. توفّر هذه الفئة عدة خيارات لتعديلEmojiCompat
سلوكك، كما هو موضّح في القسم التالي.
تعديل سلوك EmojiCompat
يمكنك استخدام مثيل من EmojiCompat.Config
لتعديل سلوك EmojiCompat
.
أهم خيارات الضبط هو
setMetadataLoadStrategy()
،
الذي يتحكّم في وقت تحميل EmojiCompat
للخط. يبدأ تحميل الخط فورًا بعد استدعاء
EmojiCompat.load()
، ما يؤدي إلى بدء أي عمليات تنزيل ضرورية. ينشئ
النظام سلسلة محادثات لتنزيل الخط ما لم يقدّم تطبيقك سلسلة محادثات.
يتيح لك العنصر LOAD_STRATEGY_MANUAL
التحكّم في وقت استدعاء EmojiCompat.load()
، ويؤدي العنصر
LOAD_STRATEGY_DEFAULT
إلى بدء التحميل بشكل متزامن في طلب العنصر
EmojiCompat.init()
.
تستخدِم معظم التطبيقات LOAD_STRATEGY_MANUAL
حتى تتمكّن من التحكّم في سلسلة المحادثات والتوقيت
لتحميل الخطوط. يجب أن يؤجل تطبيقك تحميل البيانات إلى ما بعد ظهور الشاشة الأولى لتجنُّب حدوث وقت استجابة في بدء التشغيل. يتّبع تطبيق EmojiCompatInitializer
هذه
الممارسة ويؤجل تحميل خط الرموز التعبيرية إلى ما بعد استئناف الشاشة الأولى.
استخدِم الطرق التالية من الفئة الأساسية لضبط جوانب أخرى من الإعداد:
-
setReplaceAll()
: تحدد ما إذا كانEmojiCompat
سيحلّ محل كل رموز الإيموجي التي يعثر عليها بمثيلاتEmojiSpan
. بشكلٍ تلقائي، عندما يستنتجEmojiCompat
أنّ النظام يمكنه عرض رمز تعبيري، لا يستبدل هذا الرمز التعبيري. عند ضبط القيمة علىtrue
،EmojiCompat
يستبدل كل رموز الإيموجي بعناصرEmojiSpan
. -
setEmojiSpanIndicatorEnabled()
: تشير إلى ما إذا كانEmojiCompat
يحلّ محل رمز تعبيري بعنصرEmojiSpan
. عند ضبطها علىtrue
، ترسمEmojiCompat
خلفية لملفEmojiSpan
. تُستخدَم هذه الطريقة بشكل أساسي لأغراض تصحيح الأخطاء. -
setEmojiSpanIndicatorColor
: يضبط اللون للإشارة إلىEmojiSpan
. القيمة التلقائية هيGREEN
. -
registerInitCallback()
: يُعلم التطبيق بحالة بدء تشغيلEmojiCompat
.
إضافة مستمعين لعمليات الإعداد
توفّر فئتَا EmojiCompat
وEmojiCompat.Config
الطريقتَين
registerInitCallback()
و
unregisterInitCallback()
لتسجيل وإزالة تسجيل وظائف الاستدعاء لبدء التشغيل. يستخدم تطبيقك هذه callbacks للانتظار إلى أن يتمّ إعداد EmojiCompat
قبل معالجة الرموز التعبيرية في سلسلتَي مهام في الخلفية أو في عرض مخصّص.
لاستخدام هذه الطرق، أنشئ مثيلًا لفئة
EmojiCompat.InitCallback
. استخدِم هاتين الطريقتَين وأدخِل مثيل فئة
EmojiCompat.InitCallback
. عند نجاح عملية الإعداد، تستدعي فئة
EmojiCompat
الطريقة
onInitialized()
. إذا تعذّر إعداد المكتبة، تستدعي فئة EmojiCompat
الطريقة
onFailed()
.
للتحقّق من حالة الإعداد في أي وقت، يمكنك استدعاء الأسلوب
getLoadState()
. تعرض هذه الطريقة إحدى القيم التالية:
LOAD_STATE_LOADING
أو
LOAD_STATE_SUCCEEDED
أو
LOAD_STATE_FAILED
.
إتاحة الخطوط المجمّعة مع emoji2
يمكنك استخدام العنصر emoji2-bundled
لتجميع خط رموز تعبيرية في تطبيقك.
ولكن بما أنّ خط NotoColorEmoji
يزيد حجمه عن 10 ميغابايت، ننصح بشدة
باستخدام تطبيقك لخطوط قابلة للتنزيل كلما أمكن ذلك. ملف emoji2-bundled
مخصّص للتطبيقات على الأجهزة التي لا تتيح استخدام
الخطوط القابلة للتنزيل.
لاستخدام العنصر emoji2-bundled
، اتّبِع الخطوات التالية:
أدرِج عناصر
emoji2-bundled
وemoji2
:implementation "androidx.emoji2:emoji2:$emojiVersion" implementation "androidx.emoji2:emoji2-bundled:$emojiVersion"
ضبط
emoji2
لاستخدام الإعدادات المجمّعة:Kotlin
EmojiCompat.init(BundledEmojiCompatConfig(context))
Java
EmojiCompat.init(new BundledEmojiCompatConfig(context));
اختبِر عملية الدمج باتّباع الخطوات السابقة لتضمين
emojicompat
معAppCompat
أو بدونه. تأكَّد من أنّ سلسلة الاختبار تظهر بشكل صحيح.- الإصدار 14.0: 🫠 و🫱🏼🫲🏿 و🫰🏽
- 13.1: 😶🌫️ و🧔🏻♀️ و🧑🏿❤️🧑🏾
- الإصدار 13.0: 🥲 و🥷🏿 و🐻❄️
- 12.1: 🧑🏻🦰 و🧑🏿🦯 و👩🏻🤝👩🏼
- الإصدار 12.0: 🦩 و🦻🏿 و👩🏼🤝👩🏻
تأثير الإعداد التلقائي لواجهة EmojiCompat
يطبّق النظام الإعدادات التلقائية باستخدام مكتبة بدء التشغيل،
EmojiCompatInitializer
، و
DefaultEmojiCompatConfig
.
بعد استئناف النشاط الأول في تطبيقك، يحدّد المُنشئ جدولاً زمنيًا لتحميل ملف EMOJI الخط. يتيح هذا التأخير القصير لتطبيقك عرض محتواه الأوّلي بدون أي وقت استجابة محتمل بسبب تحميل الخط في سلسلة مهام في الخلفية.
يبحث DefaultEmojiCompatConfig
عن موفِّر خطوط قابل للتنزيل ومُثبَّت على النظام لتنفيذ واجهة EmojiCompat
، مثل خدمات Google Play. على الأجهزة التي تعمل بـ "خدمات Google Play"، يؤدي ذلك إلى تحميل الخط باستخدام
"خدمات Google Play".
ينشئ المُنشئ سلسلة مهام في الخلفية لتحميل خط الرموز التعبيرية، ويمكن أن يستغرق تحميل الخط
مدة تصل إلى 10 ثوانٍ قبل انتهاء مهلة التحميل. بعد
تنزيل الخط، يستغرق EmojiCompat
تهيئة 150 ملي ثانية تقريبًا في سلسلة مهام في الخلفية.
تأجيل عملية إعداد EmojiCompat
، حتى في حال إيقاف
EmojiCompatInitializer
في حال ضبط EmojiCompat
يدويًا، يمكنك استدعاء EmojiCompat.load()
بعد عرض شاشة تطبيقك الأولى لتجنُّب تداخل عمليات التحميل في الخلفية مع عملية تحميل الشاشة الأولى.
بعد التحميل، يستخدم EmojiCompat
حوالي 300 كيلوبايت من ذاكرة الوصول العشوائي (RAM) لتخزين metadata
الرموز التعبيرية.