الوثائق / ترجم / Android strings.xml
ترجمة ملفات strings.xml لنظام Android
ترجمة ملفات res/values/strings.xml إلى مجلدات values-<lang>، مع معالجة الوسائط %1$s و <plurals> و <xliff:g> وهروب الفواصل العليا، وتخطي السلاسل النصية ذات السمة translatable="false".
كيف يعمل
يقرأ localize-dev translate res/values/strings.xml، أو composeResources/values/ الخاص بـ Compose Multiplatform، ويكتب values-ru/strings.xml و values-pt-rBR/strings.xml والباقي. يتم ترك السلاسل النصية المميزة بـ translatable="false"، ويذهب تعليق XML فوق السلسلة النصية إلى النموذج كسياق.
يتم إلغاء تسلسل النص قبل الترجمة وتسلسله مرة أخرى بعدها، لذا يظل You\'ve صالحًا ولا يؤدي الفاصلة العليا في ترجمة فرنسية أو إيطالية إلى كسر البناء. يظل CDATA هو CDATA.
قبل وبعد
الناتج الفعلي لـ localize-dev translate --locales ru على الملف الأول. تحتاج اللغة الروسية إلى few و many، ولا تتم ترجمة اسم التطبيق، ويتم الاحتفاظ بعنصر <xliff:g> كما هو مكتوب.
<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="app_name" translatable="false">Trailmap</string>
<!-- Shown on the home screen above the list of trails -->
<string name="home_title">Trails near you</string>
<string name="saved_trail">You\'ve saved %1$s to <xliff:g id="list">%2$s</xliff:g></string>
<plurals name="trails_found">
<item quantity="one">%d trail found</item>
<item quantity="other">%d trails found</item>
</plurals>
</resources><?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="home_title">Трейлы рядом с вами</string>
<string name="saved_trail">Вы сохранили %1$s в <xliff:g id="list">%2$s</xliff:g></string>
<plurals name="trails_found">
<item quantity="one">%d трейл найден</item>
<item quantity="few">%d трейла найдено</item>
<item quantity="many">%d трейлов найдено</item>
<item quantity="other">%d трейлов найдено</item>
</plurals>
</resources>ما يبقى سليماً
%1$sو%dووسائط التنسيق الأخرى، تم التحقق منها<xliff:g>عناصر span، تُحفظ كما هي بالضبط<plurals>بالكميات التي تستخدمها كل لغة- ترميز مضمن مثل
<b>، و CDATA حيث يوجد في المصدر
الأخطاء الشائعة، وكيفية تجنبها
علامات الاقتباس المفردة غير المهربه
يجب كتابة “l’application” كـ l\'application في strings.xml، وإلا سيفشل مترجم الموارد في عملية البناء. يتم تهريب كل ترجمة عند إدخالها في الملف.
الكميات المفقودة
تستخدم اللغات الروسية والبولندية والعربية few و many. مع وجود one و other فقط، يعود getQuantityString إلى other للأعداد مثل 3، وتكون القواعد النحوية خاطئة.
ترجمة ما يجب أن يبقى
غالبًا ما تتم ترجمة أسماء التطبيقات والمحتوى مثل <xliff:g>، مثل اسم منتج أو متغير. يتم تخطي السلاسل النصية translatable="false"، ويتم إخفاء عناصر <xliff:g> حتى لا يراها النموذج كنص.
قم بتشغيله
في المجلد الذي يحتوي على ملفات اللغة الخاصة بك. تحصل اللغات التي ليس لها ملف بعد على ملف. يوضح --dry-run ما سيتغير أولاً.
npx localize-dev login
# Preview, then write the missing translations
npx localize-dev translate --dry-run -l es,fr,de
npx localize-dev translate -l es,fr,deثم حافظ على اكتماله في CI. هذا لا يحتاج إلى مفتاح API ويفشل عندما تكون اللغة مفقودة الترجمات:
npx localize-dev check --only translationsمجاني لـ 1,000 سلسلة في الشهر. تُحتسب السلسلة مرة واحدة بغض النظر عن عدد اللغات التي تدخل فيها. إنشاء حساب مجاني
أدلة للتطبيقات التي تستخدم هذا التنسيق
عندما لا يزال النص مرمزًا بشكل ثابت في الكود الخاص بك، يقوم localize-dev run بنقله إلى هذا التنسيق أولاً.