استخدام واجهة سطر الأوامر مع مشبك

لتطوير مشاريع "برمجة التطبيقات" وإدارتها من الوحدة الطرفية بدلاً من محرِّر "برمجة تطبيقات Google"، يمكنك استخدام أداة مفتوحة المصدر تُسمى clasp.

يوفّر الدرس التطبيقي حول الترميز clasp نظرة عامة حول جميع ميزات clasp.

الميزات

التطوير محليًا

يتيح لك تطبيق "clasp" تطوير مشاريع "برمجة التطبيقات" محليًا. يمكنك كتابة الرمز على جهاز الكمبيوتر وتحميله إلى "برمجة تطبيقات Google" عند الانتهاء. يمكنك أيضًا تنزيل مشاريع "برمجة التطبيقات" الحالية حتى تتمكّن من تعديلها عندما تكون غير متصل بالإنترنت. بما أنّ الرمز محلي، يمكنك استخدام أدوات التطوير المفضّلة لديك، مثل git، عند إنشاء مشاريع "برمجة تطبيقات Google".

إدارة إصدارات النشر

يمكنك إنشاء عمليات نشر متعددة لمشروعك وتعديلها وعرضها.

بنية الرمز

تتيح لك clasp إمكانية تنظيم الرمز في أدلة يتم الاحتفاظ بها عند تحميلها إلى script.google.com، على سبيل المثال:

# On script.google.com:
├── tests/slides.gs
└── tests/sheets.gs

# Locally:
├── tests/
│   ├─ slides.gs
│   └─ sheets.gs

المتطلّبات

تتم كتابة clasp بلغة Node.js وتوزيعها من خلال أداة npm. قبل استخدام clasp، يجب تثبيت الإصدار 4.7.4 من Node.js أو إصدار أحدث. يتطلب تثبيت Node.js امتيازات إدارية.

تثبيت

بعد تثبيت Node.js، يمكنك استخدام أمر npm التالي لتثبيت clasp:

npm install @google/clasp -g

بعد تثبيت الأمر، يصبح الأمر clasp قابلاً للاستخدام من أي دليل على جهاز الكمبيوتر.

جارٍ استخدام clasp

يمكنك استخدام clasp للتعامل مع مجموعة متنوعة من المهام من سطر الأوامر. يوضّح هذا القسم العمليات الشائعة التي يمكنك استخدامها عند تطوير البرامج باستخدام clasp.

تسجيل الدخول

يسجّل هذا الأمر الدخول ويفوّض إدارة مشاريع "برمجة التطبيقات" في حسابك على Google. بعد تشغيله، سيُطلب منك تسجيل الدخول إلى حساب Google حيث يتم تخزين مشاريع برمجة التطبيقات.

clasp login

تسجيل الخروج

ويسجّل هذا الأمر الخروج من أداة سطر الأوامر. يجب إعادة تسجيل الدخول باستخدام clasp login لإعادة المصادقة مع Google قبل مواصلة استخدام clasp.

clasp logout

إنشاء مشروع جديد لبرمجة التطبيقات

يؤدي هذا الأمر إلى إنشاء نص برمجي جديد في الدليل الحالي مع عنوان نص برمجي اختياري.

clasp create [scriptTitle]

يؤدي هذا الأمر أيضًا إلى إنشاء ملفَين في الدليل الحالي:

  • ملف .clasp.json يُخزِّن رقم تعريف النص البرمجي.
  • ملف بيان مشروع appsscript.json يحتوي على البيانات الوصفية للمشروع.

استنساخ مشروع حالي

ينسخ هذا الأمر مشروعًا حاليًا في الدليل الحالي. يجب إنشاء النص البرمجي أو مشاركته مع حسابك على Google. يمكنك تحديد مشروع النص البرمجي الذي تريد استنساخه من خلال تقديم رقم تعريف النص البرمجي الخاص به.

للعثور على رقم تعريف النص البرمجي للمشروع، اتّبِع الخطوات التالية:

  1. فتح مشروع "برمجة تطبيقات Google"
  2. على يمين الصفحة، انقر على إعدادات المشروع .
  3. ضمن المعرّفات، انسخ رقم تعريف النص البرمجي.

     clasp clone <scriptId>
    

تنزيل مشروع نص برمجي

يؤدي هذا الأمر إلى تنزيل مشروع "برمجة تطبيقات Google" من Google Drive إلى نظام الملفات في جهاز الكمبيوتر.

clasp pull

تحميل مشروع نص برمجي

يؤدي هذا الأمر إلى تحميل جميع ملفات مشروع النص البرمجي من الكمبيوتر إلى Google Drive.

clasp push

سرد إصدارات المشروع

يسرد هذا الأمر رقم ووصف كل نسخة من نُسخ مشروع النص البرمجي.

clasp versions

نشر مشروع منشور

يمكنك نشر مشاريع النصوص البرمجية كتطبيقات ويب أو إضافات أو ملفات قابلة للتنفيذ. يمكنك إنشاء عمليات نشر في محرّر النصوص البرمجية أو في بيان المشروع أو باستخدام clasp.

لنشر مشروع باستخدام clasp، عليك أولاً إنشاء إصدار غير قابل للتغيير من مشروع "برمجة تطبيقات Google". الإصدار هو "لقطة" لمشروع نصي ويشبه إصدارًا متفرّعًا للقراءة فقط.

clasp version [description]

يعرض هذا الأمر رقم الإصدار الذي تم إنشاؤه حديثًا. باستخدام هذا الرقم، يمكنك نشر مثيلات من مشروعك وإلغاء نشرها:

clasp deploy [version] [description]
clasp undeploy <deploymentId>

يؤدي هذا الأمر إلى تعديل عملية نشر حالية بإصدار جديد ووصف جديد:

clasp redeploy <deploymentId> <version> <description>

سرد عمليات النشر

يسرد هذا الأمر معرّفات نشر مشروع النص البرمجي وإصداراته وأوصافها.

clasp deployments

فتح المشروع في محرِّر "برمجة تطبيقات Google"

يفتح هذا الأمر مشروع نص برمجي في محرِّر "برمجة تطبيقات Google". يتم تشغيل المحرر كعلامة تبويب جديدة في متصفح الويب الافتراضي.

clasp open

المساهمة في مشروع clasp مفتوح المصدر

يمكنك المساهمة في "clasp" على GitHub.