شارك المقالة
ترجمة ملفات JSON للتطبيقات دون إفساد المفاتيح

ترجمة ملفات JSON للتطبيقات دون إفساد المفاتيح

ترجمة ملفات JSON للتطبيقات تتطلب الحفاظ على المفاتيح والمتغيرات وأنواع القيم، مع مراجعة العربية والجمع واتجاه الواجهة بعد الترجمة.

ترجمة ملفات JSON للتطبيقات تتطلب الحفاظ على المفاتيح والمتغيرات وأنواع القيم، مع مراجعة العربية والجمع واتجاه الواجهة بعد الترجمة.

ترجم القيم التي يراها المستخدم

لا تترجم أسماء المفاتيح أو معرفات الصفحات أو روابط الخدمات تلقائيًا. احتفظ ببنية الكائنات والمصفوفات وأنواع القيم، وتأكد أن true وfalse والأرقام لا تتحول إلى نصوص. قد يستخدم مشروع Flutter ملفات ARB ببيانات وصفية بدل JSON عادي؛ اتبع صيغة إطار الترجمة المستخدم.

المتغيرات والجمع

إذا احتوى النص {userName} أو %s أو صيغة ICU للجمع، فلا تغيّر اسم المتغير أو تحذفه. العربية تحتاج صيغ جمع وسياقًا لغويًا، وليس استبدال كل كلمة بمعزل عن الجملة. وثّق معنى الرسائل القصيرة للمترجم، وراجع أخطاء الهروب مثل علامات الاقتباس والأسطر الجديدة.

اختبر الملف والواجهة

ابدأ بفحص JSON parser ثم قارن مجموعة المفاتيح بالملف الأصلي. اختبر القيم الفارغة والمفاتيح الناقصة وعرض الأرقام والنص المختلط في RTL. افتح الشاشات على هاتف ضيق لرصد تمدد النص وتراكب الأزرار. لا تعالج الخطأ بقص كل النصوص أو تغيير مفاتيح الكود.

خصوصية خدمة الترجمة

لا ترفع ملفات تحوي أسرارًا أو بيانات مستخدمين إلى خدمة غير معتمدة. استبعد الحقول التقنية وراجع شروط مشاركة البيانات والتكلفة قبل استعمال API. الترجمة الآلية مسودة تحتاج مراجعة بشرية في سياق الشاشة، خصوصًا الرسائل المالية والأخطاء. مثال Python التالي يفحص صيغة ملف محلي فقط؛ لا يرسل أي بيانات لخارج جهازك.

مثال للتطبيق

import json
from pathlib import Path
source = json.loads(Path('en.json').read_text(encoding='utf-8'))
target = json.loads(Path('ar.json').read_text(encoding='utf-8'))
if not isinstance(source, dict) or not isinstance(target, dict):
    raise ValueError('Expected top-level objects')
print('Missing keys:', sorted(source.keys() - target.keys()))
print('Extra keys:', sorted(target.keys() - source.keys()))
# للفحص المتداخل والمتغيرات استخدم اختبارات توافق إطار الترجمة أيضًا.

المرجع الرسمي

للتفاصيل الخاصة بإصدار الأداة وبيئة التشغيل، راجع توثيق ترجمة ملفات JSON. قد تختلف أسماء القوائم بين الإصدارات؛ طابق الإعداد مع مشروعك قبل تطبيقه.

شاهد أيضًا
مقالات ذات صلة
🚫 مانع الإعلانات مفعل

يجب إيقاف مانع الإعلانات لاستكمال تصفح الموقع