Emoji2

הצגת אמוג'י במכשירים נוכחיים ובמכשירים ישנים יותר.
העדכון האחרון גרסה יציבה גרסה מועמדת להפצה גרסת בטא גרסה אלפא
4 ביוני 2025 1.5.0 - - 1.6.0-alpha01

הצהרת יחסי תלות

כדי להוסיף תלות ב-Emoji2, צריך להוסיף את מאגר Google Maven לפרויקט. מידע נוסף זמין במאגר Maven של Google.

מוסיפים את יחסי התלות של הארטיפקטים הנדרשים בקובץ build.gradle של האפליקציה או המודול:

מגניב

dependencies {
    def emoji2_version = "1.5.0"

    implementation "androidx.emoji2:emoji2:$emoji2_version"
    implementation "androidx.emoji2:emoji2-views:$emoji2_version"
    implementation "androidx.emoji2:emoji2-views-helper:$emoji2_version"
}

Kotlin

dependencies {
    val emoji2_version = "1.5.0"

    implementation("androidx.emoji2:emoji2:$emoji2_version")
    implementation("androidx.emoji2:emoji2-views:$emoji2_version")
    implementation("androidx.emoji2:emoji2-views-helper:$emoji2_version")
}

מידע נוסף על יחסי תלות זמין במאמר הוספת יחסי תלות ל-build.

משוב

המשוב שלכם עוזר לנו לשפר את Jetpack. אם נתקלתם בבעיות חדשות או שיש לכם רעיונות לשיפור הספרייה הזו, נשמח לשמוע מכם. לפני שיוצרים בעיה חדשה, כדאי לעיין בבעיות הקיימות בספרייה הזו. כדי להצביע על בעיה קיימת, לוחצים על לחצן הכוכב.

דיווח על בעיה חדשה

מידע נוסף זמין במסמכי התיעוד של Issue Tracker.

Emoji2 Emojipicker גרסה 1.0

גרסה 1.5.0

4 בספטמבר 2024

androidx.emoji2:emoji2-*:1.5.0 משוחרר. הגרסה 1.5.0 כוללת את ההוספות האלה.

שינויים חשובים מאז גרסה 1.4.0

  • תמיכה ב-Emoji 15.1 ובממשק המשתמש של הבורר הדו-כיווני של האמוג'י. לחיצה פשוטה על המתג הדו-כיווני מאפשרת למשתמשים לעבור בין גרסאות של אמוג'י עם פנים שמאלה וימינה.
  • תמיכה בבורר אמוג'י עם כמה גווני עור. אם לוחצים לחיצה ארוכה על אמוג'י של זוג, מוצג בורר אמוג'י של כמה אנשים במצב אפס. כשהמשתמש מקייש על החלק השמאלי של אמוג'י, תצוגה המקדימה של האמוג'י בפינה השמאלית התחתונה תתעדכן בהתאם. כשהמשתמש בוחר את שני החלקים של אמוג'י, בתצוגה המקדימה של האמוג'י בפינה השמאלית התחתונה יוצג האמוג'י כולו, והמשתמש יוכל להזין אותו.

גרסה 1.0.0-alpha03

8 במרץ 2023

androidx.emoji2:emoji2-emojipicker:1.0.0-alpha03 משוחרר. גרסה 1.0.0-alpha03 כוללת את ההצהרות האלה.

תיקוני באגים

  • הוסרו משאבים מיותרים והגודל של הספרייה צומצם בכ-300 אלף.

גרסה 1.0.0-alpha02

22 בפברואר 2023

androidx.emoji2:emoji2-emojipicker:1.0.0-alpha02 משוחרר. גרסה 1.0.0-alpha02 מכילה את ההצהרות האלה.

שינויים ב-API

  • הוספנו ממשק API חדש ללקוחות Java כדי שיוכלו לספק אמוג'י מהזמן האחרון. (I39d10)

תיקוני באגים

  • עדכון המשאבים של אמוג'י לתמיכה ב-emoji 15.0 (Ib4eb3)
  • כשבוחרים אמוג'י מחלון הקופץ, כל האמוג'י זהים מתעדכנים לאמוג'י החדש שנבחר (למעט שורת האמוג'י האחרונים). גם להכריז על האמוג'י בזמן הלחיצה. (I892c6)
  • צריך להמתין עד ש-emojicompat ייטען לפני שמציגים את EmojiPickerView. (I29e03)

גרסה 1.0.0-alpha01

25 בינואר 2023

androidx.emoji2:emoji2-emojipicker:1.0.0-alpha01 משוחרר. גרסה 1.0.0-alpha01 מכילה את ההוספות האלה.

תכונות חדשות

  • הוספנו בורר אמוג'י שמספק חוויית משתמש עקבית עם האמוג'י העדכניים ביותר באפליקציות ובמכשירים של יצרני ציוד מקורי ל-Android OS. היא מספקת את התמיכה האחרונה באמוג'י ואת ממשק המשתמש העדכני של הכלי לבחירת אמוג'י, כולל וריאציות של גווני עור ותמיכה בתאימות של אמוג'י.

שינויים ב-API

  • הוספנו את הכיתה EmojiPickerView שמספקת אמוג'י עדכניים בתצוגה אנכית שניתן לגלול בה, עם כותרת אופקית שניתן ללחוץ עליה.
  • אפשר להגדיר את העמודות של רשת הבחירה של האמוג'י באמצעות מאפיין ה-XML emojiGridColumns או הפונקציה setEmojiGridColumns().
  • אפשר להגדיר את השורות של רשת הבחירה של האמוג'י באמצעות מאפיין ה-XML emojiGridRows או הפונקציה setEmojiGridRows().
  • אפשר להגדיר את המאזין שנבחר באמצעות setOnEmojiPickedListener(), והמאזין יקבל התראה בכל פעם שהמשתמש ילחץ על אמוג'י כלשהו.
  • אפשר לספק את ספק האמוג'י האחרון באמצעות setRecentEmojiProvider(). זוהי פונקציה אופציונלית. אם ספק האמוג'י האחרון לא מוגדר, הספרייה תשתמש בספק ברירת המחדל של אמוג'י אחרונים. התנהגות ברירת המחדל מוגדרת באופן הבא: 1) כל האמוג'י שנבחרו יישמרו ברמת האפליקציה בהעדפות המשותפות. 2) הבורר יציג עד 3 שורות של אמוג'י שנבחרו, ללא כפילויות, בסדר כרונולוגי הפוך.
  • הוספנו את הכיתה EmojiViewItem שמכילה את האמוג'י המוצג ואת הווריאנטים שלו.
  • הוספת ממשק RecentEmojiProvider שאפשר להטמיע כדי לספק רשימה של אמוג'י שנשלחו לאחרונה. ה-recentEmojiProvider אחראי לספק סמלי אמוג'י בקטגוריה 'נעשה בהם שימוש לאחרונה'.

גרסה 1.6

גרסה 1.6.0-alpha01

4 ביוני 2025

androidx.emoji2:emoji2-*:1.6.0-alpha01 משוחרר. גרסת 1.6.0-alpha01 כוללת את ההוספות האלה.

תכונות חדשות

  • עדכוני נתונים של Emoji 16.0‏ (Ifc878)
  • הוספת הסיומת 'emoji' לתיאור התוכן

תיקוני באגים

  • הספרייה הזו משתמשת עכשיו בהערות של JSpecify לגבי ערכים null, שהן שימוש בסוגים. מפתחי Kotlin צריכים להשתמש בארגומנטים הבאים של המהדר כדי לאכוף שימוש נכון: -Xjspecify-annotations=strict, ‏ -Xtype-enhancement-improvements-strict-mode (Id07e7, ‏ b/326456246)

גירסה 1.5

גרסה 1.5.0

4 בספטמבר 2024

androidx.emoji2:emoji2-*:1.5.0 משוחרר. הגרסה 1.5.0 כוללת את ההוספות האלה.

שינויים חשובים מאז גרסה 1.4.0

  • תמיכה ב-Emoji 15.1 ובממשק המשתמש של הבורר הדו-כיווני של האמוג'י. לחיצה פשוטה על המתג הדו-כיווני מאפשרת למשתמשים לעבור בין גרסאות של אמוג'י עם פנים שמאלה וימינה.
  • תמיכה בבורר אמוג'י עם כמה גווני עור. אם לוחצים לחיצה ארוכה על אמוג'י של זוג, מוצג בורר אמוג'י של כמה אנשים במצב אפס. כשהמשתמש מקייש על החלק השמאלי של אמוג'י, תצוגה המקדימה של האמוג'י בפינה השמאלית התחתונה תתעדכן בהתאם. כשהמשתמש בוחר את שני החלקים של אמוג'י, בתצוגה המקדימה של האמוג'י בפינה השמאלית התחתונה יוצג האמוג'י כולו, והמשתמש יוכל להזין אותו.

גרסה 1.5.0-rc01

21 באוגוסט 2024

androidx.emoji2:emoji2-*:1.5.0-rc01 משוחרר. גרסת 1.5.0-rc01 כוללת את ההוספות האלה.

תכונות חדשות

  • תמיכה ב-Emoji 15.1 ובממשק המשתמש של הבורר הדו-כיווני של האמוג'י. לחיצה פשוטה על המתג הדו-כיווני מאפשרת למשתמשים לעבור בין גרסאות של אמוג'י עם פנים שמאלה וימינה.
  • תמיכה בבורר אמוג'י עם כמה גווני עור. אם לוחצים לחיצה ארוכה על אמוג'י של זוג, מוצג בורר אמוג'י של כמה אנשים במצב אפס. כשהמשתמש מקייש על החלק השמאלי של אמוג'י, תצוגה המקדימה של האמוג'י בפינה השמאלית התחתונה תתעדכן בהתאם. כשהמשתמש בוחר את שני החלקים של האמוג'י, בתצוגה המקדימה יוצג האמוג'י כולו והמשתמש יוכל להזין אותו.

תיקוני באגים

  • הסרנו את התיאור הידני של הגישה לממשקי API חדשים של פלטפורמות, כי הדבר מתבצע באופן אוטומטי באמצעות בניית מודלים של API כשמשתמשים ב-R8 עם AGP 7.3 ואילך (למשל, R8 בגרסה 3.3) ובכל גרסאות ה-build כשמשתמשים ב-AGP 8.1 ואילך (למשל, D8 בגרסה 8.1). לקוחות שלא משתמשים ב-AGP מומלצים לעדכן ל-D8 בגרסה 8.1 ואילך. למידע נוסף, מומלץ לעיין במאמר הזה. (If6b4c, ‏ b/345472586)
  • הבחירה בכרטיסייה והאינדיקטור של EmojiPickerView מתעדכנים אחרי לחיצה אחת. (146b02, b/288261054)
  • הבחירה בכרטיסייה והמחוון של EmojiPickerView לא תקינים. (5e1f14, b/273883688)

גרסה 1.5.0-beta01

10 ביולי 2024

androidx.emoji2:emoji2-*:1.5.0-beta01 משוחרר. גרסת 1.5.0-beta01 מכילה את ההוספות האלה.

תכונות חדשות

  • תמיכה ב-Emoji 15.1 ובממשק המשתמש לבחירת אמוג'י דו-כיווני.
  • תמיכה בעיצוב מחדש של האפשרות לבחור גוון עור.

תיקוני באגים

  • הבחירה בכרטיסייה והאינדיקטור של EmojiPickerView מתעדכנים אחרי לחיצה אחת. (146b02, b/288261054)
  • הבחירה בכרטיסייה והמחוון של EmojiPickerView לא תקינים. (5e1f14, b/273883688)

גרסה 1.5.0-alpha01

13 בדצמבר 2023

androidx.emoji2:emoji2-*:1.5.0-alpha01 משוחרר. גרסה 1.5.0-alpha01 כוללת את ההצהרות האלה.

תכונות חדשות

  • emoji2-bundled מכיל גופן אמוג'י מעודכן שתומך ב-Emoji 15.1.

שינויים ב-API

  • מוסיפים מבצעים כדי לשלוט בשרשור הקריאה החוזרת (callback) של InitCallback. (I32b67)
  • עכשיו BundledEmojiCompatConfig מקבלת מבצע כדי לשלוט בשרשור הטעינה. (I00e81)

גרסה 1.4

גרסה 1.4.0

9 באוגוסט 2023

androidx.emoji2:emoji2-*:1.4.0 משוחרר. גרסה 1.4.0 כוללת את ההצהרות האלה.

שינויים חשובים מאז גרסה 1.3.0

גרסה 1.4.0-rc01

26 ביולי 2023

androidx.emoji2:emoji2-*:1.4.0-rc01 משוחרר. גרסה 1.4.0-rc01 כוללת את השמירות האלה.

שינויים ב-API

  • הצגת רשימת registerSource (Iae92f)
  • משוב ממועצת ה-API: שינוי השם של TransitionManager.seekTo() ל-createSeekController(). יש לשנות את התגובה הקודמת לגבי הוספת TransitionManager.seekTo() אל TransitionManager.createSeekController(). (Idbeb1)
  • נוספה ExerciseRouteResult, שהוא לא הסוג ההורה של Data, ‏ NoData ו-ConsentRequiredStates. נוספה ExerciseRoute ככיתה עצמאית שמכילה את נתוני המיקום של המסלול. (I22eed)
  • הוספת PagerLayoutInfo עם מידע שנאסף אחרי שמדד עבר ב-Pager. הוספנו גם את PageInfo, המידע על דף אחד שנמדד ב-Pager. (Iad003, ‏ b/283098900)

תיקוני באגים

  • עדכנו את הצבעים של Button, ‏ IconButton ו-TextButton בהתאם לעיצוב של Material3. עכשיו אפשר לשנות את התפקיד הסמנטי של Button, ‏ IconButton ו-TextButton באמצעות Modifier.semantics. (Ib2495)
  • תוקנה הבעיה שבה הבחירה בכרטיסייה EmojiPickerView והעדכונים של האינדיקטור מתבצעים בקליק אחד אחרי הבחירה. (I4db04)
  • FileNotFoundException על הצגת הכלי לבחירת אמוג'י (I353e4)
  • איך לתפוס את ה-WindowManager.BadTokenException כשמשתמשים ב-EmojiPickerView (I0a144)

גרסה 1.4.0-beta05

7 ביוני 2023

androidx.emoji2:emoji2-*:1.4.0-beta05 משוחרר. גרסה 1.4.0-beta05 כוללת את ההצהרות האלה.

תיקוני באגים

  • תוקן באג שהופיע בגרסה 1.3 וגרם ל-MetricsAffectingSpans, כמו RelativeSizeSpan, לחול פעמיים. פעם אחת במהלך פריסת הטקסט, ופעם נוספת בתוך EmojiSpan.draw. התוצאה הייתה ציור בגודל שגוי, שגלוי אם אחד מהפרמטרים של גודל הטקסט השתנה על ידי ה-span. (b/283208650)

גרסה 1.4.0-beta04

24 במאי 2023

androidx.emoji2:emoji2-*:1.4.0-beta04 משוחרר. גרסה 1.4.0-beta04 מכילה את השמירות האלה.

במהדורה הזו תוקנה באג שנמצא מאז גרסה 1.0, שבו תצוגות עם טיפול לא ראשי היו גורמות להשלכה של חריגה (exception) כשמנסים לעדכן את טווחי האמוג'י אחרי השלמת טעינת הגופן. אין פתרון עקיף. אם הבאג הזה משפיע עליכם, עליכם לשדרג לגרסה הזו או לגרסה מתקדמת יותר.

תיקוני באגים

  • פונקציות ה-callbacks של init‏ EmojiCompat ישתמשו מעכשיו במטפל מכל תצוגה, תוך התחשבות בתצוגות שלא נמצאות בשרשור הראשי. (Iccbcf)

גרסה 1.4.0-beta03

10 במאי 2023

androidx.emoji2:emoji2-*:1.4.0-beta03 משוחרר. גרסה 1.4.0-beta03 כוללת את ההצהרות האלה.

תיקוני באגים

  • תיקון קריסה בתצוגת החלון הקופץ המורכב של הכלי לבחירת אמוג'י. (0acc8e)
  • השלכת חריגים מוקדמים ב-EmojiCompat getEmojiStart/getEmojiEnd. (26177f)

גרסה 1.4.0-beta02

19 באפריל 2023

androidx.emoji2:emoji2-*:1.4.0-beta02 משוחרר. גרסה 1.4.0-beta02 כוללת את ההצהרות האלה.

תיקוני באגים

  • עדכון קבצים בסיסיים של איתור שגיאות בקוד (Iaa212)

גרסה 1.4.0-beta01

5 באפריל 2023

androidx.emoji2:emoji2-*:1.4.0-beta01 משוחרר. גרסה 1.4.0-beta01 מכילה את ההצהרות האלה על ביצוע שינויים (commits).

תכונות חדשות

androidx.emoji2:emoji2-emojipicker

הכלי לבחירת אמוג'י הוא פתרון לממשק משתמש שמציע מראה וסגנון מודרניים, אמוג'י עדכניים וקלות שימוש. המשתמשים יכולים לעיין בסמלי אמוג'י ובגרסאות שלהם ולבחור אותם, או לבחור מבין סמלי האמוג'י שבהם השתמשו לאחרונה. בעזרת הספרייה הזו, אפליקציות של יצרני ציוד מקורי שונים יכולות לספק למשתמשים חוויית שימוש מקיפה ואחידה באמוג'י, בלי שהמפתחים יצטרכו ליצור ולתחזק בורר אמוג'י משלהם מאפס.

סמלי אמוג'י עדכניים

אמוג'י חדשים יוצאים כל שנה, ואנחנו נוסיף אותם לבורר האמוג'י באופן סלקטיבי. כדי להבטיח תאימות לאחור, אנחנו מבצעים בדיקה פנימית מדויקת של יכולת העיבוד של אמוג'י כדי למנוע הצגת 'טופו'. כך תוכלו להבטיח שהספרייה תהיה תואמת למספר גרסאות ומכשירים של Android.

וריאנטים דביקים

אם תלחצו לחיצה ארוכה על אמוג'י, יוצג תפריט של וריאציות, כמו מגדר או גוון עור שונים. הווריאנט שתבחרו יישמר בבורר האמוג'י, והוריאנט האחרון שנבחר ישמש בחלונית הראשית. בעזרת התכונה הזו, המשתמשים יכולים לשלוח את וריאנטים המועדפים שלהם של אמוג'י בלחיצה אחת בלבד.

סמלי אמוג'י מהזמן האחרון

ה-RecentEmojiProvider אחראי לספק סמלי אמוג'י בקטגוריה 'נעשה בהם שימוש לאחרונה'. בספרייה יש ספק ברירת מחדל של אמוג'י עדכניים שמתאים לתרחיש לדוגמה הנפוץ ביותר:

  • כל האמוג'י שנבחרו נשמרים ברמת האפליקציה בהעדפות המשותפות.
  • בבורר מוצגות עד 3 שורות של אמוג'י שנבחרו, ללא כפילויות, בסדר כרונולוגי הפוך.

אם התנהגות ברירת המחדל הזו מספיקה, אין צורך להגדיר את השיטה setRecentEmojiProvider().

עבודה עם EmojiCompat

אם לאפליקציה יש מכונה של EmojiCompat, היא תשמש בבורר האמוג'י כדי להציג כמה שיותר סמלי אמוג'י. אם EmojiCompat מושבתת, בוחר האמוג'י ימשיך לפעול כרגיל.

איך משתמשים בספרייה

כדי להשתמש בספרייה, מפתחי אפליקציות צריכים:

  1. מייבאים את androidx.emoji2:emojipicker:$version ב-build.gradle. 

    dependencies {
  implementation "androidx.emoji2:emojipicker:$version"
}

  2. מרחיבים את התצוגה של בורר האמוג'י, ואם רוצים, מגדירים את emojiGridRows ו-emojiGridColumns בהתאם לגודל הרצוי של כל תא אמוג'י.

    • אפשר להשאיר אותם ללא הגדרה, ברירת המחדל היא 9 emojiGridColumns, השורות יחושבו על סמך גובה התצוגה הראשית ו-emojiGridColumns
    • אפשר להגדיר את emojiGridRows כערך צף כדי לציין שיש עוד אמוג'י אם גוללים למטה ב-XML
     <androidx.emoji2.emojipicker.EmojiPickerView
  android:id="@+id/emoji_picker"
  android:layout_width="match_parent"
  android:layout_height="match_parent"
  app:emojiGridColumns="9" />

בקוד

    val emojiPickerView = EmojiPickerView(context).apply {
        emojiGridColumns = 15
        layoutParams = ViewGroup.LayoutParams(
            ViewGroup.LayoutParams.MATCH_PARENT,
            ViewGroup.LayoutParams.MATCH_PARENT
        )
    }
    findViewById<ViewGroup>(R.id.emoji_picker_layout).addView(emojiPickerView)

  1. נניח שרוצים לצרף את האמוג'ים שנבחרו ל-EditText, משתמשים ב-setOnEmojiPickedListener()

      emojiPickerView.setOnEmojiPickedListener {
      findViewById<EditText>(R.id.edit_text).append(it.emoji)
  }

  2. אפשר גם להגדיר את RecentEmojiProvider. דוגמה להטמעה מפורטת זמינה באפליקציה לדוגמה.

  3. אפשר גם להתאים אישית את הסגנונות. יוצרים סגנון משלכם כדי לשנות את המאפיינים הנפוצים של העיצוב ומחילים את הסגנון על EmojiPickerView. לדוגמה, שינוי של colorControlNormal ישנה את צבע סמל הקטגוריה. 

      <style name="CustomStyle" >
      <item name="colorControlNormal">#FFC0CB</item>
  </style>
  <androidx.emoji2.emojipicker.EmojiPickerView
      android:id="@+id/emoji_picker"
      android:layout_width="match_parent"
      android:layout_height="match_parent"
      android:theme="@style/CustomStyle"
      app:emojiGridColumns="9" />

דוגמה להטמעה מפורטת זמינה באפליקציה לדוגמה.

כאן אפשר למצוא את ממשק ה-API המלא.

אפליקציה לדוגמה

האפליקציה הזו לדוגמה מדגימה תרחישים לדוגמה בסיסיים, וגם את התרחישים הנוספים הבאים:

  • התצוגה תוכננה מחדש כי emojiGridRows ו-emojiGridColumns אופסרו.
  • ספק האמוג'י האחרון מבוטל כדי למיין לפי תדירות.
  • התאמה אישית של סגנונות.

שינויים ב-API

ספריית ה-Emoji Picker עודכנה בממשקי ה-API החדשים הבאים:

  • הכיתה EmojiPickerView, שמציגה אמוג'י עדכניים בתצוגה אנכית שניתן לגלול בה, עם כותרת אופקית שניתן ללחוץ עליה.
  • היכולת להגדיר את מספר העמודות והשורות בתצוגת הרשת של בורר האמוג'י באמצעות מאפייני ה-XML emojiGridColumns ו-emojiGridRows או השיטות setEmojiGridColumns() ו-setEmojiGridRows().
  • היכולת להגדיר מאזין לבחירת אמוג'י באמצעות השיטה setOnEmojiPickedListener(). המאזין יקבל התראה בכל פעם שהמשתמש ילחץ על אמוג'י כלשהו.
  • היכולת לספק ספק אמוג'י עדכני באמצעות השיטה setRecentEmojiProvider(). זוהי פונקציה אופציונלית. אם לא מגדירים את ספק האמוג'י האחרון, הספרייה תשתמש בספק ברירת המחדל של אמוג'י אחרונים. התנהגות ברירת המחדל מוגדרת באופן הבא:
    • כל האמוג'י שנבחרו יישמרו ברמת האפליקציה בהעדפות המשותפות.
    • בבורר יוצגו עד 3 שורות של אמוג'י שנבחרו, ללא כפילויות, בסדר כרונולוגי הפוך.
  • הכיתה EmojiViewItem, שמכילה את האמוג'י המוצג ואת וריאנטים של האמוג'י.
  • הממשק RecentEmojiProvider, שאפשר להטמיע כדי להציג רשימת אמוג'י מהזמן האחרון. ה-recentEmojiProvider אחראי לספק סמלי אמוג'י בקטגוריה 'נעשה בהם שימוש לאחרונה'.
  • ממשק RecentEmojiAsyncProvider, שאפשר להטמיע כדי להציג רשימת אמוג'י מהזמן האחרון. ה-RecentEmojiAsyncProvider אחראי לספק סמלי אמוג'י בקטגוריה 'נעשה בהם שימוש לאחרונה'. הממשק הזה מקביל ל-RecentEmojiProvider שמאפשר ללקוחות לשנות את השיטה getRecentEmojiListAsync() כדי לספק אמוג'י מהזמן האחרון.
  • המחלקה RecentEmojiProviderAdapter, שהיא מתאם ל-RecentEmojiAsyncProvider ומטמיעה את RecentEmojiProvider.

גרסה 1.4.0-alpha01

22 במרץ 2023

androidx.emoji2:emoji2-*:1.4.0-alpha01 משוחרר. גרסה 1.4.0-alpha01 מכילה את ההצהרות האלה על ביצוע שינויים (commits).

תיקוני באגים

  • תיקון בדיקות, השבתת בדיקות לא יציבות ופינוי שטח.

גרסה 1.3

גרסה 1.3.0

22 במרץ 2023

androidx.emoji2:emoji2-*:1.3.0 משוחרר. גרסה 1.3.0 כוללת את ההצהרות האלה.

שינויים חשובים מאז גרסה 1.2.0

  • בגרסה הזו אפשר להפעיל את השילוב של emoji2 ב-Compose Foundation 1.4.0 ואילך.
  • הוא גם מאפשר תכונות להחלפת EmojiSpans בקוד ציור בהתאמה אישית, וכן תמיכה בהחרגות של אמוג'י שהוגדרו ב-Android.

גרסה 1.3.0-rc01

8 במרץ 2023

androidx.emoji2:emoji2-*:1.3.0-rc01 משוחרר. גרסה 1.3.0-rc01 כוללת את ההצהרות האלה.

תכונות חדשות

  • הגרסה הזו מיועדת לתמוך בשילוב של emoji2 compose.

שינויים ב-API

  • מחליפים את ה-spans בקוד ציור מותאם אישית.
  • שליחת שאילתות לגבי החרגות מערכתיות.

תיקוני באגים

  • תוקן באג שבו רכיבי הרקע לא הוחלו כראוי מאחורי EmojiSopans.

גרסה 1.3.0-beta03

23 בפברואר 2023

התכונות androidx.emoji2:emoji2-bundled:1.3.0-beta03, androidx.emoji2:emoji2-views:1.3.0-beta03 וגם androidx.emoji2:emoji2-views-helper:1.3.0-beta03 משוחררות.

22 בפברואר 2023

androidx.emoji2:emoji2:1.3.0-beta03 משוחרר. גרסה 1.3.0-beta03 מכילה את ההוספות האלה.

תכונות חדשות

  • אין שינויים. הגרסה הזו נועדה להכין את ה-Compose לשילוב.

גרסה 1.3.0-beta02

8 בפברואר 2023

androidx.emoji2:emoji2-*:1.3.0-beta02 משוחרר. גרסה 1.3.0-beta02 מכילה את ההצהרות האלה.

תכונות חדשות

  • הגרסה הזו היא גרסה יציבה שתומכת בשילוב עם compose.

גרסה 1.3.0-beta01

25 בינואר 2023

androidx.emoji2:emoji2-*:1.3.0-beta01 משוחרר. גרסה 1.3.0-beta01 מכילה את ההוספות האלה.

תכונות חדשות

  • שליחת שאילתות לגבי החרגות מערכתיות.
  • החלפת ה-spans בקוד ציור בהתאמה אישית.
  • תוקן באג שבו רכיבי הרקע לא הוחלו כראוי מאחורי EmojiSopans.
  • בגרסה הזו נוספו ממשקי API הנחוצים כדי לתמוך ב-EmojiCompat ב-Compose. תמיכה בכתיבה של אמוג'י תושק בגרסה הקרובה.

גרסה 1.3.0-alpha01

11 בינואר 2023

androidx.emoji2:emoji2-*:1.3.0-alpha01 משוחרר. גרסה 1.3.0-alpha01 כוללת את ההוספות האלה.

ממשקי API חדשים לאינטראקציות ברמה נמוכה

  • שליחת שאילתות לגבי החרגות מערכתיות
  • החלפת ה-spans בקוד ציור מותאם אישית
  • תוקן באג שבו רכיבי הרקע לא הוחלו כראוי מאחורי EmojiSopans.
  • בגרסה הזו נוספו ממשקי API הנחוצים כדי לתמוך ב-EmojiCompat ב-Compose. תמיכה בכתיבה של אמוג'י תושק בגרסה הקרובה.

שינויים ב-API

  • נוספה ל-TypefaceEmojiRasterizer היכולת לשלוח שאילתות לגבי החרגות מערכת. (I5653e)
  • הוספנו API חדש EmojiCompat.SpanFactory להחלפת התנהגות ברירת המחדל של EmojiSpan בקוד מותאם אישית לציור ולגודל. (Ib69d9)
  • הוספת EmojiCompat ל'כתיבה' (I96f37, b/139326806)

תיקוני באגים

  • Emoji2 ידפיס עכשיו רקעים בצורה נכונה מ-BackgroundSpan. (Ide6a8, ‏ b/230525134)
  • סיום העבודה על ממשקי ה-API של AppCompat לגרסה 1.5.0-beta01 (I2a43d, ‏ b/236866227)

גרסה 1.2

גרסה 1.2.0

10 באוגוסט 2022

androidx.emoji2:emoji2-*:1.2.0 משוחרר. גרסה 1.2.0 מכילה את ההוספות האלה.

שינויים חשובים מאז גרסה 1.1.0

זוהי גרסה עם תיקון באגים. לא נוספו תכונות או ממשקי API חדשים מאז הגרסה 1.1.0.

עם זאת, אפליקציות שמשתמשות ב-PrecomputedText או ב-TextView.setText(char[]) צריכות לתת עדיפות לשדרוג לגרסה הזו.

תוקנו הבאגים הבאים:

  • Emoji2 יוסיף אמוג'י ל-PrecomputedText על ידי ביטול הפריסה של הטקסט שחושב מראש. (I47d06, ‏ b/211231958)
  • תיקון קריסה של עורך בגרסת backport מ-Android P ל-EditText שמוגדר לשימוש ב-emoji2. (Ifd709, ‏ b/216891011)
  • תיקון קריסה כש-emoji2 טוען גופן והשתמשתם ב-TextView.setText(char[]). (Id511e, ‏ b/206859724)

גרסה 1.2.0-rc01

27 ביולי 2022

androidx.emoji2:emoji2-*:1.2.0-rc01 משוחרר. גרסה 1.2.0-rc01 כוללת את השמירות האלה.

  • לא בוצעו שינויים מאז גרסת הבטא האחרונה.

גרסה 1.2.0-beta01

13 ביולי 2022

androidx.emoji2:emoji2-*:1.2.0-beta01 משוחרר. גרסה 1.2.0-beta01 כוללת את ההצהרות האלה.

תכונות חדשות

  • אין שינויים מהגרסה האחרונה (הגרסת הזו נועדה לתמוך בגרסת AppCompat).

גרסה 1.2.0-alpha04

20 באפריל 2022

androidx.emoji2:emoji2-*:1.2.0-alpha04 משוחרר. גרסה 1.2.0-alpha04 מכילה את ההוספות האלה.

תכונות חדשות

  • אין שינויים בגרסה הזו.

גרסה 1.2.0-alpha03

6 באפריל 2022

androidx.emoji2:emoji2-*:1.2.0-alpha03 משוחרר. גרסה 1.2.0-alpha03 כוללת את ההוספות האלה.

תכונות חדשות

  • אין שינויים לעומת הגרסה האחרונה (הגרסת build הזו נועדה לתמוך בגרסת build של appcompat).

גרסה 1.2.0-alpha02

23 במרץ 2022

androidx.emoji2:emoji2-*:1.2.0-alpha02 משוחרר. גרסה 1.2.0-alpha02 מכילה את ההוספות האלה.

תיקוני באגים

  • Emoji2 יוסיף אמוג'י ל-PrecomputedText על ידי ביטול הפריסה של הטקסט שחושב מראש. (I47d06, ‏ b/211231958)
  • תיקון קריסה של עורך בגרסאות קודמות מ-Android P ל-EditText שמוגדר לשימוש ב-emoji2. (Ifd709, ‏ b/216891011)
  • תיקון קריסה כש-emoji2 טוען גופן והשתמשתם ב-TextView.setText(char[]). (Id511e, ‏ b/206859724)

גרסה 1.2.0-alpha01

23 בפברואר 2022

androidx.emoji2:emoji2-*:1.2.0-alpha01 משוחרר. גרסה 1.2.0-alpha01 מכילה את ההוספות האלה.

לא בוצעו שינויים מאז גרסת 1.1.0.

1.1

גרסה 1.1.0

23 בפברואר 2022

androidx.emoji2:emoji2-*:1.1.0 משוחרר. גרסה 1.1.0 כוללת את ההצהרות האלה.

שינויים חשובים מאז גרסה 1.0.0

  • emoji2-bundled מכיל את הגופן emoji 14
  • ממשק ה-API החדש של getEmojiMatch מחזיר מידע מדויק למקלדות כדי להחליט איך אמוג'י יוצג בנוכחות גופן emojicompat שמופיע מאחורי גופן המערכת
  • תיקון באג ב-NumberKeyListener שמאפשר לסנן תווים בצורה נכונה כשמזינים ספרות.

גרסה 1.1.0-rc01

9 בפברואר 2022

androidx.emoji2:emoji2-*:1.1.0-rc01 משוחרר. גרסה 1.1.0-rc01 כוללת את השמירות האלה.

תכונות חדשות

אין שינויים מגרסת הבטא.

תכונות חדשות בהשוואה ל-emoji2 1.0.0:

  • emoji2-bundled מכיל גופן אמוג'י 14
  • ממשק ה-API החדש של getEmojiMatch מחזיר מידע מדויק למקלדות כדי להחליט איך אמוג'י יוצג בנוכחות גופן emojicompat שמופיע מאחורי גופן המערכת
  • תיקון באג ב-NumberKeyListener שמאפשר לסנן תווים בצורה נכונה כשמזינים ספרות

גרסה 1.1.0-beta01

26 בינואר 2022

androidx.emoji2:emoji2-*:1.1.0-beta01 משוחרר. גרסה 1.1.0-beta01 כוללת את השמירות האלה.

תיקוני באגים

  • גרסת הבטא 01 של androidx-emoji2. אין שינויים מ-alpha01 (Ic61d9)

גרסה 1.1.0-alpha01

15 בדצמבר 2021

androidx.emoji2:emoji2-*:1.1.0-alpha01 משוחרר. גרסה 1.1.0-alpha01 כוללת את ההוספות האלה.

תכונות חדשות

  • emoji2-bundled מכיל גופן אמוג'י 14
  • ממשק ה-API החדש של getEmojiMatch מחזיר מידע מדויק למקלדות כדי להחליט איך אמוג'י יוצג בנוכחות גופן emojicompat שמופיע מאחורי גופן המערכת
  • תיקון באג ב-NumberKeyListener שמאפשר לסנן תווים בצורה נכונה כשמזינים ספרות

שינויים ב-API

  • הוספת ממשק API חדש getEmojiMatch כדי לאפשר למקלדות לחפש בצורה מדויקת יותר את התנהגות ההתאמה של אמוג'י ב-emojicompat.
  • מומלץ להפסיק להשתמש ב-hasEmojiGlyph, כי ערך ההחזרה הבוליאני שלה לא מדויק כשבודקים אותה עם גופן ישן יותר מגופן הסמליקים של הפלטפורמה. מחליפים את הטקסט ב-getEmojiMatch. (Ie693d)

תיקוני באגים

  • Emoji2 לא יא包ב את המופעים של NumberKeyListener, כך שאפשר יהיה להגדיר את הלוקאל באמצעות TextView.
  • ‏Appcompat לא יא包ב את המופעים של NumberKeyListener שהועברו אל setKeyListener, וכך TextView יוכל להגדיר את הלוקאל ב-NumberKeyListeners בצורה נכונה. (Ibf113, ‏ b/207119921)

1.0

גרסה 1.0.1

15 בדצמבר 2021

androidx.emoji2:emoji2-*:1.0.1 משוחרר. גרסה 1.0.1 כוללת את השמירות האלה.

תיקוני באגים

  • Emoji2 לא יאחז בעצמים של NumberKeyListener, כך שאפשר יהיה להגדיר את הלוקאל באמצעות TextView.
  • ‏Appcompat לא יא包ב את המופעים של NumberKeyListener שהועברו אל setKeyListener, וכך TextView יוכל להגדיר את הלוקאל ב-NumberKeyListeners בצורה נכונה. (Ibf113, ‏ b/207119921)

גרסה 1.0.0

17 בנובמבר 2021

androidx.emoji2:emoji2-*:1.0.0 משוחרר. גרסה 1.0.0 כוללת את ההצהרות האלה.

תכונות עיקריות בגרסה 1.0.0

androidx.emoji2 מחליף את androidx.emoji עם יכולות נוספות:

  • הפחתת גודל ה-APK לעומת androidx.emoji
  • הגדרה אוטומטית
  • הוספה כיחסי תלות ל-appcompat 1.4

מידע נוסף על androidx.emoji2 זמין במאמר תמיכה בסמלי אמוג'י מודרניים ובשיחה שלנו בכנס Android Dev Summit בנושא הצגת כל סמלי האמוג'י באפליקציה שלכם.

גרסה 1.0.0-rc01

27 באוקטובר 2021

androidx.emoji2:emoji2-*:1.0.0-rc01 משוחרר. גרסה 1.0.0-rc01 כוללת את ההוספות האלה.

  • אין שינויים מאז beta02.

Emoji2 גרסה 1.0.0-beta01

15 בספטמבר 2021

androidx.emoji2:emoji2-*:1.0.0-beta01 משוחרר. גרסה 1.0.0-beta01 כוללת את ההצהרות האלה.

שינויים ב-API

  • נוסף setLoadingExecutor ל-FontRequestEmojiCompatConfig, שמחליף את ה-API הקודם של setHandler. ה-API הזה מאפשר לאפליקציות להגדיר את FontRequestEmojiCompatConfig כך שישתמש בכל מבצע ברקע.

    השינוי הזה הוא שינוי משמעותי לעומת androidx.emoji:emoji, ולכן setHandler נשאר כ-API מבוטל ללא פעולה כדי לעזור בהעברה. (I6cd48)

  • EmojiCompat מגדיר בצורה נכונה את EditorInfo.extras ב-Android 11

    • ווידג'טים מותאמים אישית שמשתמשים ב-IME שאינו תת-סוג של EditText יכולים להפעיל את EmojiCompat.updateEditorInfo כדי להודיע ל-IME שהם תומכים בעיבוד של EmojiCompat. (I1ea9b)

תיקוני באגים

  • תיקון של DefaultEmojiCompatConfig כדי לחפש בצורה נכונה את ספק הגופן של האמוג'י ב-API 19 וב-28. התיקון הזה מתקן באג שהופיע ב-emoji2‏ 1.0.0-alpha01. (Ib33d8, ‏ b/197906329)

גרסה 1.0.0-alpha03

30 ביוני 2021

androidx.emoji2:emoji2-*:1.0.0-alpha03 משוחרר. גרסה 1.0.0-alpha03 מכילה את ההצהרות האלה.

תכונות חדשות

הגרסה הזו כוללת תיקוני באגים ושיפורי יציבות.

  1. עכשיו אפשר להעביר את null כ-KeyListener ב-EmojiEditTextHelper. כך ניתן להשתמש בהתנהגות הפלטפורמה שמאפשרת להחיל ערכים null על הטמעות של EditText שתומכות באמוג'י.
  2. כשמשתמשים ב-EmojiCompatInitializer, עיכוב ההפעלה הראשונית משופר כך שיופעל אחרי שהפעילות הראשונה תתחדש. כך ההפעלה של האפליקציה מתבצעת ללא תחרות, ומונעת את טעינת הגופן בהפעלות של אפליקציות שמעולם לא מציגות ממשק משתמש. אחרי עיכוב קצר, EmojiCompat תיצור שרשור כדי לטעון את גופן האמוג'י.
  • כדי להטמיע את העיכוב, נוסף יחסי תלות חדש ב-androidx.lifecycle:lifecycle-process מ-androidx.emoji2:emoji2. לא תהיה השפעה משמעותית על גודל קובץ ה-APK של אפליקציות שכבר כוללות את מחזור החיים (כמו אפליקציות עם appcompat).

שינויים ב-API

  • מתן הרשאה ל-KeyListener של null ב-AppCompatEditText. הפעולה הזו מבטלת את ההערה ללא ערך null שנוספה ל-AppCompatEditText בגרסה 1.4.0-alpha01, ומחזירה את ההתנהגות הקודמת כשעובר ערך null. (I21482, ‏ b/189559345)

תיקוני באגים

  • משנים את EmojiCompatInitializer כדי לעכב את טעינת הגופן עד 500 אלפיות השנייה אחרי ה-Activity.onResume הראשון. כך הפעילות יכולה לבצע את הפונקציות Application.onCreate ו-Activity.onCreate ללא תחרות, ועדיין לוודא שגופן הסמלי הרגשי נטען זמן קצר אחרי הפעלת האפליקציה. (I4bff7)

גרסה 1.0.0-alpha02

2 ביוני 2021

התכונות androidx.emoji2:emoji2:1.0.0-alpha02, androidx.emoji2:emoji2-views:1.0.0-alpha02 וגם androidx.emoji2:emoji2-views-helper:1.0.0-alpha02 משוחררות. גרסה 1.0.0-alpha02 מכילה את ההצהרות האלה.

שינויים ב-API

  • השם של החבילה ב-emoji2-views-helper השתנה ל-androidx.emoji2.viewsintegration. זוהי שינוי שגורם לשינוי משמעותי ב-AppCompat 1.4.0-alpha01, והאפליקציות צריכות לוודא שהתלות ב-AppCompat מתעדכנת כך שתשתמש בגרסה החדשה של emoji2. (Ie8397)

גרסה 1.0.0-alpha01

18 במאי 2021

התכונות androidx.emoji2:emoji2:1.0.0-alpha01, androidx.emoji2:emoji2-views:1.0.0-alpha01 וגם androidx.emoji2:emoji2-views-helper:1.0.0-alpha01 משוחררות. גרסה 1.0.0-alpha01 מכילה את ההוספות האלה.

התכונות בגרסה הראשונית הזו

מומלץ לשלב את emojicompat בכל האפליקציות כדי לתמוך בסמלי אמוג'י מודרניים מ-API19. כל התוכן שנוצר על ידי משתמשים באפליקציה מכיל את התג 🎉.

EmojiCompat עבר מהארטיפקטים של androidx.emoji לארטיפקטים החדשים של androidx.emoji2, שנמצאים עכשיו בגרסת alpha01. הארטיפקטים החדשים מחליפים את הגרסה הקודמת.

emoji2 מתווסף כיחס תלות ל-AppCompat החל מ-AppCompat 1.4.0-alpha01, והוא מופעל כברירת מחדל בתצוגות של AppCompat.

הארטיפקט emoji2 מציג הגדרה אוטומטית חדשה באמצעות הספרייה androidx.startup. כבר לא צריך לכתוב קוד 👨🏽‍💻 כדי להציג 🐻‍❄️.

השינויים ב-emoji2 מ-emoji

  • נוספה הגדרה אוטומטית חדשה EmojiCompatInitializer באמצעות androidx.startup.
  • נוספה הגדרת ברירת מחדל חדשה שמשתמשת במיקום השירות כדי למצוא ספק גופנים שניתן להורדה בקטע DefaultEmojiCompatConfiguration.
  • הכיתות הועברו מחבילת androidx.emoji לחבילה androidx.emoji2.
  • מחלקים את EmojiTextView ואת התצוגות הקשורות לארטיפקט נפרד emoji2-views. צריך להשתמש באפשרות הזו רק אם האפליקציה לא משתמשת ב-appcompat.
  • כלי עזר שחולצו לשילוב emojicompat בתצוגות בהתאמה אישית, בארטיפקט נפרד emoji2-views-helper.
  • נוספו הערות לגבי יכולת השימוש באפס.
  • עכשיו אפשר להשתמש בעזרים ב-emoji2-views-helper גם כש-EmojiCompat לא מופעל (בעבר הם העלו חריגה).

איזה יחסי תלות צריך להוסיף?

  • אפליקציות עם AppCompat צריכות לשדרג לגרסה AppCompat 1.4.0-alpha01 ואילך.
  • באפליקציות ללא AppCompat שמשתמשות ב-TextView/EditText מהפלטפורמה, צריך להשתמש ב-EmojiTextView ובכיתות קשורות מ-emoji2-views.

איך תומכים בתצוגות בהתאמה אישית

  • אפליקציות עם AppCompat צריכות להרחיב את AppCompatTextView,‏ AppCompatButton וכו' במקום את הפלטפורמה TextView וכו'.
  • באפליקציות ללא AppCompat צריך להוסיף תלות ב-androidx.emoji2:emoji2-views-helper ולהשתמש בעזרים כדי לשלב אותן עם תתי-כיתות בהתאמה אישית של TextView או EditText.

הגדרת אתחול אוטומטי

  • כדי להשבית את האינטראקציה האוטומטית, אפשר להוסיף את הקטע הבא למניפסט:

     <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>

  • הפעולה הזו משביתה את ההגדרה האוטומטית, ואז אפשר להעביר הגדרה מותאמת אישית אל EmojiCompat.init. אפשר לאחזר את הגדרות ברירת המחדל של המערכת DefaultEmojiCompatConfig.create(context) כדי לבצע הגדרות נוספות לפני העברה אל EmojiCompat.init.