עורך התרגומים מספק תצוגה מאוחדת וניתנת לעריכה של כל משאבי המחרוזות שמוגדרים כברירת מחדל ושל אלה שתורגמו.
במאמר תמיכה בשפות ובתרבויות שונות מוסבר איך לתרגם את האפליקציה לשפות שונות.
משאבי מחרוזות
משאבי המחרוזות של פרויקט נמצאים בקובצי strings.xml. לפרויקט יש קובץ strings.xml שמוגדר כברירת מחדל ומכיל משאבי מחרוזות בשפת ברירת המחדל של האפליקציה, שהיא השפה שרוב המשתמשים באפליקציה אמורים לדבר בה. אפשר גם לתרגם קובצי strings.xml שמכילים משאבי מחרוזות לשפות אחרות שרוצים שהאפליקציה תתמוך בהן.
אחרי שקובץ ברירת המחדל של strings.xml מוכן, אתם יכולים להוסיף את התרגומים בעצמכם או לשלם לבעלי מקצועות חופשיים שיבצעו את התרגומים.
בכל מקרה, כדאי להשתמש בתכונות של Android Studio כדי לנהל ולבדוק טקסט שניתן להתאים לשוק המקומי. מידע על שירותי תרגום מקצועיים זמין במאמר שירותי תרגום.
פתיחת הכלי לעריכת תרגומים
אפשר לגשת לעורך התרגומים מהמקומות הבאים ב-Android Studio.
פתיחה מתצוגת Android
- בחלונית Project > Android שמימין, בוחרים באפשרות ModuleName > res > values.
לוחצים לחיצה ימנית על הקובץ strings.xml ובוחרים באפשרות Open Translations Editor.
בעורך התרגומים מוצגים צמדי המפתח והערך מהקובץ
strings.xml.
בתמונה 1 מוצג טקסט ברירת המחדל של האפליקציה (במקרה הזה, אנגלית) בעורך התרגומים של אפליקציה לפני שבוצעו עבודות תרגום. התוכן של קובצי strings.xml המתורגמים יופיע משמאל לעמודה Untranslatable, עמודה אחת לכל שפה, כמו שמוצג באיור 2.
פתיחה מתוך strings.xml
אפשר לגשת אל Translations Editor מתוך כל אחד מקובצי strings.xml.
- בחלונית Project > Android שמימין, בוחרים באפשרות ModuleName > res > values.
- לוחצים לחיצה כפולה על strings.xml כדי לפתוח אותו לעריכה.
- ב-strings.xml, לוחצים על הקישור Open editor בפינה הימנית העליונה.
הגדרת שורות שלא ניתן לתרגם
בעורך התרגומים, אתם יכולים לבחור באפשרות לא ניתן לתרגום כדי לציין שאתם לא רוצים שהטקסט בשורה הזו יתורגם. טקסט שלא תרצו לתרגם יכול להיות טקסט ספציפי למוצר, כמו שמות מסחריים וסימנים מסחריים, או מונחים טכניים שאין להם תרגום.
כשבוחרים באפשרות Untranslatable, השורה התואמת בקובץ ברירת המחדל strings.xml מוסיפה את translatable="false". בדוגמה הבאה, EasyApp בשורה העליונה לא מתורגם כי זה שם המוצר.
<resources>
<string name="app_name" translatable="false">EasyApp</string>
<string name="action_settings">Settings</string>
<string name="easy_app">I am a Simple App!</string>
<string name="next_page">Next Page</string>
<string name="second_page_message">I am the Second Page!</string>
<string name="title_activity_second">SecondActivity</string>
</resources>
הוספה ומחיקה של שפות
עורך התרגומים תומך ב-BCP 47 ומשלב קודי לוקאל ואזור (מדינה) לבחירה אחת, כדי לאפשר התאמה לשוק המקומי באופן ממוקד. הלוקאל מגדיר יותר מהשפה. הגדרות המקום והשפה כוללות עיצובים שונים בהתאם למדינה, כמו תאריך ושעה, מטבעות ומספרים עשרוניים.
כדי להוסיף שפה:
- בעורך התרגומים, לוחצים על סמל הגלובוס
. בתפריט הנפתח, בוחרים את השפה שרוצים להוסיף.
השפה החדשה מופיעה בעורך התרגומים, ותיקיית values-* עם קובץ
strings.xmlנוספת לפרויקט. לדוגמה, values-es לספרדית.
כדי למחוק שפה:
כדי למחוק שפה בעורך התרגומים, אפשר למחוק את כל הערכים בעמודה (ראו עריכה, הוספה ומחיקה של טקסט) או למחוק את תיקיית הפרויקט של השפה הזו, באופן הבא:
- בחלונית Project > Android שמימין, בוחרים באפשרות ModuleName > res.
- לוחצים לחיצה ימנית על התיקייה values-* של השפה שרוצים למחוק. לדוגמה, values-hi להינדי.
- ברשימה, בוחרים באפשרות Delete כדי למחוק את התיקייה ואת הקובץ strings.xml שלה.
עריכה, הוספה ומחיקה של טקסט
אפשר לבצע פעולות בהגדרות הטקסט ישירות בקובץ strings.xml או דרך עורך התרגומים. בקטע הזה מתוארת הגישה של עורך התרגומים. בעורך התרגומים, אתם יכולים לערוך, להוסיף או למחוק טקסט דרך תצוגת הרשימה או דרך השדה תרגום שבתחתית עורך התרגומים.
תצוגת רשימה
כדי לערוך או להוסיף טקסט:
- לוחצים לחיצה כפולה על התא שבו רוצים לערוך או להוסיף טקסט.
- מעתיקים ומדביקים באמצעות המקלדת, או אם יש לכם מקלדת שתומכת בסימנים דיאקריטיים, מקלידים ישירות בתצוגת הרשימה.
- מקישים על Tab או מזיזים את הסמן אל מחוץ לשדה.
כדי למחוק טקסט:
- לוחצים לחיצה כפולה על התא שרוצים למחוק.
- בתצוגת הרשימה, בוחרים את הטקסט ולוחצים על מחיקה.
- מקישים על Tab או מזיזים את הסמן אל מחוץ לשדה.
שדה התרגום
כדי לערוך או להוסיף טקסט:
- בתצוגת הרשימה, לוחצים פעם אחת על התא שבו רוצים לערוך או להוסיף טקסט.
- בשדה Translation, מעתיקים ומדביקים באמצעות המקלדת, או אם יש לכם מקלדת שתומכת בסימנים דיאקריטיים, מקלידים ישירות בשדה Translation.
- מקישים על Tab או מזיזים את הסמן אל מחוץ לשדה.
כדי למחוק טקסט:
- לוחצים פעם אחת על התא שרוצים למחוק.
- בשדה תרגום, בוחרים את הטקסט ולוחצים על מחיקה.
הוספה ומחיקה של מפתחות
בעמודה מפתח בעורך התרגומים מופיעים המזהים הייחודיים של כל פריט נתונים בקובצי ה-strings.xml. אפשר להוסיף ולמחוק מפתחות דרך עורך התרגומים. כשמוחקים מפתח, עורך התרגומים מוחק אותו ואת כל התרגומים שמשויכים אליו. עורך התרגומים משתמש ב-Safe Delete refactoring כדי למחוק מפתח, כך שתוכלו לדעת אם הטקסט של המפתח נמצא בשימוש במקום אחר, ותהיה לכם הזדמנות לבצע את ההתאמות הנדרשות לפני שתמחקו את המפתח. הגדרת ה-refactoring של Safe Delete מבטיחה שהקוד עדיין יקומפל אחרי שתמחקו את המפתח.
כדי להוסיף מפתח:
- בעורך התרגומים, לוחצים על הוספת מפתח
. בתיבת הדו-שיח, מזינים שם מפתח, ערך ברירת מחדל ואת המיקום של קובץ ברירת המחדל strings.xml.
איור 3. הוספת מפתח
כדי למחוק מפתח:
- בעורך התרגומים, בוחרים את המפתח שרוצים למחוק.
- לוחצים על הסרת מפתחות
. בתיבת הדו-שיח Delete, מחליטים אם רוצים מחיקה בטוחה ואם רוצים לחפש בתגובות ובמחרוזות, ולוחצים על OK.
איור 4. תיבת הדו-שיח למחיקה אם אין הפניות (שימושים) למפתח שנמחק, או אם אפשר לכווץ את כל ההפניות באופן בטוח, המפתח נמחק. אחרת, בעורך התרגומים תוצג תיבת הדו-שיח Usages Detected עם מידע על הבעיות שזוהו.
איור 5. תיבת הדו-שיח "זוהו שימושים" לוחצים על הצגת השימושים כדי לבדוק מה יימחק. בתיבת הדו-שיח Find Safe Delete Conflicts מוצגים כל השימושים שלא בטוח למחוק, כדי שתוכלו לערוך את הקוד המתאים.
איור 6. שימושים לא בטוחים לוחצים לחיצה ימנית על שימוש כדי להציג את תפריט ההקשר ובוחרים באפשרות Jump to Source כדי לבצע את השינויים הנדרשים.
בחלונית Find Safe Delete Conflicts, בוחרים באפשרות Rerun Safe Delete כדי לוודא שאין שימושים אחרים שדורשים התייחסות.
אחרי שמנקים את השימושים, לוחצים על Do Refactor כדי למחוק את המפתח.
יש לתקן את השגיאות
בתמונה 7 מוצג עורך התרגומים עם התוכן של קובצי strings.xml באנגלית, בצרפתית ובספרדית. הטקסט האדום מציין שורות שיש בהן שגיאות.
כדי לתקן שגיאה, מעבירים את העכבר מעל הטקסט האדום כדי להציג הסבר על הבעיה ועל הפתרון שלה.
כשמבצעים שינויים בעורך התרגומים, קובצי ה-strings.xml הבסיסיים מתעדכנים בהתאם לשינויים. כשמבצעים שינויים בקובץ strings.xml, העמודה המתאימה בעורך התרגומים מתעדכנת בהתאם.
דוגמאות לתיקונים בעורך התרגומים:
- בתמונה 7 רואים שבשורה app_name מסומנת התיבה Untranslatable, אבל יש תרגום לספרדית. כדי לתקן את השגיאה, מחקו את התרגום לספרדית.
- בתמונה 7 אפשר לראות שבשורה next_page חסר תרגום לצרפתית. משתמשים במקלדת כדי להעתיק את Page Suivante לתא ולתקן את השגיאה. פעולת העתקה והדבקה באמצעות המקלדת מעתיקה את הטקסט עם סימני הניקוד לתא.
ניהול ובדיקה של טקסט שניתן להתאים לשוק המקומי
פלטפורמת Android ו-Android Studio מספקות כמה תכונות שיעזרו לכם לנהל ולבדוק את הטקסט של האפליקציה שניתן להתאים לשוק המקומי. התכונות האלה כוללות אפשרויות שעוזרות לטפל בבעיות בכתבים שנכתבים מימין לשמאל (RTL), כמו ערבית או עברית. בדיקת הטקסט שניתן להתאמה לשוק המקומי מאפשרת לכם לבצע שינויים בטקסט של ממשק המשתמש ובפריסה שלו לפני שאתם שומרים את ההודעות במאגר המקור כדי לשלוח אותן לתרגום בשלב מאוחר יותר.
תמיכה בשפות שנכתבות מימין לשמאל (RTL)
Jetpack Compose מטפל בפריסות מימין לשמאל (RTL) באופן מקורי. ממשקי API ומשתני פריסה מבוססים על מושגים שקשורים לכיוון, כמו start ו-end, ולא על כיוונים מוחלטים כמו left ו-right. כששפת המערכת משתנה לאזור שבו כותבים מימין לשמאל, Compose משקף את הפריסות האלה באופן אוטומטי.
כדי שהאפליקציה תזהה את הלוקאל מימין לשמאל ותפעיל את השיקוף הזה, צריך להביע הסכמה באמצעות קובץ המניפסט של האפליקציה.
כדי להפעיל תמיכה ב-RTL:
- פותחים את הקובץ
AndroidManifest.xml. - מוסיפים את המאפיין
android:supportsRtl="true"לרכיב<application>:
<manifest ... >
<application
...
android:supportsRtl="true">
</application>
</manifest>
במאמר עבודה עם שפות שנכתבות מימין לשמאל מוסבר איך Compose מטפל בפריסת טקסט, בשיקוף ובהגדרות אישיות של RTL.
הגדרה ידנית של כיוון הטקסט
ב-Jetpack Compose, לא משתמשים בחלון Properties חזותי כדי לאלץ כיווני פריסה או טקסט. Compose מטפל באופן אוטומטי בהיפוך מימין לשמאל על סמך הגדרות המערכת של המיקום הגיאוגרפי.
עם זאת, אם אתם צריכים לשנות באופן ידני את הכיוון של רכיב טקסט ספציפי (לדוגמה, הצגת מחרוזת משמאל לימין בפריסה מימין לשמאל), אתם יכולים להעביר אובייקט TextDirection אל TextStyle.
הערכים הנתמכים כוללים:
-
TextDirection.Content: (Default): המערכת מסיקה את הכיוון מהתו החזק הראשון. -
TextDirection.Ltr: מאלץ כיוון משמאל לימין. -
TextDirection.Rtl: כיוון מימין לשמאל.
במאמר עיצוב טקסט מוסבר איך לעצב טקסט ולהגדיר כיווני טקסט ידניים ב-Compose.
שימוש במחרוזות מותאמות לשוק המקומי באפליקציה
אחרי שמוסיפים ומתרגמים את המחרוזות באמצעות עורך התרגומים, קובצי ה-res/values/strings.xml הבסיסיים מתעדכנים באופן אוטומטי ואפשר להשתמש במשאבים המותאמים לשוק המקומי ישירות בממשק המשתמש.
כדי ללמוד איך להציג טקסט מותאם לשוק המקומי, לטפל ב-RTL באופן מקורי ולהשתמש ב-@Preview כדי לבדוק הגדרות שונות של מיקום גיאוגרפי והגדרות מיקום גיאוגרפי מדומות, עיינו בקטע Strings במאמר Resources in Compose.
לוקאלים מדומים
לוקאל מדומה הוא לוקאל שמדמה מאפיינים של שפות שגורמות לבעיות בממשק המשתמש, בפריסה, בכיוון מימין לשמאל ובבעיות אחרות בתרגום של אפליקציה. הלוקאלים המדומים מספקים תרגומים מיידיים ואוטומטיים שניתנים לקריאה באנגלית לכל ההודעות שניתנות להתאמה לשוק המקומי. כך תוכלו לזהות הודעות שלא ניתן לתרגם בקוד המקור.
למידע על השימוש בלוקאלים מדומים, ראו בדיקת האפליקציה באמצעות לוקאלים מדומים.