واجهة برمجة تطبيقات الترجمة في فلاتر (ARB)

تدعم Localization.One تنسيق ARB الأصلي لفلاتر بالكامل. بدلاً من تعديل هياكل JSON المعقدة يدويًا مع البيانات الوصفية، يمكنك إدارة ترجمات تطبيق الهاتف المحمول الخاص بك في واجهة سهلة الاستخدام وتصديرها مباشرة إلى مشروع فلاتر الخاص بك.

لماذا يختار المطورون واجهة برمجة التطبيقات لفلاتر لدينا؟

  • تنسيق ARB الأصلي: نقوم بإنشاء ملفات .arb صالحة متوافقة مع حزمة flutter_localizations الرسمية و intl.
  • البيانات الوصفية المؤتمتة: نقوم تلقائيًا بحقن مفتاح @@locale، مما يضمن أن ملفات ARB الخاصة بك صالحة ومعترف بها دائمًا من قبل مترجم فلاتر.
  • جاهز للهاتف المحمول: مثالي لإدارة المحتوى الديناميكي في إصدارات Android و iOS الخاصة بك من مصدر واحد.

إدارة مشاريع متقدمة

قم بتوسيع ترجمة تطبيق الهاتف المحمول الخاص بك دون صداع.

سير عمل موحد: إدارة ترجمات iOS و Android في مكان واحد. تصدير كـ ARB لفلاتر، أو XML/Strings منفصلة إذا لزم الأمر.

تسميات وعلامات: قم بتمييز السلاسل بتسميات مخصصة مثل "التوجيه" أو "الإعدادات" لتصفية التصديرات عبر واجهة برمجة التطبيقات.

تعاون الفريق: دعوة المترجمين وكُتّاب النصوص. تعيين أدوار دقيقة (مالك، مسؤول، مدير، مترجم).

Webhooks: قم بتفعيل Codemagic أو GitHub Actions تلقائيًا عند تحديث الترجمات.

كيفية التكامل

الخيار 1: تصدير يدوي (واجهة المستخدم)

مثالي للتطوير المحلي.

  1. اذهب إلى لوحة التحكم في المشروع.
  2. انقر على زر تنزيل .
  3. اختر فلاتر ARB من قائمة التنسيق المنسدلة.
  4. اختر اللغة وقم بتنزيل ملف .arb.

الخيار 2: الأتمتة باستخدام واجهة برمجة التطبيقات (CI/CD)

احصل على أحدث الترجمات مباشرة في خط أنابيب البناء الخاص بك. مرر المعامل format=arb.

bash
# تنزيل الترجمات الإنجليزية
curl "https://api.localization.one/{YOUR_API_KEY}/getTranslations?translation_language=1&format=arb" > lib/l10n/app_en.arb

# تنزيل الترجمات الإسبانية
curl "https://api.localization.one/{YOUR_API_KEY}/getTranslations?translation_language=2&format=arb" > lib/l10n/app_es.arb

الخيار 3: الدفع عبر Webhooks

قم بتكوين عنوان URL لـ Webhook في إعدادات مشروعك لأتمتة العملية بالكامل.

  • تحديثات سريعة: يتلقى خادمك طلب POST بعد فترة وجيزة من التغييرات (عادةً خلال 5 دقائق).
  • تفعيل البناء: قم بتوصيل webhooks بمزود CI/CD الخاص بك لإعادة بناء تطبيقك تلقائيًا عند تغيير المحتوى.

أسئلة متكررة

هل أحتاج إلى إضافة @@locale يدويًا؟

لا. تقوم واجهة برمجة التطبيقات الخاصة بنا تلقائيًا بحقن مفتاح @@locale في أعلى ملف ARB بناءً على رمز اللغة الذي تطلبه (على سبيل المثال، "@@locale": "en")، لذا فإن الملف جاهز للاستخدام على الفور.

هل يمكنني استخدام عناصر النائب مثل {name}؟

نعم. يدعم ARB في فلاتر بناء جملة ICU. يمكنك كتابة {name} أو {count, plural, ...} في ترجماتك، وسيتم تصديرها بشكل صحيح.

تنسيقات الهاتف المحمول الأخرى:

هل أنت مستعد لأتمتة ترجمة فلاتر الخاصة بك؟ أنشئ حسابك المجاني اليوم.