شارك المقالة
ترجمة Flutter باستخدام easy_localization وملفات JSON

ترجمة Flutter باستخدام easy_localization وملفات JSON

easy_localization في Flutter: طابق مسارات assets مع اللغات المدعومة، واستخدم مفاتيح الجمع والمعاملات.

إعداد easy_localization في Flutter بملفات JSON ومسار assets صحيح وربط locale وdelegates بالتطبيق مع fallback واختبار فشل التحميل.

التهيئة لا تغني عن ربط MaterialApp

استدع WidgetsFlutterBinding.ensureInitialized ثم EasyLocalization.ensureInitialized قبل تشغيل التطبيق. ضع الملفات في assets/translations وعرّف المسار نفسه في pubspec؛ asstes في المثال خطأ إملائي. داخل MaterialApp اربط context.localizationDelegates وcontext.supportedLocales وcontext.locale حتى يتغير تنسيق المكونات واتجاهها مع النص.

اختيار اللغة والحفظ

fallbackLocale لغة للرجوع عند الحاجة، ولا يعني startLocale مفروضًا في كل تشغيل. راجع سياسة saveLocale وقرار إتباع الجهاز أو حفظ اختيار المستخدم. استخدم tr للمفاتيح المعرفة، وعرّف أي extension قبل استعمال context.success. اختبر نقص ملف أو مفتاح، والمعاملات وصيغة الجمع والعربية، ولا تعتمد نصًا مترجمًا كمعرف سجل.

مراجعة صغيرة قبل النشر

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

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

ترجمة كامله لتطبيقك باستخدام مكتبة easy localization مع شرح الاستخدام في Flutter

مكتبة easy_localization هي مكتبة Flutter مفتوحة المصدر تسهل عملية الترجمة الدولية لتطبيقات Flutter. توفر المكتبة مجموعة من الميزات التي تجعل من السهل ترجمة تطبيقاتك إلى لغات متعددة، بما في ذلك مجموعه مميزات لها


هناك حاجة إلى لغات البرمجة Swift أو Objective-C وبيئات التطوير المتكاملة Xcode أو AppCode لإنشاء تطبيق iOS للجوال. هناك حاجة إلى لغات البرمجة مثل Kotlin أو Java ، بالإضافة إلى بيئات التطوير المتكاملة مثل Android Studio أو Eclipse ، لإنشاء تطبيق Android للجوال. بالإضافة إلى ذلك ، يمكن للمستخدمين الحصول على تطبيقات أصلية من خلال متاجر تطبيقات محددة. لمستخدمي iOS ، إنه متجر تطبيقات Apple ، ولمستخدمي Android ، إنه Google Play. من أشهر أمثلة تطبيقات الهاتف المحمول المحلية Spotify و WhatsApp و LinkedIn. نأمل أن تكون هذه القطعة قد ساعدتك في فهم أفضل تطبيق للجوّال الأصلي.

مميزات easy_localization ؟

دعم العديد من اللغات
دعم تنسيقات الملفات المتعددة للترجمة
معالجة حالات التعددية (pluralization)
دعم النص الموجه من اليمين إلى اليسار (RTL)
دعم إعادة توجيه مفاتيح اللغة البديلة

لماذا افضل easy_localization عن غيرها ؟

1 – التعرف على لغة النظام وبدء التطبيق به
2- توفير الكثير من الاكواد
3- لن تحتاج لحذف اللغه فبمجرد التغيير يتم حفظها

لاستخدام المكتبة

طريقة استخدام مكتبة easy_localization في ترجمة عناصر تطبيقك


في البداية تحتاج الى اضافة ملف assets وبداخله ملف للترجمه translations وتضع بداخله اي لغه ترغم بها فقط رمز اللغه وبنهايته json كما هو موضح وبداخل الملف تكتب ال key الخاص بكل عنصر و العباره بكل لغه

ملفا الترجمة العربية والإنجليزية داخل مجلد translations في مشروع Flutter

الان سوف تحتاج الى وضع الملف بداخل pubspec كما هو موضح ليتعرف عليها المشروع

تسجيل مجلد ملفات الترجمة ضمن assets في pubspec.yaml

الان سوف نقوم بعمل extension للنصوص لتسهل علينا عملية الترجمه بشكل اسرع بدل من كتابة كل key وبعده tr .

امتداد BuildContext لاستدعاء مفتاح success عبر easy_localization

الان وقبل ال runApp قم بتعريف المكتبة وارفاق اللغات التي تعمل عليها وايضا مسار الملف الخاص بالترجمه ولغة افتراضيه ( في كلا الحالات سوف يتعرف على لغة النظام ويفتح عليها ) . ولا تنسى ايضا تفعيل المكتبة وعمل init لها .

تهيئة EasyLocalization وتحديد اللغات ومسار ملفات الترجمة قبل تشغيل التطبيق

main.dart
الان لاستخدام النص سوف تقوم بعمل context ومن ثم المفتاح الخاص بها , ولكي تقوم بالتغيير بين اللغات استخدام setLocale .

عرض النص المترجم وأزرار تبديل اللغة في واجهة Flutter

locale.dart

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

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

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

import 'package:flutter/material.dart';
import 'package:easy_localization/easy_localization.dart';
Future<void> main() async {
 WidgetsFlutterBinding.ensureInitialized();
 await EasyLocalization.ensureInitialized();
 runApp(EasyLocalization(supportedLocales: const [Locale('en'),Locale('ar')],
  path:'assets/translations',fallbackLocale:const Locale('en'),
  child:const DemoApp()));
}
class DemoApp extends StatelessWidget {
 const DemoApp({super.key});
 @override
 Widget build(BuildContext context)=>MaterialApp(
  localizationsDelegates:context.localizationDelegates,
  supportedLocales:context.supportedLocales,locale:context.locale,
  home:Scaffold(body:Builder(builder:(context)=>Center(child:TextButton(
   onPressed:()=>context.setLocale(context.locale.languageCode=='ar'
    ?const Locale('en'):const Locale('ar')),
   child:Text('hello'.tr()),
  )))));
}
// Requires easy_localization and assets/translations/ in pubspec.yaml.
// en.json: {"hello":"Hello"}; ar.json: {"hello":"مرحبا"}

مرجع للتنفيذ

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

تطبيق easy_localization في Flutter في مشروعك

طابق مسارات assets مع اللغات المدعومة، واستخدم مفاتيح الجمع والمعاملات؛ اختبر اللغة الاحتياطية وتغيير اللغة بعد إعادة تشغيل التطبيق.

عند مراجعة صفحة easy_localization كان الإصدار المنشور 3.0.8. أرقام الإصدارات في المثال الأصلي قد تختلف؛ قارِن دليل الهجرة وإعدادات المنصة قبل التحديث، ولا ترفع قيد الاعتماد وحده مع إبقاء استدعاءات واجهة قديمة.

مراجع الموضوع: pub.dev — easy_localization

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

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