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

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

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

الميزات

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

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

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

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

تعليمة البنية البرمجية

تسمح لك 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، أنشئ أولاً إصدارًا غير قابل للتغيير من مشروع "برمجة التطبيقات". النسخة هي "لقطة" لمشروع نصي وتشبه إصدارًا متفرّع للقراءة فقط.

clasp version [description]

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

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

يعدِّل هذا الأمر عملية نشر حالية من خلال إضافة وصف جديد لإصدار جديد:

clasp redeploy <deploymentId> <version> <description>

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

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

clasp deployments

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

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

clasp open

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

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