Lorixen.
AR

تطبيق Flutter يظهر من اليسار لليمين بالعربي: ضبط اللغة والاتجاه

باختصار: إذا كان تطبيق Flutter الخاص بمتجرك أو مدرستك يعرض النصوص العربية لكن الواجهة ما زالت من اليسار لليمين، وأزرار التقويم والنسخ واللصق تظهر بالإنجليزية، فالمشكلة غالباً أن التطبيق لم يُعدّ لدعم اللغة العربية رسمياً. توثيق Flutter يوضح أن الترجمات الجاهزة لمكتبات الواجهة متاحة بالإنجليزية فقط افتراضياً، وأن عليك إضافة حزمة flutter_localizations وتحديد العربية ضمن اللغات المدعومة. بعدها يقلب Flutter اتجاه الواجهة تلقائياً، ويبقى عليك استخدام المسافات والمحاذاة «الاتجاهية» بدل اليمين واليسار الثابتين.

الأعراض التي يلاحظها صاحب العمل

صاحب متجر ملابس في إربد طلب تطبيقاً بسيطاً بالعربية. المبرمج كتب كل النصوص بالعربي، وعند التسليم ظهرت مشاكل صغيرة لكنها مزعجة:

  • القائمة الجانبية تنفتح من اليسار، وسهم الرجوع في الأعلى يشير إلى الاتجاه الخطأ بالنسبة للقارئ العربي.
  • نافذة اختيار تاريخ التوصيل تعرض أسماء الأشهر وكلمتي «Cancel» و«OK» بالإنجليزية.
  • عند الضغط المطول على حقل النص تظهر خيارات «Copy» و«Paste» بالإنجليزية.
  • بعض البطاقات فيها مسافة كبيرة على الجهة الخطأ، فيبدو التصميم مقلوباً.

هذا مثال توضيحي يجمع أعراضاً شائعة، وليس وصفاً لمشروع محدد.

السبب: Flutter لا يعرف أن تطبيقك عربي

عندما تكتب نصاً عربياً داخل التطبيق، فهذا لا يعني أن التطبيق «يعرف» أنه يعمل بالعربية. Flutter يعتمد على إعدادات اللغة (Locale) لتحديد اتجاه الواجهة والنصوص الجاهزة في مكوناته. توثيق Flutter الرسمي يذكر بوضوح أن مكتبة flutter_localizations تدعم لغات كثيرة، لكن الترجمات المتاحة افتراضياً هي الإنجليزية فقط، والمطور هو من يقرر أي لغات يدعمها.

ويشرح التوثيق أن معامل supportedLocales في MaterialApp يحدّ من تغييرات اللغة: عندما يغير المستخدم لغة جهازه، لا يتبعه التطبيق إلا إذا كانت اللغة الجديدة ضمن هذه القائمة. فإذا لم تكن العربية في القائمة، يبقى التطبيق على الإنجليزية واتجاهها، حتى لو كان هاتف الزبون بالعربي.

الإصلاح الأساسي خطوة بخطوة

اطلب من المطور مراجعة هذه النقاط:

  1. إضافة الحزمة: إضافة flutter_localizations إلى ملف pubspec.yaml كما يشرح التوثيق.
  2. تحديد مفوضي الترجمة: إضافة localizationsDelegates إلى MaterialApp، ومنها GlobalMaterialLocalizations.delegate الذي يوفر النصوص المترجمة لمكونات Material، ومفوض الواجهات العام ومفوض مكونات Cupertino إذا كان التطبيق يستخدمها.
  3. إضافة العربية إلى supportedLocales: مثلاً Locale('ar') إلى جانب الإنجليزية إذا كان التطبيق ثنائي اللغة.
  4. ترتيب القائمة بعناية: التوثيق يوضح أنه إذا لم يوجد تطابق تام مع لغة الجهاز، تُستخدم أول لغة مدعومة لها نفس رمز اللغة، وإذا فشل ذلك تُستخدم أول لغة في القائمة. لذلك إذا كان أغلب زبائنك يستخدمون العربية، فكّر في وضع العربية أولاً كي تكون هي الافتراضية عند عدم التطابق.

بعد هذه الخطوات، يذكر التوثيق أن Flutter يترجم مكتبات Material وCupertino إلى اللغة المختارة، وأن الواجهات يجب أن تتكيف وتستخدم الاتجاه المناسب، من اليسار لليمين أو من اليمين لليسار.

«ar» أم «ar-JO»؟

قد يسأل المطور: هل أضع العربية العامة أم العربية الأردنية؟ قاعدة المطابقة التي يشرحها التوثيق تساعد هنا: إذا كان هاتف الزبون مضبوطاً على عربية بلد معين ولم تجد Flutter تطابقاً تاماً، فستستخدم أول لغة مدعومة تبدأ بنفس رمز اللغة «ar». لذلك يكفي في أغلب التطبيقات المحلية إضافة العربية العامة، إلا إذا كان لديك نصوص تختلف فعلاً بين بلد وآخر.

المسافات والمحاذاة: لا تكتب «يسار» و«يمين»

حتى بعد ضبط اللغة، قد تبقى بعض الشاشات مقلوبة. السبب أن المطور استخدم مسافات ثابتة مثل «مسافة من اليسار 16». هذه لا تنقلب مع اتجاه اللغة.

توثيق واجهة Directionality في Flutter يشرح أن عناصر مثل Padding تعتمد على الاتجاه الحالي لتحويل EdgeInsetsDirectional إلى مسافات فعلية. أي أن «start» تعني اليسار في الإنجليزية واليمين في العربية تلقائياً. المثال في التوثيق نفسه يستخدم اتجاهاً من اليمين لليسار ومسافة من جهة «البداية»، فتظهر المسافة على اليمين.

القاعدة العملية: اطلب من المطور البحث في الكود عن المسافات والمحاذاة الثابتة لليمين أو اليسار، واستبدالها بالبدائل الاتجاهية حيث يكون المقصود «بداية السطر» أو «نهايته». واترك الثابت فقط لما يجب ألا ينقلب، مثل مشغل فيديو أو رسم بياني زمني.

الأيقونات والأرقام

ليست كل أيقونة يجب أن تنقلب. سهم الرجوع ومؤشرات «التالي» يجب أن تتبع الاتجاه، أما أيقونة البحث أو علامة الصح فلا معنى لقلبها. راجع الشاشات الرئيسية بالعربية مع المطور، وحدد ما يبدو غريباً لقارئ عربي.

أما الأرقام والتواريخ داخل نصوصك الخاصة، فهي لا تُترجم وحدها. التوثيق يشرح طريقة كتابة رسائل مترجمة بملفات ARB وملف l10n.yaml، ويخصص أقساماً للرسائل التي تحتوي أرقاماً وتواريخ. قرر مع فريقك شكل الأرقام الذي تريده في التطبيق، والتزم به في كل الشاشات.

زر تغيير اللغة داخل التطبيق

بعض أصحاب الأعمال يريدون زراً داخل التطبيق يسمح للزبون باختيار العربية أو الإنجليزية بغض النظر عن لغة هاتفه. هنا يجب أن يفهم المطور أن اختيار اللغة لم يعد يعتمد على الجهاز فقط. التوثيق يذكر أن التطبيق الذي يريد طريقة مختلفة لاختيار اللغة يمكنه توفير localeResolutionCallback، ويعرض مثالاً لقبول أي لغة يختارها المستخدم. أما زر التبديل نفسه فيحتاج أن يحفظ اختيار الزبون ويعيد بناء التطبيق باللغة الجديدة، فيتغير الاتجاه معها.

اتفق مع المطور مسبقاً على سلوك واضح: ماذا يرى الزبون عند أول فتح؟ لغة الهاتف أم العربية دائماً؟ وهل يتذكر التطبيق اختياره بعد إغلاقه؟ هذه قرارات صغيرة، لكنها تمنع شكاوى مثل «التطبيق رجع إنجليزي لحاله».

لغة مختلفة لجزء من التطبيق

أحياناً تحتاج شاشة واحدة بلغة مختلفة عن بقية التطبيق، مثل نموذج فاتورة بالإنجليزية داخل تطبيق عربي. التوثيق يذكر أن Localizations.override يسمح بتعريب جزء من التطبيق بلغة مختلفة عن لغة الجهاز، ويصف هذه الحالة بأنها نادرة عادة. استخدمه بحذر، ولا تجعله بديلاً عن إعداد اللغة الصحيح للتطبيق كله.

اختبار قبل الإطلاق

قبل رفع التحديث، اطلب تجربة هذه الحالات على هاتف حقيقي:

  • هاتف لغته العربية: هل تنفتح القائمة من اليمين؟ هل سهم الرجوع صحيح؟
  • هاتف لغته الإنجليزية: هل يعمل التطبيق كما تريد، بالعربية أم بالإنجليزية؟
  • نافذة اختيار التاريخ والوقت: هل الأزرار والأشهر بالعربية؟
  • الضغط المطول على حقل نص: هل الخيارات بالعربية؟
  • الشاشات المزدحمة: هل المسافات على الجهة الصحيحة؟

أسئلة شائعة

ليش تطبيق Flutter عندي من اليسار لليمين مع إنه النصوص عربي؟

لأن العربية غير مضافة إلى اللغات المدعومة أو لم تُضف حزمة الترجمة، فيبقى التطبيق على الإنجليزية واتجاهها.

ليش نافذة التاريخ بالإنجليزي؟

لأن نصوص مكونات Material الجاهزة متاحة بالإنجليزية فقط افتراضياً، وتحتاج مفوض الترجمة واللغة العربية في القائمة.

هل لازم أضيف ar-JO؟

غالباً لا. إذا لم يوجد تطابق تام، يستخدم Flutter أول لغة مدعومة بنفس رمز اللغة.

بعض الشاشات ما زالت مقلوبة بعد الإصلاح، ليش؟

لأن المسافات أو المحاذاة مكتوبة يميناً ويساراً بشكل ثابت. استبدلها بالبدائل الاتجاهية.

إذا كان تطبيقك العربي يبدو مقلوباً أو نصفه بالإنجليزية، تواصل معنا لنراجع إعداداته قبل الإطلاق.

المصادر

WhatsAppاحجز مكالمة