localize.dev

الوثائق / ترجم / Flutter ARB

ترجمة ملفات Flutter ARB

ترجمة lib/l10n/app_en.arb إلى app_<lang>.arb لـ Flutter’s gen-l10n، مع {placeholders} ورسائل ICU plural و select، وأوصاف @key المستخدمة كسياق.

كيف يعمل

يقرأ localize-dev translate ملف ARB للقالب الخاص بك، ويرسل وصف @key لكل رسالة معه كسياق، ويكتب app_ar.arb و app_pt_BR.arb والباقي مع تعيين @@locale. يلتقط gen-l10n الملفات الجديدة ويضيف اللغات إلى supportedLocales في البناء التالي.

يتم تقسيم رسائل ICU plural و select إلى فروعها، وترجمتها، وإعادة تجميعها بالأشكال التي تحتاجها اللغة. تظل التطابقات الدقيقة مثل =0، ويتم تحليل الرسالة قبل كتابتها.

قبل وبعد

الناتج الفعلي لـ localize-dev translate --locales ar على الملف الأول. تستخدم اللغة العربية ستة أشكال للجمع، لذا يحصل صيغة الجمع itemCount على صفر وواحد واثنان وقليل وكثير وأشكال أخرى بجانب فرع =0 الخاص بها.

lib/l10n/app_en.arb
{
  "@@locale": "en",
  "cartTitle": "Your cart",
  "@cartTitle": { "description": "Title of the shopping cart screen" },
  "greeting": "Hi {name}, ready to check out?",
  "@greeting": { "placeholders": { "name": { "type": "String" } } },
  "itemCount": "{count, plural, =0{Your cart is empty} =1{1 item} other{{count} items}}",
  "@itemCount": { "placeholders": { "count": { "type": "int" } } }
}
lib/l10n/app_ar.arb · العربية
{
  "@@locale": "ar",
  "cartTitle": "عربتك",
  "greeting": "مرحباً {name}، هل أنت مستعد للدفع؟",
  "itemCount": "{count, plural, =0 {عربتك فارغة} zero {0 عناصر} one {عنصر واحد} two {عنصران} few {{count} عناصر} many {{count} عناصر} other {{count} عناصر}}"
}

ما يبقى سليماً

  • عناصر نائبة {name}، تم التحقق منها
  • صيغ ICU الجمع مع كل شكل CLDR تستخدمه اللغة
  • فروع =0 و =1 الدقيقة وفروع select
  • أسماء ملفات الشرطة السفلية التي يتوقعها gen-l10n (app_pt_BR.arb)

الأخطاء الشائعة، وكيفية تجنبها

فقط one و other في كل لغة

اللغة العربية لديها ستة أشكال جمع واللغة البولندية أربعة. ترجمة other وحدها تجعل الأعداد مثل 2 أو 5 تُقرأ بشكل خاطئ. الأشكال التي تستخدمها كل لغة مكتوبة لكل صيغة جمع.

قوس مفقود

يؤدي عدم تطابق } واحد في رسالة ICU إلى إيقاف flutter gen-l10n. يتم تحليل كل رسالة مترجمة قبل كتابتها؛ تتم إعادة محاولة الرسالة التي لا يتم تحليلها، ثم يتم تركها والإبلاغ عنها.

لا يوجد سياق للسلاسل النصية القصيرة

يمكن أن تكون كلمة "Book" اسمًا أو فعلًا. أضف وصفًا تحت @book في القالب وسيتم إرساله مع الرسالة، بحيث تتناسب الترجمة مع الشاشة التي تظهر عليها.

قم بتشغيله

في المجلد الذي يحتوي على ملفات اللغة الخاصة بك. تحصل اللغات التي ليس لها ملف بعد على ملف. يوضح --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 بنقله إلى هذا التنسيق أولاً.