localize.dev

الوثائق / الوكلاء / Gemini CLI

توطين تطبيق باستخدام Gemini CLI

أضف localize.dev إلى settings.json الخاص بـ Gemini CLI حتى يتمكن وكيل Google الطرفي من التحقق من نص واجهة المستخدم الخاص بتطبيقك وتوطينه وترجمته.

كيف يعمل

يقرأ Gemini CLI خوادم MCP من mcpServers في ~/.gemini/settings.json، أو في .gemini/settings.json في المشروع لمشاركتها مع الفريق.

ابدأ بـ config. يخبر الوكيل باللغات التي يشحنها التطبيق، وأين توجد ملفات اللغة، وما هو موجود في المسرد، بحيث يستخدم الكود الذي يكتبه مكتبة i18n الخاصة بك ومصطلحاتك.

إعدادها

قم بتشغيل npx localize-dev login أولاً في الطرفية الخاصة بك. يقوم بتسجيل دخولك عبر المتصفح ويحفظ مفتاحًا، والذي يقرأه الخادم، لذلك لا يحمل الإعداد أدناه أي شيء.

  1. أضف localize إلى mcpServers في settings.json.
  2. أعد تشغيل الوكيل، أو أعد تحميل خوادم MCP الخاصة به، ليبدأ الترجمة.
  3. افتح مستودعك واطلب منه شيئًا مثل الموجه أدناه.
~/.gemini/settings.json
{
  "mcpServers": {
    "localize": {
      "command": "npx",
      "args": ["-y", "localize-dev", "mcp"]
    }
  }
}

ما تحصل عليه

أين يذهب الخادم
~/.gemini/settings.json
خادم
localize-dev mcp، تم تشغيله باستخدام npx على جهازك
مفتاح
الذي حفظه npx localize-dev login
ما يضيفه init --agent
قسم AGENTS.md مع التعليمات. أضف الخادم يدويًا، كما هو موضح أعلاه.

من الجيد معرفته

  • يقرأ Gemini CLI GEMINI.md لتعليمات المشروع. لاستخدام القسم الذي يكتبه init --agent، وجّه إعداد ملف سياق Gemini CLI إلى AGENTS.md أو انسخ القسم إلى GEMINI.md.
  • يسرد /mcp في Gemini CLI الخوادم المتصلة وأدواتها، وهي أسرع طريقة لرؤية أن localize قد بدأ.

جربه

اسأل شيئًا كهذا. يجب على الوكيل استدعاء أداة config.

“ما اللغات التي يتوفر بها هذا التطبيق، وماذا يوجد في مسرده؟”

احتفظ بها مترجمة

لا يزال النص الذي يتركه الوكيل ثابتًا يتم اكتشافه: يفشل npx localize-dev check في CI في طلب سحب يضيف نسخة غير مترجمة، ولا يحتاج إلى مفتاح.

npx localize-dev check

جميع الوكلاء ومرجع الأداة موجودون في صفحة خادم MCP.