תמיכה ב-Unicode ובבינלאומיות

ב-Android נעשה שימוש בספריית ICU וב פרויקט CLDR כדי לספק תמיכה ב-Unicode ובתמיכה בינלאומית אחרת. הדיון בדף הזה על תמיכה ב-Unicode ובתמיכה בינלאומית מחולק לשני חלקים: Android 6.0 (רמת API ‏23) וגרסאות ישנות יותר, ו-Android 7.0 (רמת API ‏24) וגרסאות חדשות יותר.

תמיכה ב-Unicode ובתהליך הבינלאומיזציה עד Android 6.0 (רמת API‏ 23)

פלטפורמת Android משתמשת ב-ICU וב-CLDR כדי להטמיע כיתות שונות לטיפול באיות לטינית ובאיות שאינו לטינית, ומציגה כיתות כמו Locale,‏ Character ותת-כיתות רבות של java.text. אפליקציה שדורשת פונקציונליות של בינלאומיזציה מעבר לכיתות החשופות, וטירגטת לגרסאות של הפלטפורמה עד Android 6.0 (רמת API ‏23), חייבת לכלול את ספריית ICU.

ניהול גרסאות

גרסאות מתקדמות יותר של פלטפורמת Android תואמות לגרסאות חדשות יותר של ICU ולגרסאות התואמות של CLDR ו-Unicode. בטבלה 1 מוצגת ההתאמה הזו עד Android 6.0 (רמת API ‏23).

טבלה 1. גרסאות ICU ו-CLDR ששימשו עד Android 6.0 (רמת API 23).

פלטפורמה (רמת API)	טיפול נמרץ	CLDR	Unicode
Android מגרסה 1.5 עד 2.0 (רמות API 3 עד 7)	3.8	1.5	5.0
Android 2.2 (רמת API 8)	‫4.2	1.7	5.1
Android מגרסה 2.3 עד 3.0 (רמות API 9 עד 13)	4.4	1.8	5.2
Android 4.0 (רמות API 14 עד 15)	4.6	1.9	6.0
Android 4.1 (רמות API 16-17)	4.8	2.0	6.0
Android 4.3 (רמת API 18)	50	22.1	6.2
Android 4.4 (רמות API 19 עד 20)	51	23	6.2
Android 5.0 (רמות API 21 עד 22)	53	25	6.3
Android 6.0 (רמת API 23)	55.1	27.0.1	7.0

מסגרת Android מספקת תמיכה מקיפה יותר ב-Unicode ובתהליך ההתאמה לשוק הבינלאומי לאפליקציות שמטרגטות את Android 7.0 (רמת API 24) ואילך. בקטע הבא בדף הזה מפורט מידע על התמיכה.

תמיכה ב-Unicode ובבינלאומיות ב-Android 7.0 (רמת API 24) ואילך

ב-Android 7.0 (רמת API 24) ואילך, פלטפורמת Android חושפת קבוצת משנה של ממשקי ה-API של ICU4J למפתחי אפליקציות, לשימוש בחבילה android.icu. ICU4J היא קבוצה של ספריות Java בקוד פתוח שנעשה בהן שימוש נרחב, ומספקת תמיכה ב-Unicode ובתהליך הבינלאומיזציה לאפליקציות תוכנה.

ממשקי ה-API של ICU4J משתמשים בנתוני לוקליזציה שנמצאים במכשיר. כתוצאה מכך, אפשר לצמצם את טביעת הרגל של האפליקציה על ידי הימנעות מהקמה של ספריות ICU4J באפליקציה. במקום זאת, אפשר להפעיל אותן במסגרת. במקרה כזה, כדאי לספק מספר גרסאות של ה-APK, כדי שמשתמשים שמפעילים גרסאות Android שקודמות ל-Android 7.0 (רמת API 24) יוכלו להוריד גרסה של האפליקציה שמכילה את ספריות ה-ICU4J.

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

ICU4J ב-Android

מערכת Android חושפת קבוצת משנה של ממשקי ה-API של ICU4J דרך החבילה android.icu, ולא com.ibm.icu. חלק מממשקי ה-API של ICU4J לא נחשפים על ידי Android Framework, מסיבות כמו הוצאה משימוש של ממשקי ה-API או שהם לא הוצהרו כיציבים. כשצוות ICU יוציא משימוש ממשקי API בעתיד, גם Android יסמן אותם ככאלה, אבל ימשיך לכלול אותם.

ריכזנו כאן כמה תזכורות:

• ממשקי ה-API של מסגרת Android של ICU4J לא כוללים את כל ממשקי ה-API של ICU4J.
• ממשקי ה-API במסגרת Android לא מחליפים את התמיכה של Android בתרגום באמצעות משאבים.
• במקרים מסוימים, מסגרת Android תומכת ביותר תווים מאשר ספריות ICU. למשל, בכיתה android.text יש תמיכה בסמלי אמוג'י.

מעבר לחבילה android.icu מ-com.ibm.icu

אם אתם כבר משתמשים בממשקי ה-API של ICU4J באפליקציה, וממשקי ה-API של android.icu עומדים בדרישות שלכם, כדי לעבור לממשקי ה-API של המסגרת תצטרכו לשנות את ייבוא ה-Java מ-com.ibm.icu ל-android.icu. לאחר מכן תוכלו להסיר את העותק שלכם של קובצי ICU4J מהאפליקציה.

הערה: ממשקי ה-API של מסגרת ICU4J משתמשים במרחב השמות android.icu במקום com.ibm.icu. המטרה היא למנוע קונפליקט במרחב השמות באפליקציות שמכילות ספריות com.ibm.icu משלהם.

מעבר לממשקי API של android.icu מממשקי API אחרים של Android SDK

לכיתות מסוימות בחבילות java ו-android יש מקבילות לכיתות ב-ICU4J. עם זאת, ב-ICU4J יש לעיתים קרובות תמיכה רחבה יותר בתקנים ובשפות.

כדי לעזור לכם להתחיל, בטבלה 2 מוצגות כמה דוגמאות לשוויונים הבאים:

טבלה 2.מחלקות ICU4J של Android ו-Java

דרגה	אפשרויות אחרות
java.lang.Character	android.icu.lang.UCharacter
java.text.BreakIterator	android.icu.text.BreakIterator
java.text.DecimalFormat	android.icu.text.DecimalFormat
java.util.Calendar	android.icu.util.Calendar
android.text.BidiFormatter	android.icu.text.Bidi
android.text.format.DateFormat	android.icu.text.DateFormat
android.text.format.DateUtils	android.icu.text.DateFormat android.icu.text.RelativeDateTimeFormatter

ICU4C ב-Android

Android חושף קבוצת משנה של ממשקי ה-API של ICU4C דרך הספרייה libicu.so, ולא דרך libicuuc.so או libicui18n.so. ממשקי ה-API זמינים החל מ-Android 12 (רמת API ‏31). כותרות NDK זמינות החל מגרסת r22b של NDK. אין ממשק API של C++‎ שחשוף דרך Android NDK. חלק מממשקי ה-API של C לא זמינים.

ניהול גרסאות

גרסאות מתקדמות יותר של פלטפורמת Android תואמות לגרסאות חדשות יותר של ICU ולגרסאות התואמות של CLDR ו-Unicode. בטבלה 3 מוצגת ההתאמה הזו החל מ-Android 7.0 (רמת API‏ 24). משתמשים ב-API‏ VersionInfo.ICU_VERSION (זמין מאז Android 7.0) כדי לקבל את פרטי הגרסה של ICU בזמן הריצה.

טבלה 3 גרסאות ICU ו-CLDR שנעשה בהן שימוש בגרסאות Android, החל מ-Android 7.0 (רמת API 24) ועד Android 15 (רמת API 35).

פלטפורמה (רמת API)	טיפול נמרץ	CLDR	Unicode
Android בגרסה 7.0 עד 7.1 (רמות API 24 עד 25)	56	28	8.0
Android מגרסה 8.0 עד 8.1 (רמות API 26 עד 27)	58.2	30.0.3	9.0
Android 9 (רמת API 28)	60.2	32.0.1	10.0
Android 10 (רמת API 29)	63.2	34	11.0
Android 11 (רמת API 30)	66.1	36	13.0
Android 12 (רמת API 31 עד 32)	68.2	38.1	13.0
Android 13 (רמת API 33)	70.1	40	14.0
Android 14 (רמת API 34)	72.1	42	15.0
Android 15 (רמת API 35)	75.1	45	15.1

הגדרת פורמט השעה 24 שעות/12 שעות

המכשיר של המשתמש לטיפול נמרץ ב-Android לא בודק את הגדרת הפורמט של המשתמש בפורמט 24 שעות/12 שעות, שמתקבלת מ- DateFormat.is24HourFormat(). כדי לפעול בהתאם להגדרה הזו, צריך להשתמש בשיטות של DateFormat או DateUtils לעיצוב זמן, או להשתמש בדפוסים של ICU לעיצוב זמן עם סמלי דפוס שעה מתאימים ('h' ל-12 שעות, 'H' ל-24 שעות) עבור ערכי חזרה שונים של is24HourFormat(). לדוגמה, הקוד הזה יוצר מחרוזת עם השעה הנוכחית בהתאם להגדרת המשתמש של 12 שעות/24 שעות:

Kotlin

val skeleton: String = if (DateFormat.is24HourFormat(context)) "Hm" else "hm"
val formattedTime: String = android.icu.text.DateFormat.getInstanceForSkeleton(
        skeleton,
        Locale.getDefault()).format(Date()
)

Java

String skeleton = DateFormat.is24HourFormat(context) ? "Hm" : "hm";
String formattedTime = android.icu.text.DateFormat.getInstanceForSkeleton(skeleton, Locale.getDefault()).format(new Date());

היציבות של המתרגם

החל מ-Android 10 (רמת API 29), ה-method‏ Transliterator זמין להמרת טקסט מפורמט אחד לאחר. קבוצת מזהי התעתיק הזמינים לא יציבה במכשירים ובגרסאות השונות של Android. יצרני המכשירים עשויים להוסיף עוד מזהי תעתוק. המפתחים צריכים לבדוק את המזהים הזמינים שהתקבלו מ- Transliterator.getAvailableIDs(), לפני תעתיק הטקסט.

רישוי

ICU4J משוחרר במסגרת רישיון ICU. לפרטים נוספים, אפשר לעיין במדריך למשתמש של ICU.