يوفّر "محرِّر الترجمات" عرضًا موحّدًا وقابلاً للتعديل لجميع مصادر السلاسل النصية التلقائية والمترجَمة.
للحصول على مقدمة حول ترجمة تطبيقك إلى لغات مختلفة، يُرجى الاطّلاع على مقالة إتاحة لغات وثقافات مختلفة.
مصدر السلاسل النصية
يتم تضمين موارد السلاسل النصية لمشروع في ملفات strings.xml. يحتوي مشروعك على ملف strings.xml تلقائي يتضمّن موارد السلاسل النصية باللغة التلقائية لتطبيقك، وهي اللغة التي تتوقّع أن يتحدث بها معظم مستخدمي تطبيقك. يمكنك أيضًا الحصول على ملفات strings.xml مترجَمة تحتوي على موارد السلاسل النصية للغات أخرى تريد أن يستوعبها تطبيقك.
بعد إكمال ملف strings.xml التلقائي، يمكنك إضافة الترجمات بنفسك أو الدفع مقابل الخدمات المهنية لإجراء الترجمات.
في كلتا الحالتين، عليك الاستفادة من ميزات "استوديو Android" لمساعدتك في إدارة النصوص القابلة للترجمة واختبارها. للحصول على معلومات حول خدمات الترجمة الاحترافية، يُرجى الاطّلاع على خدمات الترجمة.
فتح "محرِّر الترجمات"
يمكنك الوصول إلى "محرِّر الترجمات" من الأماكن التالية في Android Studio.
الفتح من عرض Android
- في لوحة Project > Android (المشروع > Android) على يمين الصفحة، اختَر ModuleName > res > values.
انقر بزر الماوس الأيمن على ملف strings.xml، ثم اختَر فتح محرِّر الترجمات.
يعرض "محرِّر الترجمة" أزواج المفاتيح والقيم من ملف
strings.xml.
يوضّح الشكل 1 نص التطبيق التلقائي (في هذه الحالة، باللغة الإنجليزية) في "محرِّر الترجمة" لتطبيق قبل تنفيذ أعمال الترجمة. سيظهر محتوى ملفات strings.xml المترجَمة على يسار عمود غير قابل للترجمة، مع عمود واحد لكل لغة، كما هو موضّح في الشكل 2.
الفتح من داخل strings.xml
يمكنك الوصول إلى محرِّر الترجمات من داخل أي من ملفات strings.xml.
- في لوحة المشروع > Android على يمين الصفحة، اختَر ModuleName > res > values.
- انقر مرّتين على strings.xml لفتحه وتعديله.
- في strings.xml، انقر على رابط فتح المحرِّر في أعلى يسار الصفحة.
ضبط الصفوف غير القابلة للترجمة
في محرِّر الترجمة، يمكنك اختيار غير قابل للترجمة للإشارة إلى أنّك لا تريد ترجمة النص في هذا الصف. قد يكون النص الذي لا تريد ترجمته نصًا خاصًا بالمنتج، مثل الأسماء التجارية والعلامات التجارية، أو مصطلحات فنية ليس لها ترجمة.
عند اختيار غير قابل للترجمة، يضيف السطر المقابل في ملف 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 للغة الإسبانية.
لحذف لغة، اتّبِع الخطوات التالية:
يمكنك حذف لغة في محرِّر الترجمات عن طريق حذف كل قيمة في العمود (راجِع تعديل النص وإضافته وحذفه)، أو يمكنك حذف مجلد المشروع لتلك اللغة، على النحو التالي:
- في لوحة المشروع > Android على يمين الصفحة، اختَر ModuleName > res.
- انقر بزر الماوس الأيمن على المجلد values-* للغة التي تريد حذفها. على سبيل المثال، values-hi للغة الهندية.
- من القائمة، اختَر حذف لحذف المجلد وملف strings.xml.
تعديل النص وإضافته وحذفه
يمكنك إجراء عمليات على إعدادات النص مباشرةً في ملف strings.xml أو من خلال محرِّر الترجمة. يصف هذا القسم طريقة استخدام محرِّر الترجمة. في محرِّر الترجمات، يمكنك تعديل النص أو إضافته أو حذفه
من خلال العرض على شكل قائمة أو من خلال حقل الترجمة في أسفل
محرِّر الترجمات.
عرض القائمة
لتعديل نص أو إضافته، اتّبِع الخطوات التالية:
- انقر مرّتين على الخلية التي تريد تعديل النص فيها أو إضافة نص إليها.
- انسخ والصق باستخدام لوحة المفاتيح، أو إذا كانت لديك لوحة مفاتيح تتيح استخدام علامات التشكيل، اكتب مباشرةً في العرض على شكل قائمة.
- اضغط على مفتاح Tab أو حرِّك المؤشر خارج الحقل.
لحذف نص، اتّبِع الخطوات التالية:
- انقر مرّتين على الخلية التي تريد حذفها.
- في العرض على شكل قائمة، اختَر النص واضغط على حذف.
- اضغط على مفتاح التبويب (Tab) أو حرِّك المؤشر خارج الحقل.
حقل الترجمة
لتعديل نص أو إضافته، اتّبِع الخطوات التالية:
- في العرض على شكل قائمة، انقر مرة واحدة على الخلية التي تريد تعديل النص فيها أو إضافة نص إليها.
- في حقل الترجمة، انسخ النص والصقه باستخدام لوحة المفاتيح، أو إذا كانت لديك لوحة مفاتيح تتيح استخدام علامات التشكيل، اكتب مباشرةً في حقل الترجمة.
- اضغط على مفتاح التبويب (Tab) أو حرِّك المؤشر خارج الحقل.
لحذف نص، اتّبِع الخطوات التالية:
- انقر مرة واحدة على الخلية التي تريد حذفها.
- في حقل الترجمة، اختَر النص واضغط على حذف.
إضافة المفاتيح وحذفها
في "محرّر الترجمة"، يسرد عمود المفتاح المعرّفات الفريدة لكل عنصر بيانات في ملفات strings.xml. يمكنك إضافة المفاتيح وحذفها من خلال
"محرِّر الترجمات". عند حذف مفتاح، يحذفه "محرِّر الترجمة"
وجميع الترجمات المرتبطة به. يستخدم "محرِّر الترجمة" إعادة هيكلة "الحذف الآمن" لحذف مفتاح حتى تعرف ما إذا كان نص المفتاح مستخدَمًا في مكان آخر، وتتاح لك فرصة إجراء التعديلات اللازمة قبل حذف المفتاح. تضمن إعادة هيكلة الحذف الآمن أن يظل الرمز الخاص بك يجمع بعد حذف المفتاح.
لإضافة مفتاح، اتّبِع الخطوات التالية:
- في محرِّر الترجمات، انقر على إضافة مفتاح
. في مربّع الحوار، أدخِل اسم المفتاح والقيمة التلقائية وموقع ملف strings.xml التلقائي.
الشكل 3. إضافة مفتاح
لحذف مفتاح، اتّبِع الخطوات التالية:
- في "محرِّر الترجمات"، اختَر المفتاح الذي تريد حذفه.
- انقر على إزالة المفاتيح
. في مربع الحوار Delete (حذف)، حدد ما إذا كنت تريد حذفًا آمنًا وما إذا كنت تريد البحث في التعليقات والسلاسل، ثم انقر على OK (موافق).
الشكل 4. مربّع حوار الحذف إذا لم تكن هناك مراجع (استخدامات) للمفتاح المحذوف، أو إذا كانت جميع المراجع قابلة للطي بأمان، فسيتم حذف المفتاح. بخلاف ذلك، يعرض "محرِّر الترجمة" مربّع الحوار الاستخدامات التي تم رصدها مع معلومات حول المشاكل التي تم رصدها.
الشكل 5. مربّع الحوار "تم رصد استخدامات" انقر على عرض الاستخدامات لمراجعة ما سيتم حذفه. يعرض مربّع الحوار العثور على تعارضات الحذف الآمن جميع الاستخدامات التي لا يمكن حذفها بأمان حتى تتمكّن من تعديل الرمز المقابل.
الشكل 6: الاستخدامات غير الآمنة انقر بزر الماوس الأيمن على أحد الاستخدامات لعرض قائمة السياق واختَر الانتقال إلى المصدر لإجراء التغييرات اللازمة.
في لوحة العثور على تعارضات الحذف الآمن، اختَر إعادة تشغيل الحذف الآمن للتأكّد من عدم وجود استخدامات أخرى تستدعي الانتباه.
عند الانتهاء من تنظيف الاستخدامات، انقر على Do Refactor (إعادة الهيكلة) لحذف المفتاح.
تصحيح الأخطاء
يعرض الشكل 7 محرِّر الترجمات الذي يعرض محتوى ملفات strings.xml باللغات الإنجليزية والفرنسية والإسبانية. يشير النص الأحمر إلى الأسطر
التي تحتوي على أخطاء.
لتصحيح خطأ، مرِّر مؤشر الماوس فوق النص الأحمر لعرض شرح للمشكلة وحلّها.
عند إجراء تغييرات في محرّر الترجمة، يتم تعديل ملفات strings.xml الأساسية وفقًا لتغييراتك. عند إجراء تغييرات في ملف strings.xml، يتم تعديل العمود المقابل في محرِّر الترجمة بالتغييرات التي أجريتها.
أمثلة على تصحيحات محرِّر الترجمة:
- يوضّح الشكل 7 أنّ الصف app_name يحتوي على علامة في المربّع غير قابل للترجمة، ولكن هناك ترجمة إسبانية مقدَّمة. احذف الترجمة الإسبانية لتصحيح الخطأ.
- يوضّح الشكل 7 أنّ الصف next_page لا يتضمّن ترجمة فرنسية. استخدِم لوحة المفاتيح لنسخ Page Suivante في الخلية لتصحيح الخطأ. تؤدي عملية النسخ واللصق باستخدام لوحة المفاتيح إلى نسخ النص مع أي علامات تشكيل إلى الخلية.
إدارة النصوص القابلة للترجمة واختبارها
يوفّر نظام Android الأساسي و"استوديو Android" العديد من الميزات لمساعدتك في إدارة نص تطبيقك القابل للترجمة واختباره. تتضمّن هذه الميزات خيارات لمساعدتك في استهداف المشاكل المتعلّقة بالنصوص المكتوبة من اليمين إلى اليسار (RTL)، مثل العربية أو العبرية. يتيح لك اختبار النص القابل للترجمة إجراء تعديلات على نص واجهة المستخدم وتخطيطه قبل إرسال رسائلك إلى مستودع المصدر لإرسالها للترجمة لاحقًا.
دعم اللغات التي تُكتب من اليمين إلى اليسار
يتعامل Jetpack Compose مع التنسيقات من اليمين إلى اليسار (RTL) بشكل أصلي. تعتمد معدِّلات التنسيق وواجهات برمجة التطبيقات على مفاهيم الاتجاهات، مثل start وend، بدلاً من الاتجاهات المطلقة، مثل left وright. عندما تتغير لغة النظام إلى لغة تُكتب من اليمين إلى اليسار، يعكس Compose هذه التنسيقات تلقائيًا.
لكي يتعرّف تطبيقك على اللغة التي تُكتب من اليمين إلى اليسار ويشغّل هذا الانعكاس، عليك الموافقة على استخدام ملف بيان تطبيقك.
لتفعيل ميزة "الكتابة من اليمين إلى اليسار"، اتّبِع الخطوات التالية:
- افتح ملف
AndroidManifest.xml. - أضِف السمة
android:supportsRtl="true"إلى العنصر<application>:
<manifest ... >
<application
...
android:supportsRtl="true">
</application>
</manifest>
لمزيد من المعلومات حول كيفية تعامل Compose مع تنسيق النص والنسخ المتطابق وإعدادات RTL المخصّصة، يُرجى الاطّلاع على العمل مع لغات RTL.
ضبط اتجاه النص يدويًا
في Jetpack Compose، لا تستخدم نافذة "الخصائص" المرئية لفرض اتجاهات التنسيق أو النص. يتعامل Compose تلقائيًا مع النسخ المتطابق من اليمين إلى اليسار استنادًا إلى لغة النظام.
ومع ذلك، إذا كنت بحاجة إلى إلغاء الاتجاه يدويًا لعنصر نصي معيّن (على سبيل المثال، عرض سلسلة من اليسار إلى اليمين في تنسيق من اليمين إلى اليسار)، يمكنك تمرير كائن TextDirection إلى TextStyle.
تشمل القيم المسموح بها ما يلي:
TextDirection.Content: (Default): يستنتج الاتجاه من أول حرف اتجاهي قوي.-
TextDirection.Ltr: لفرض الاتجاه من اليسار إلى اليمين -
TextDirection.Rtl: لفرض الاتجاه من اليمين إلى اليسار
لمزيد من المعلومات حول تصميم النص وضبط اتجاهات النص اليدوية في Compose، يُرجى الاطّلاع على تصميم النص.
استخدام سلاسل مترجَمة في تطبيقك
بعد إضافة السلاسل وترجمتها باستخدام "محرّر الترجمة"،
يتم تلقائيًا تعديل ملفات res/values/strings.xml الأساسية ويمكنك
استخدام الموارد المترجَمة مباشرةً في واجهة المستخدم.
لمعرفة كيفية عرض نص مترجَم والتعامل مع اللغات التي تُكتب من اليمين إلى اليسار بشكل أصلي واستخدام @Preview
لاختبار اللغات المختلفة واللغات الزائفة، يُرجى الاطّلاع على قسم السلاسل من
"الموارد" في Compose.
اللغات المحلية الزائفة
اللغة الزائفة هي لغة محاكاة مصمَّمة لتتّخذ خصائص اللغات التي تسبّب مشاكل في واجهة المستخدم والتصميم والكتابة من اليمين إلى اليسار وغيرها من مشاكل الترجمة عند ترجمة تطبيق. توفّر اللغات الزائفة ترجمات فورية وتلقائية يمكن قراءتها باللغة الإنجليزية لجميع الرسائل التي يمكن ترجمتها. يتيح لك ذلك العثور على الرسائل غير القابلة للترجمة في الرمز المصدر.
للحصول على معلومات حول كيفية استخدام اللغات الزائفة، يُرجى الاطّلاع على مقالة اختبار تطبيقك باستخدام اللغات الزائفة.