شرح تغيير اللغة في Flutter باستخدام GetX، مع Translations وfallbackLocale وحفظ اختيار المستخدم والتحقق من اللغة قبل تحميل الواجهة.
الترجمة وإدارة الحالة وظيفتان مختلفتان
تغيير اللغة في Flutter باستخدام GetX يربط مفاتيح نصوص بترجمات ثم يحدد Locale الذي تعرضه الواجهة. تغيير اسم زر إلى كلمة عربية لا يترجم التطبيق كله، ولا يهيئ بيانات التواريخ والأرقام تلقائيًا لكل مكتبة. ابدأ بنصوص واضحة وثابتة المفاتيح ثم اختبر اتجاه الواجهة. لا تحتاج إلى إضافة Controller لكل نص؛ دور المتحكم هنا إدارة اختيار اللغة لا تخزين جميع عناصر الشاشة.
مفاتيح وصفية بدل الأرقام الغامضة
يمتد AppTranslations من Translations ويعيد قاموسًا للغتين ar وen. استخدام مفاتيح مثل hello وlanguage أسهل للصيانة من مفاتيح رقمية يصعب تذكر معناها. استعمل المفتاح نفسه في كل اللغات، وافصل النصوص عن منطق الواجهة. عند نقص ترجمة، راجع fallbackLocale واختبر النتيجة بدل افتراض أن المستخدم لن يصل إلى مسار يحتوي مفتاحًا غير مترجم.
تحميل التفضيل قبل تشغيل الواجهة
تقرأ loadLocale اختيار المستخدم عبر SharedPreferencesAsync ثم تمرره إلى LocalizedApp كقيمة أولية. نفذ WidgetsFlutterBinding.ensureInitialized قبل استعمال إضافات المنصة، وانتظر القراءة قبل runApp أو اعرض شاشة تحميل مقصودة. تجنب sharedPreferences! كمتغير عالمي يُقرأ قبل التهيئة، لأن غياب الاختيار ليس الخطأ نفسه الذي ينتج عن عدم جاهزية كائن التخزين.
تغيير اللغة وحفظها
يتحقق changeLanguage من أن الرمز ضمن supportedLanguages، ثم يحفظه ويحدث Locale عبر Get.updateLocale. إذا فشلت الكتابة لا يدعي المثال أن التفضيل حُفظ بنجاح. يمكنك تصميم الواجهة لتغيير اللغة فورًا ثم الإبلاغ عن فشل الحفظ، لكن يجب أن تكون هذه السياسة واضحة. لا تخلط الإجراءين بصمت بحيث يعرض التطبيق لغة ثم يعود لغيرها عند التشغيل التالي دون تفسير.
القيم غير المدعومة وحالة الجهاز
تعيد safeLanguage الإنجليزية عند غياب القيمة أو وجود رمز غير مدعوم، وهي سياسة افتراضية في المثال وليست إلزامًا لتطبيقك. يمكنك اختيار لغة الجهاز إذا كانت مدعومة أو اختيار العربية افتراضيًا. إذا دعمت لغة مع بلد مثل ar_EG، صمم المطابقة بعناية ولا تختزل جميع الحالات بحذف جزء من النص عشوائيًا. تحقق من القيمة القادمة من التخزين قبل إنشاء Locale منها.
اتجاه العربية والتخطيط
اختبر الأزرار والهوامش والأيقونات ذات الاتجاه بعد اختيار العربية، واستخدم الخصائص الاتجاهية مثل EdgeInsetsDirectional عندما يلزم. لا تقلب كل أيقونة أو صورة تلقائيًا؛ بعض الرموز لا يتغير معناها مع RTL. قد يحتاج تطبيقك إلى flutter_localizations وsupportedLocales لتوطين عناصر Material الخاصة بالإطار؛ مفاتيح GetX لا تغني عن إعداد التوطين الذي تتطلبه هذه العناصر.
أين أضع المتحكم والتخزين؟
يمكن توفير LanguageController عبر Binding أو خدمة إعدادات مشتركة بدل إنشاء نسخة في كل صفحة. يشرح GetxService تهيئة الإعدادات غير المتزامنة، بينما يوضح Bindings حدود المتحكم الخاص بمسار. احتفظ بمصدر واحد للغة المختارة حتى لا يغيّر زر في صفحة متغيرًا محليًا بينما تعتمد بقية الواجهة على متحكم مختلف.
اختبار التبديل والتنقل
اختبر فتح التطبيق دون اختيار محفوظ، ثم حفظ العربية وإعادة التشغيل، وقيمة تالفة في التخزين وفشل الكتابة. افحص النص الطويل واتجاه الصفحات بعد الرجوع إليها من التنقل باستخدام GetX. لا تخزن بيانات حساسة في SharedPreferences لمجرد أنها مناسبة لرمز اللغة؛ هذه الحزمة تفضيلات بسيطة، واحتياجات حماية الجلسة مختلفة عن تفضيل العرض.
الإعداد أو عقد التكامل المطلوب
طبّق الجزء المناسب على مشروعك بعد مراجعة إصدار الحزمة والمنصة؛ قيم الإعداد هنا توضيحية وليست مفاتيح صالحة أو خدمة خلفية منشورة.
flutter pub add get shared_preferencesالمثال التطبيقي المراجع
احفظ المثال في ملف مستقل داخل مشروع تجريبي مع الحزم المذكورة. يوضح الكود نطاق الدرس؛ أضف إعدادات مشروعك واختبر المنصة المستهدفة قبل الاعتماد عليه في تطبيق قائم.
import 'package:flutter/material.dart';
import 'package:get/get.dart';
import 'package:shared_preferences/shared_preferences.dart';
const supportedLanguages = {'ar','en'};
String safeLanguage(String? code) => supportedLanguages.contains(code) ? code! : 'en';
class AppTranslations extends Translations {
@override
Map<String,Map<String,String>> get keys => {
'ar':{'hello':'مرحبًا','language':'اللغة'},
'en':{'hello':'Hello','language':'Language'},
};
}
class LanguageController extends GetxController {
LanguageController(this.preferences);
final SharedPreferencesAsync preferences;
Future<void> changeLanguage(String code) async {
if (!supportedLanguages.contains(code)) throw ArgumentError('Unsupported language');
await preferences.setString('language',code);
await Get.updateLocale(Locale(code));
}
}
Future<Locale> loadLocale(SharedPreferencesAsync preferences) async =>
Locale(safeLanguage(await preferences.getString('language')));
class LocalizedApp extends StatelessWidget {
const LocalizedApp({super.key,required this.initialLocale});
final Locale initialLocale;
@override
Widget build(BuildContext context) => GetMaterialApp(
translations: AppTranslations(), locale: initialLocale,
fallbackLocale: const Locale('en'),
home: Scaffold(body: Center(child: Text('hello'.tr))),
);
}






