Lorixen.
AR

زر اللغة العربية في تطبيقك لا يعمل عند بعض الزبائن: تقسيم اللغات

باختصار: إذا كان تطبيقك على Google Play يحتوي زراً داخلياً لتغيير اللغة، والزبون الذي هاتفه بالإنجليزية يختار العربية فيبقى التطبيق بالإنجليزية أو تظهر بعض النصوص فقط مترجمة، أو إذا نسخ موظف ملف التطبيق من هاتفه إلى هاتف زميله فظهر بلغة واحدة فقط، فالسبب غالباً في طريقة توزيع حزم التطبيقات. توثيق أندرويد يشرح أن حزمة التطبيق تولّد افتراضياً ملفات إعداد منفصلة لكل لغة، وأن الجهاز ينزّل فقط موارد اللغات المختارة في إعداداته. الحل إما تنزيل اللغة الإضافية عند الطلب بمكتبة Play Feature Delivery، أو إيقاف تقسيم اللغات حتى تأتي كل اللغات مع التطبيق.

الشكوى كما تصل إليك

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

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

كيف توزع Google Play التطبيق؟

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

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

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

لماذا لا يحدث هذا على هاتف المطور؟

لأن المطور غالباً يثبّت التطبيق مباشرة من Android Studio، بملف يحتوي كل اللغات، لا من Google Play. لذلك لا يرى المشكلة. وهذا سبب إضافي لاختبار التطبيق دائماً من مسار التوزيع الحقيقي، مثل مسار الاختبار الداخلي في Play Console، على هاتف بلغة مختلفة.

ولماذا تفشل نسخة الملف المنسوخ؟

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

الحل هنا إداري قبل أن يكون تقنياً: الموظفون يثبتون التطبيق من المتجر، أو من مسار اختبار داخلي يُدعون إليه، لا من ملفات منسوخة.

الحل الأول: تنزيل اللغة الإضافية عند الطلب

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

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

هذا الحل يحافظ على صغر حجم التنزيل للجميع، لكنه يضيف عملاً برمجياً واختباراً.

الحل الثاني: إيقاف تقسيم اللغات

التوثيق يعرض طريقة لتعطيل نوع أو أكثر من ملفات الإعداد باستخدام قسم bundle في ملف البناء للوحدة الأساسية، ومنها خيار اللغة. عند ضبط خيار enableSplit للغة على false، لا تُولّد ملفات إعداد منفصلة للغات، وتُضمّن موارد اللغة بدلاً من ذلك مع الملف الأساسي.

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

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

خطأ شائع في ملف البناء

بعض المشاريع القديمة تحتوي في ملف البناء قسماً اسمه splits، كان يُستخدم سابقاً لإنتاج عدة ملفات APK منفصلة. قد يظن المطور أن ضبط اللغات في هذا القسم يكفي. لكن توثيق أندرويد واضح: عند بناء حزمة تطبيق، يتجاهل Gradle الخصائص الموجودة في قسم splits، وإذا أردت التحكم في أنواع ملفات الإعداد التي تدعمها الحزمة، فاستخدم قسم bundle بدلاً منه.

ويذكر التوثيق أيضاً أن هذه الإعدادات تُضبط في ملف البناء الخاص بالوحدة الأساسية للتطبيق. فإذا كان التطبيق مقسماً إلى وحدات، فالتعديل في وحدة فرعية لن يؤثر. اطلب من المطور أن يريك أين وُضع الإعداد، ثم اختبر من Play لا من الحاسوب.

أيهما تختار؟

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

قائمة اختبار

  1. اضبط هاتف اختبار على الإنجليزية فقط، دون العربية في قائمة اللغات.
  2. ثبّت التطبيق من مسار الاختبار الداخلي في Play، لا من حاسوب المطور.
  3. غيّر اللغة إلى العربية من داخل التطبيق، وتأكد أن كل الشاشات تُرجمت، لا الرئيسية فقط.
  4. كرر والإنترنت ضعيف أو مقطوع، إذا اخترت التنزيل عند الطلب.
  5. أعد تشغيل التطبيق وتأكد أن اللغة المختارة بقيت.

أسئلة شائعة

ليش التطبيق ما بيتحول للعربي لما أختاره من الإعدادات؟

غالباً لأن Google Play نزّل على الهاتف موارد لغة الجهاز فقط، فالنصوص العربية غير موجودة عليه.

ليش على موبايل المطور شغال تمام؟

لأنه يثبّت التطبيق مباشرة من بيئة التطوير بملف يحتوي كل اللغات، لا من Google Play.

الموظف نسخ التطبيق من زميله وطلع إنجليزي بس، ليش؟

لأن النسخة المنقولة قد تكون الملف الأساسي فقط دون ملفات اللغة. ثبّتوا التطبيق من المتجر أو مسار الاختبار.

شو الحل الأسهل لتطبيق بلغتين؟

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

إذا كان زر اللغة في تطبيقك لا يعمل عند بعض الزبائن، تواصل معنا ونفحص طريقة التوزيع معك.

المصادر

WhatsAppاحجز مكالمة