شارك المقالة
ترجمة Flutter دون حزمة خارجية: قاموس رسائل وLocale

ترجمة Flutter دون حزمة خارجية: قاموس رسائل وLocale

تصميم ترجمة Flutter دون حزمة خارجية باستخدام Locale ومفوضي SDK، وفصل القاموس واتجاه النص عن متغير global وقراءة dart:io.

تصميم ترجمة Flutter دون حزمة خارجية باستخدام Locale ومفوضي SDK، وفصل القاموس واتجاه النص عن متغير global وقراءة dart:io.

دون حزمة خارجية لا يعني دون دعم الترجمة

flutter_localizations جزء من SDK ويمكن دمجه مع قاموس بسيط أو gen-l10n. مجرد bool باسم isRtl لا يمثل لغة كاملة؛ قد توجد لغات متعددة باتجاه واحد وتنسيقات أرقام وتواريخ مختلفة. استخدم Locale ومفوضي widgets للنظام، ولا تقرأ Platform.localeName من dart:io في كود يستهدف الويب.

تحميل اللغة عملية لها عمر

إذا حمّلت JSON فافحص نوع الجذر والحقول وأعد fallback واضحًا، وخزن العملية خارج build. قد تصل ترجمة اختيار سابق بعد اختيار أحدث، فاعتمد معرف طلب أو تجاهل النتيجة المتأخرة. استعمل نموذجًا immutable بدل late حقول غير مهيأة، وأبقِ اتجاه الواجهة تابعًا للـLocale المعتمدة بدل global يتغير بلا إشعار للشجرة.

متى يكبر القاموس؟

العينة تستخدم قاموسًا داخل الذاكرة لرسالتين ولا تحتاج ملفات assets، لذلك يمكن فهم تبديل Locale دون انتظار قراءة ملف. عندما تتوسع الرسائل ويحتاج المترجمون أو placeholders أو plural فانتقل إلى gen-l10n بدل كتابة سلاسل شروط متفرقة في كل Widget. لا تُكرر قرار لغة عربية أم إنجليزية في عشرات الصفوف؛ اجعل اختيار الرسالة في طبقة واحدة يمكن اختبارها. اختبر fallback للمفتاح أو اللغة الغائبة، ولا تخفِ النقص دائمًا بإرجاع key نفسه للمستخدم في شاشة إنتاجية لأن ذلك قد يبدو نصًا صالحًا في اختبار غير دقيق.

مراجعة أخيرة للتطبيق

تحقق أن النصوص والأزرار تبقى قابلة للقراءة بعد التبديل، وأن المسودة التي كتبها المستخدم لا تختفي بسبب تغيير Key غير ضروري.

خطوات التطبيق والشرح

ترجمة التطبيق الخاص بك في flutter بدون اي مكتبات

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


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

الخطوه الاولى : انشاء ملف يحتوي على اللغات التي ترغب باضافتها

تنظيم ملفات JSON للترجمة العربية والإنجليزية داخل assets

الخطوة الثانيه : اضافة الملفات داخل ملف pubspec.yaml

تعريف مجلد assets/translations في ملف pubspec.yaml

الخطوة الثالثه : انشاء ملف model لقراءة ملفات json  وكل عباره يتم اضافتها في اللغات يتم اضافتها هنا ايضا .

TranslationModel.dart

الخطوة الرابعه : التاكد من لغة الجهاز للمستخدم ومعرفة اللغه التي يستعملها


الخطوة الخامسه : ترجمه التطبيق عند بدء العمل وذلك يكون عن طريق cubit او اي statemanagement اخرى وذلك يكون عن طريقة كود يتم اضافته في الكيوبت واخر في BlocProvider عند بدء العمل
الخطوه السادسه انشاء متغير في constant لاتجاه التطبيق وايضا لتسهيل عملية التعريف للغه .

الخطوة السابعه : استخدام اللغه لتطبيقك سوف تقوم بكتابة appTranslation وبعدها اسم الkey

android sdk manager تحميل flutter developers applications create app android android studio mac

مثال الشفرة بعد المراجعة

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

import 'package:flutter/material.dart';
import 'package:flutter_localizations/flutter_localizations.dart';
void main()=>runApp(const DemoApp());
class DemoApp extends StatefulWidget {
 const DemoApp({super.key});
 @override State<DemoApp> createState()=>_DemoAppState();
}
class _DemoAppState extends State<DemoApp> {
 Locale _locale=const Locale('en');
 static const messages={'en':{'hello':'Hello'},'ar':{'hello':'مرحبا'}};
 @override Widget build(BuildContext context)=>MaterialApp(locale:_locale,
 supportedLocales:const [Locale('en'),Locale('ar')],
 localizationsDelegates:GlobalMaterialLocalizations.delegates,
 home:Scaffold(body:Center(child:TextButton(
 onPressed:()=>setState(()=>_locale=Locale(_locale.languageCode=='ar'?'en':'ar')),
 child:Text(messages[_locale.languageCode]?['hello']??messages['en']!['hello']!),
 ))));
}
// SDK-only two-message demo; use gen-l10n for placeholders/plurals at scale.

مرجع للتنفيذ

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

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

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