الوثائق / الوكلاء / 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 أولاً في الطرفية الخاصة بك. يقوم بتسجيل دخولك عبر المتصفح ويحفظ مفتاحًا، والذي يقرأه الخادم، لذلك لا يحمل الإعداد أدناه أي شيء.
- أضف localize إلى mcpServers في settings.json.
- أعد تشغيل الوكيل، أو أعد تحميل خوادم MCP الخاصة به، ليبدأ الترجمة.
- افتح مستودعك واطلب منه شيئًا مثل الموجه أدناه.
{
"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