كتابة الرموز البرمجية باستخدام ميزة Gemini Code Assist للأفراد

ملاحظة: إذا كنت تعمل في نشاط تجاري أو أردت الحصول على المزيد من المزايا على مستوى الفريق، ننصحك باستخدام Gemini Code Assist Standard أو Enterprise.

يوضّح هذا المستند كيفية استخدام Gemini Code Assist، وهو أداة تعاون مستندة إلى الذكاء الاصطناعي في بيئة تطوير البرامج (IDE)، لمساعدتك في تنفيذ ما يلي في VS Code أو IDE IntelliJ وغيرها من IDE المتوافقة مع JetBrains:

• إنشاء رمز لمشروعك باستخدام ميزة تحويل الرموز
• تلقّي إشعارات بإكمال الرموز البرمجية أثناء كتابة الرموز
• استخدِم الإجراءات الذكية.

إذا كنت تستخدم Gemini Code Assist Enterprise، يمكنك استخدام ميزة تخصيص الرموز البرمجية، التي تتيح لك الحصول على اقتراحات للرموز البرمجية استنادًا إلى قاعدة بيانات رموبك البرمجية الخاصة في مؤسستك مباشرةً من Gemini Code Assist Enterprise. تعرَّف على كيفية ضبط تخصيص الرموز البرمجية.

هذا المستند مخصّص للمطوّرين من جميع مستويات المهارات. يفترض هذا الدليل أنّك لديك معرفة عملية باستخدام VS Code أو IntelliJ وأدوات IDE الأخرى المتوافقة من JetBrains. يمكنك أيضًا استخدام Gemini في "استوديو Android".

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

قبل البدء

VS Code

1. إعداد Gemini Code Assist للأفراد أو Gemini Code Assist Standard أو Gemini Code Assist Enterprise إذا لم يسبق لك إجراء ذلك

2. قبل اختبار إمكانات ميزة "مساعدة ترميز Gemini" فيملف الترميز، تأكَّد من توفّر لغة الترميز في ملفك. لمزيد من المعلومات حول لغات الترميز المتوافقة، يُرجى الاطّلاع على لغات الترميز المتوافقة.

3. إذا كنت تفضّل استخدام حزمة تطوير البرامج المتكاملة (IDE) من خلال خادم وكيل، اطّلِع على مقالة عمليات الاتصال بالشبكة في Visual Studio Code.

IntelliJ

1. إعداد Gemini Code Assist للأفراد أو Gemini Code Assist Standard أو Gemini Code Assist Enterprise إذا لم يسبق لك إجراء ذلك

2. قبل اختبار إمكانات ميزة "مساعدة ترميز Gemini" فيملف الترميز، تأكَّد من توفّر لغة الترميز في ملفك. لمزيد من المعلومات حول لغات الترميز المتوافقة، يُرجى الاطّلاع على لغات الترميز المتوافقة.

3. إذا كنت تفضّل استخدام IDE من خلال خادم وكيل، اطّلِع على الخادم الوكيل HTTP.

إنشاء رمز باستخدام طلبات

توضّح لك الأقسام التالية كيفية استخدام ميزة "مساعدة الرموز البرمجية" في Gemini ل إنشاء رمز باستخدام مثال الطلب Function to create a Cloud Storage bucket داخل ملف الرمز البرمجي. يمكنك أيضًا اختيار جزء من الرمز البرمجي ثم طلب المساعدة من Gemini Code Assist من خلال ميزة الدردشة، وتلقّي اقتراحات الرموز البرمجية وقبولها أو رفضها أثناء كتابة الرموز البرمجية.

طلب مساعدة من Gemini Code Assist في تحويل الرمز البرمجي

يتيح لك تحويل الرموز استخدام الأوامر أو طلبات اللغة الطبيعية في قائمة "الاختيار السريع" لطلب إجراء تعديلات على الرمز، كما يوفّر لك عرضًا للاختلافات لعرض التغييرات التي لم تكتمل بعد على الرمز. لطلب مساعدة Gemini Code Assist في تحويل الرمز البرمجي، اتّبِع الخطوات التالية:

VS Code

1. في ملف الرموز البرمجية، على سطر جديد، اضغط على Control+I (لنظام التشغيل Windows وLinux) أو Command+I (لنظام التشغيل macOS) لفتح قائمة خيار سريع لمساعدة Gemini Code.

2. في القائمة، باستخدام الأمر /generate، أدخِل /generate function to create a Cloud Storage bucket ثم اضغط على Enter (لنظام التشغيل Windows وLinux) أو Return (لنظام التشغيل macOS).

   

   تُنشئ ميزة Gemini Code Assist الرمز البرمجي استنادًا إلى طلبك في عرض الاختلافات.

   

3. اختياري: لقبول هذه التغييرات، انقر على قبول.

IntelliJ

1. في ملف الرموز البرمجية، اضغط على Alt+\ (لنظام التشغيل Windows و Linux) أو Cmd+\ (لنظام التشغيل macOS) في سطر جديد لفتح قائمة Gemini Code Assist Quick Pick.

2. في القائمة، باستخدام الأمر /generate، أدخِل /generate function to create a Cloud Storage bucket ثم اضغط على Enter (لنظامَي التشغيل Windows وLinux) أو Return (لنظام التشغيل macOS).

   

   تُنشئ ميزة Gemini Code Assist الرمز البرمجي استنادًا إلى طلبك في عرض الاختلافات.

   

3. اختياري: لقبول هذه التغييرات، انقر على قبول التغييرات.

   يمكنك استخدام أوامر تحويل الرموز البرمجية التالية في بيئة تطوير البرامج المتكاملة:

   • /fix: حلّ المشاكل أو الأخطاء في الرمز البرمجي مثال: /fix potential NullPointerExceptions in my code
   • /generate: إنشاء رمز برمجي مثال: /generate a function to get the current time
   • /doc: أضِف مستندات إلى الرمز البرمجي. مثال: /doc this function
   • /simplify: عليك تبسيط الرمز. مثال: /simplify if statement in this code

طلب مساعدة Gemini Code Assist في ملف رمز برمجي باستخدام تعليق

يمكنك أيضًا طلب مساعدة Gemini في ملف الرمز البرمجي باستخدام تعليق باتّباع الخطوات التالية:

VS Code

1. في سطر جديد، أدخِل التعليق Function to create a Cloud Storage bucket، ثم اضغط على Enter (لنظام التشغيل Windows وLinux) أو Return (لنظام التشغيل macOS).

2. لإنشاء رمز، اضغط على Control ‏+ Enter (لنظامَي التشغيل Windows وLinux) أو Control ‏+ Return (لنظام التشغيل macOS).

   بجانب نص الطلب في ملف الرمز البرمجي، ينشئ Gemini Code Assist الرمز البرمجي في شكل نص غير مرئي.

3. اختياري: لقبول الرمز الذي تم إنشاؤه، اضغط على مفتاح Tab.

IntelliJ

1. في ملف الرموز البرمجية، أدخِل التعليق Function to create a Cloud Storage bucket في سطر جديد.

2. لإنشاء رمز، اضغط على Alt+G (لنظام التشغيل Windows وLinux) أو Option+G (لنظام التشغيل macOS). بدلاً من ذلك، يمكنك النقر بزر الماوس الأيمن بجانب التعليق واختيار إنشاء رمز.

   تُنشئ ميزة Gemini Code Assist الرمز البرمجي أسفل تعليقك في شكل نص غير مرئي.

3. اختياري: لقبول الرمز الذي تم إنشاؤه، اضغط على مفتاح Tab.

اختياري: تغيير اختصار لوحة المفاتيح لإنشاء الرمز

إذا لم يعمل اختصار لوحة المفاتيح التلقائي لإنشاء الرمز كما هو موضّح في القسم السابق، يمكنك تغيير اختصار لوحة المفاتيح باتّباع الخطوات التالية:

VS Code

1. في بيئة تطوير البرامج المتكاملة، انقر على ملف (لنظام التشغيل Windows وLinux) أو رمز (لنظام التشغيل MacOS)، ثم انتقِل إلى الإعدادات > اختصارات لوحة المفاتيح.

2. في قائمة اختصارات لوحة المفاتيح، انتقِل إلى أن تعثر على Gemini Code Assist: Generate code (مساعدة: إنشاء رمز).

3. انقر على Gemini Code Assist: إنشاء رمز، ثم انقر على edit تغيير تعيينات المفاتيح.

4. في مربّع الحوار الذي يظهر، أدخِل الاختصار الذي تريده.

5. اضغط على Enter (لنظام التشغيل Windows وLinux) أو Return (لنظام التشغيل MacOS).

   يمكنك الآن استخدام اختصار لوحة المفاتيح الذي تم تعيينه حديثًا لإنشاء رمز برمجي باستخدام Gemini Code Assist.

لمزيد من المعلومات عن تغيير الاختصارات في بيئة تطوير البرامج المتكاملة، يُرجى الاطّلاع على مقالة تعيينات المفاتيح في Visual Studio Code.

IntelliJ

1. انتقِل إلى settings إعدادات IDE والمشروع > الإعدادات > مخطّط المفاتيح > مساعدة Gemini Code.

2. انقر بزر الماوس الأيمن على Gemini Code Assist واختَر إضافة اختصار لوحة مفاتيح.

3. أدخِل اختصار لوحة المفاتيح المفضّل لديك، ثم انقر على حسنًا.

4. انقر بزر الماوس الأيمن على Gemini Code Assist واختَر إزالة Alt+G (لنظامَي التشغيل Windows وLinux)، أو إزالة Option+G (لنظام التشغيل macOS).

يمكنك الآن استخدام اختصار لوحة المفاتيح الجديد لإنشاء رمز في ملف رمز.

الحصول على عمليات إكمال الرموز البرمجية

أثناء كتابة الرمز البرمجي، تقدّم ميزة Gemini Code Assist اقتراحات بشأن التعليمات البرمجية المضمّنة، والتي تُعرف أيضًا باسم إكمال الرمز البرمجي، ويمكنك قبولها أو تجاهلها. للحصول على عمليات إكمال الرموز، اتّبِع الخطوات التالية:

VS Code

1. في ملف الرموز البرمجية، ابدأ كتابة دالة في سطر جديد. على سبيل المثال، إذا كنت تستخدم ملف Python، اكتب def.

   تقترح ميزة Gemini Code Assist الرموز البرمجية في شكل نص غير مرئي.

2. لقبول اقتراح الرمز من ميزة "مساعدة بشأن الرموز" في Gemini، اضغط على مفتاح Tab. بخلاف ذلك، لتجاهل الاقتراح، اضغط على Esc أو واصِل كتابة الرمز.

IntelliJ

1. في ملف الرموز البرمجية، ابدأ كتابة دالة في سطر جديد. على سبيل المثال، إذا كنت تستخدم ملف Python، اكتب def.

   تقترح ميزة Gemini Code Assist رمزًا برمجيًا في شكل اقتراح مضمّن.

2. لقبول اقتراح الرمز من ميزة "مساعدة بشأن الرموز" في Gemini، اضغط على مفتاح Tab. بخلاف ذلك، لتجاهل الاقتراح، اضغط على Esc أو واصِل كتابة الرمز.

3. اختياري: إذا كنت تفضّل استخدام مفتاح اختصار مختلف لقبول الاقتراحات المضمّنة، مرِّر مؤشر الماوس فوق الاقتراح المضمّن وانقر على القائمة المنسدلة Tab التي تظهر. بعد ذلك، اختَر الاختصار المفضّل لديك أو انقر على مخصّص لإدخال اختصارك الخاص.

   

اختياري: إيقاف ميزة إكمال الرموز البرمجية

يتم تفعيل ميزة "إكمال الرموز البرمجية" تلقائيًا. إذا كنت تريد إيقاف ميزة إكمال الرموز البرمجية، اتّبِع الخطوات التالية:

VS Code

1. في بيئة تطوير البرامج المتكاملة، انقر على Code (لنظام التشغيل macOS) أو File (ملف) (لنظام التشغيل Windows و Linux)، ثم انتقِل إلى Settings (الإعدادات) > Settings (الإعدادات).

2. في علامة التبويب المستخدم ضمن مربّع الحوار الإعدادات، انتقِل إلى الإضافات > مساعدة Gemini في كتابة الرموز البرمجية.

3. انتقِل للأسفل إلى أن تعثر على قائمة Duet AI: الاقتراحات المضمّنة: تفعيل الاقتراحات التلقائية، ثمّ اختَر إيقاف.

   يؤدي ذلك إلى إيقاف الاقتراحات المضمّنة. سيظل بإمكانك الضغط على Control+Enter (لنظامَي التشغيل Windows وLinux) أو Control+Return (لنظام التشغيل macOS) لعرض الاقتراحات المضمّنة يدويًا.

IntelliJ

في شريط الحالة في بيئة تطوير البرامج المتكاملة، انقر على spark Gemini Code Assist: Active (مساعدة Gemini في كتابة الرموز البرمجية: نشطة) واختَر Enable AI Code Completion (تفعيل ميزة "إكمال الرموز البرمجية" المستندة إلى الذكاء الاصطناعي).

يؤدي ذلك إلى إيقاف إعداد إكمال الرمز، وإلى عدم تقديم "مساعِد رمز Gemini" لاقتراحات مضمّنة إلى أن تتم إعادة تفعيل الإعداد.

استخدام الإجراءات الذكية

لمساعدتك في زيادة إنتاجيتك مع تقليل عمليات تبديل السياق، يوفّر "مساعِد الرموز البرمجية من Gemini" إجراءات ذكية مستندة إلى الذكاء الاصطناعي مباشرةً في محرِّر الرموز البرمجية. عند اختيار الرمز في محرِّر الرموز، يمكنك عرض والاختيار من قائمة الإجراءات ذات الصلة بالسياق.

لاستخدام الإجراءات الذكية في الرمز البرمجي، اتّبِع الخطوات التالية:

VS Code

1. في ملف الرموز البرمجية، اختَر مجموعة من الرموز البرمجية.

2. بجانب مجموعة الرموز المحدّدة، انقر على lightbulb عرض رمز الإجراءات.

   

3. اختَر إجراءً، مثل إنشاء اختبارات الوحدة.

   تُنشئ ميزة "مساعدة ترميز Gemini" ردًا يستند إلى الإجراء الذي اخترته.

IntelliJ

1. في ملف الرمز البرمجي، اختَر سطرًا أو مجموعة من الرموز البرمجية.

2. انقر بزر الماوس الأيمن على الرمز المحدّد واختَر إجراءً ذكيًا، مثل إنشاء اختبارات وحدات.

   سيؤدي اختيار الإجراء الذكي إلى تلقائيًا توجيه Gemini Code Assist لإنشاء ردّ على الطلب في نافذة أداة Gemini Code Assist.

استخدام حلّ سريع لتحويل الرموز

إذا كان هناك خطأ في الرمز، يمنحك Gemini Code Assist خيار تطبيق حلّ سريع على الخطأ من خلال تحويل الرمز.

لتطبيق حلّ سريع في ملف الرموز البرمجية، اتّبِع الخطوات التالية:

VS Code

1. في ملف الرموز البرمجية، مرِّر مؤشر الماوس فوق سطر الخطأ المموّه و اختَر Quick Fix (الإصلاح السريع)، ثم اختَر /fix.

   

2. عند تطبيق الحلّ السريع، يظهر عرض الاختلافات. لقبول هذه التغييرات، انقر على قبول.

IntelliJ

1. في ملف الرمز، انقر على رمز مصباح الخطأ الأحمر الذي يشير إلى خطأ في الرمز، واختَر الإصلاح باستخدام Gemini.

   

2. عند تطبيق الإصلاح، تظهر طريقة عرض الاختلافات. لقبول هذه التغييرات، انقر على قبول.

إيقاف اقتراحات الرموز البرمجية التي تتطابق مع المصادر المُستشهد بها

ملاحظة: لا يمكن إيقاف ميزة اقتراحات الرموز البرمجية التي تتطابق مع المصادر المُستشهد بها في IDE IDE IntelliJ وأدوات تطوير البرامج الأخرى من JetBrains.

تقدّم ميزة Gemini Code Assist معلومات الاقتباس عندما يقتبس بشكل مباشر من مصدر آخر، مثل رمز برمجي حالي مفتوح المصدر. للحصول على مزيد من المعلومات، يُرجى الاطّلاع على كيف ومتى يذكر Gemini المصادر.

لمنع اقتراح الرموز البرمجية التي تتطابق مع المصادر المُستشهد بها، اتّبِع الخطوات التالية:

1. في شريط الأنشطة في بيئة تطوير البرامج المتكاملة، انقر على إدارة > الإعدادات.

2. في علامة التبويب المستخدم ضمن نافذة الإعدادات، انتقِل إلى الإضافات > Gemini Code Assist.

3. انتقِل للأسفل إلى أن يظهر لك Duet AI > القراءة: الحد الأقصى لطول المقتطف المُقتبس.

4. اضبط القيمة على 0.

   لم تعُد أداة Gemini Code Assist تقترح عليك رمزًا يتطابق مع المصادر المُستشهد بها.

المشاكل المعروفة

يوضّح هذا القسم المشاكل المعروفة في Gemini Code Assist:

VS Code

• قد يتم اقتطاع ردود Chat إذا كانت تتضمّن نسخة معدّلة من ملف مفتوح كبير.

  لحلّ هذه المشكلة، اختَر قسمًا أصغر من الرمز البرمجي وأدرِج توجيهًا إضافيًا في طلب المحادثة، مثل only output the selected code..

• Vim: لا يمكن قبول اقتراحات إنشاء الرموز أو رفضها ما لم تكن في وضع الإدراج

  عند استخدام المكوّن الإضافي Vim في الوضع العادي، لا يمكنك قبول اقتراحات الرمز البرمجي أو رفضها.

  لحلّ هذه المشكلة، اضغط على i للدخول إلى وضع الإدراج، ثم اضغط على Tab لقبول الاقتراح.

• Vim: سلوك غير متّسق عند الضغط على Esc لإغلاق الاقتراحات

  عند الضغط على Esc، يتم رفض كلّ من اقتراحات IDE وGemini Code Assist. يختلف هذا السلوك عن السلوك في Vim حيث يؤدي الضغط على Esc إلى إعادة تفعيل ميزة "مساعدة كتابة الرموز البرمجية" في Gemini.

• تنتهي مهلة محاولات تسجيل الدخول باستمرار

  إذا استمرّت محاولات تسجيل الدخول في انتهاء مهلة الانتظار، حاوِل إضافة الإعداد cloudcode.beta.forceOobLogin إلى ملف settings.json:

   "cloudcode.beta.forceOobLogin": true
  

• عدم استمرار التحذيرات بشأن قراءة الترخيص في الجلسات

  إذا لم تستمر التحذيرات بشأن قراءة الترخيص في جميع الجلسات، يمكنك الرجوع إلى ملف السجلّ الدائم:

  1. انقر على عرض > الإخراج.

  2. انقر على Gemini Code Assist - Citations (مساعدة Gemini في كتابة الرموز البرمجية - الإحالات).

• مشاكل الاتصال في نافذة مخرجات Gemini Code Assist

  إذا ظهرت لك رسالة خطأ في الاتصال أو مشاكل أخرى في الاتصال في نافذة إخراج Gemini Code Assist، جرِّب ما يلي:

  • عليك ضبط جدار الحماية للسماح بالوصول إلى oauth2.googleapis.com و cloudaicompanion.googleapis.com.

  • عليك ضبط جدار الحماية للسماح بالاتصال عبر HTTP/2 الذي يستخدمه gRPC.

  يمكنك استخدام أداة grpc-health-probe لاختبار الاتصال. يؤدي الفحص الناجح إلى ظهور النتيجة التالية:

  $ grpc-health-probe -addr cloudaicompanion.googleapis.com:443 -tls error: this server does not implement the grpc health protocol (grpc.health.v1.Health): GRPC target method can't be resolved

  يؤدي التحقّق غير الناجح إلى النتيجة التالية:

  timeout: failed to connect service "cloudaicompanion.googleapis.com:443" within 1s

  للحصول على مزيد من التفاصيل، عليك تنفيذ ما يلي قبل grpc-health-probe:

  export GRPC_GO_LOG_SEVERITY_LEVEL=info
  

IntelliJ

ما مِن مشاكل معروفة في ميزة Gemini Code Assist لـ IntelliJ وغيرها من حِزم تطوير البرامج المتكاملة (IDE) المتوافقة من JetBrains.

تقديم تعليقات

اتّبِع الخطوات التالية لترك ملاحظات حول تجربتك:

VS Code

1. في شريط الحالة، انقر على spark Gemini Code Assist، ثمّ اختَر إرسال ملاحظات في قائمة خيار سريع.

2. في النموذج، املأ حقلَي العنوان والتعليقات.

3. إذا أردت مشاركة سجلات Skaffold أو AI Companion، احرص على اختيار إرسال سجلات Skaffold أو إرسال سجلات AI Companion.

4. انقر على إرسال ملاحظات.

IntelliJ

1. في شريط الحالة، انقر على spark Gemini Code Assist، ثمّ اختَر إرسال ملاحظات في القائمة.

2. في حقل النص في أعلى النموذج، أدخِل ملاحظاتك.

3. إذا كنت تريد مشاركة سجلّات Gemini Code Assist، احرص على اختيار ملفات السجلّ.

4. انقر على إرسال ملاحظات.

الخطوات التالية

• كيفية استخدام Gemini في Google Cloud لبياناتك
• مزيد من المعلومات حول أسعار Gemini Code Assist Standard وEnterprise