إنتقل إلى المحتوى الرئيسي

تطوير السكرپتات باستخدام VSCode

يوفر ScriptCat إضافة لـ VSCode تتيح لك كتابة سكرپتات المستخدم في VSCode. بعد الحفظ، تتم مزامنة التغييرات تلقائياً إلى ScriptCat في المتصفح — دون الحاجة إلى النسخ واللصق اليدوي، مما يحسن كفاءة التطوير بشكل كبير.

المتطلبات الأساسية​

تحتاج إلى تثبيت الأداتين التاليتين:

  1. تثبيت إضافة ScriptCat في متصفحك — إذا لم تكن قد ثبّتتها بعد، اتبع دليل البداية السريعة لتثبيتها
  2. تثبيت إضافة ScriptCat في VSCode — ابحث عن "scriptcat-vscode" في سوق إضافات VSCode، أو قم بتنزيلها من مستودع GitHub

إنشاء اتصال​

بعد التثبيت، تحتاج إلى ربط إضافة ScriptCat في متصفحك مع VSCode:

  1. انقر على أيقونة ScriptCat في متصفحك لفتح لوحة الإدارة
  2. انتقل إلى الأدوات > أدوات المطور
  3. ابحث عن الاتصال التلقائي بخدمة VSCode، فعّلها، وانقر على اتصال

بمجرد الاتصال، يتم إنشاء قناة في الوقت الفعلي بين VSCode و ScriptCat.

مزامنة السكرپتات​

بعد إنشاء الاتصال، يمكنك اختيار إحدى الطريقتين لمزامنة السكرپتات:

الخيار 1: وضع الكشف التلقائي (موصى به)​

  1. في VSCode، اضغط Ctrl + Shift + P (Cmd + Shift + P على Mac) لفتح لوحة الأوامر
  2. اكتب واختر scriptcat.autoTarget
  3. من الآن فصاعداً، في كل مرة تفتح فيها أو تحفظ ملف .user.js، ستتم مزامنته تلقائياً إلى ScriptCat

الخيار 2: وضع السكرپت المحدد​

  1. في VSCode، اضغط Ctrl + Shift + P (Cmd + Shift + P على Mac) لفتح لوحة الأوامر
  2. اكتب واختر scriptcat.target
  3. حدد مسار ملف السكرپت المراد مزامنته

سير عمل التطوير​

بعد الإعداد، يكون سير عمل التطوير بسيطاً للغاية:

  1. اكتب أو عدّل سكرپت .user.js في VSCode
  2. اضغط Ctrl + S لحفظ الملف
  3. تتم مزامنة السكرپت تلقائياً إلى ScriptCat في المتصفح
  4. انتقل إلى المتصفح وحدّث الصفحة لرؤية النتيجة

لا تتطلب العملية بأكملها أي خطوات يدوية — الحفظ يسري مفعوله فوراً.

الأسئلة الشائعة​

ماذا لو لم يتم الاتصال؟​

  • تأكد من أن إضافة ScriptCat في متصفحك تعمل
  • تأكد من تثبيت وتفعيل إضافة ScriptCat في VSCode
  • تحقق من حالة الاتصال في صفحة "أدوات المطور" في لوحة إدارة ScriptCat

السكرپت لا يتم تحديثه بعد الحفظ؟​

  • تأكد من أن اسم الملف ينتهي بـ .user.js
  • تأكد من تنفيذ أمر scriptcat.autoTarget أو scriptcat.target
  • تحقق من لوحة مخرجات VSCode بحثاً عن أي رسائل خطأ

هل أحتاج إلى إعادة الاتصال بعد إعادة تشغيل VSCode؟​

إذا كان "الاتصال التلقائي بخدمة VSCode" مفعلاً، فسيقوم VSCode بإعادة الاتصال تلقائياً بعد إعادة التشغيل — دون الحاجة إلى خطوات يدوية.