لتطوير مشاريع Apps Script وإدارتها من نافذة الأوامر بدلاً من محرّر Apps Script، يمكنك استخدام أداة مفتوحة المصدر تُسمى clasp.
تقدّم clasp تجربة البرمجة هذه نظرة عامة على جميع ميزات
clasp.
الميزات
التطوير محليًا
تتيح لك أداة clasp تطوير مشاريعك في "برمجة تطبيقات Google" على جهازك. يمكنك كتابة الرمز البرمجي على جهاز الكمبيوتر الخاص بك وتحميله إلى Apps Script عند الانتهاء. يمكنك أيضًا تنزيل مشاريع "برمجة تطبيقات 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.
تسجيل الدخول
يسجّل هذا الأمر الدخول ويمنح الإذن بإدارة مشاريع Apps Script في حسابك على Google. بعد تشغيلها، سيُطلب منك تسجيل الدخول إلى حساب Google يتم فيه تخزين مشاريع "برمجة تطبيقات Google".
clasp login
تسجيل الخروج
يؤدي هذا الأمر إلى تسجيل الخروج من أداة سطر الأوامر. عليك تسجيل الدخول مجددًا باستخدام
clasp login لإعادة المصادقة مع Google قبل مواصلة استخدام clasp.
clasp logout
إنشاء مشروع جديد في "برمجة تطبيقات Google"
ينشئ هذا الأمر نصًا برمجيًا جديدًا في الدليل الحالي مع عنوان اختياري للنص البرمجي.
clasp create [scriptTitle]
ينشئ هذا الأمر أيضًا ملفَين في الدليل الحالي:
- ملف
.clasp.jsonيخزّن رقم تعريف النص البرمجي - ملف بيان مشروع
appsscript.jsonيحتوي على البيانات الوصفية للمشروع
استنساخ مشروع حالي
ينسخ هذا الأمر مشروعًا حاليًا في الدليل الحالي. يجب إنشاء النص البرمجي أو مشاركته مع حسابك على Google. يمكنك تحديد مشروع البرنامج النصي الذي تريد استنساخه من خلال تقديم معرّف البرنامج النصي.
للعثور على رقم تعريف البرنامج النصي للمشروع، اتّبِع الخطوات التالية:
- افتح مشروع "برمجة تطبيقات Google".
- على يمين الصفحة، انقر على إعدادات المشروع .
ضِمن "أرقام التعريف"، انسخ "رقم تعريف النص البرمجي".
clasp clone <scriptId>
تنزيل مشروع نص برمجي
يؤدي هذا الأمر إلى تنزيل مشروع "برمجة تطبيقات Google" من Google Drive إلى نظام الملفات على جهاز الكمبيوتر.
clasp pull
تحميل مشروع نص برمجي
يحمّل هذا الأمر جميع ملفات مشروع البرنامج النصي من جهاز الكمبيوتر إلى Google Drive.
clasp push
عرض قائمة بإصدارات المشروع
يعرض هذا الأمر رقم كل إصدار من إصدارات مشروع البرنامج النصي ووصفه.
clasp versions
نشر مشروع منشور
يمكنك نشر مشاريع النصوص البرمجية كتطبيقات ويب أو إضافات أو ملفات تنفيذية. يمكنك إنشاء عمليات نشر في محرّر النصوص البرمجية أو في ملف البيان الخاص بالمشروع أو باستخدام clasp.
لنشر مشروع باستخدام clasp، عليك أولاً إنشاء إصدار غير قابل للتغيير من مشروع Apps Script. الإصدار هو "لقطة" لمشروع نص برمجي، وهو يشبه إصدارًا متفرّعًا للقراءة فقط.
clasp version [description]
يعرض هذا الأمر رقم الإصدار الذي تم إنشاؤه حديثًا. باستخدام هذا الرقم، يمكنك نشر وإلغاء نشر مثيلات مشروعك:
clasp deploy [version] [description]
clasp undeploy <deploymentId>
يعدّل هذا الأمر عملية نشر حالية بإصدار ووصف جديدَين:
clasp redeploy <deploymentId> <version> <description>
إدراج عمليات النشر
يسرد هذا الأمر معرّفات عمليات نشر مشروع النص البرمجي وإصداراته وأوصافها.
clasp deployments
فتح المشروع في محرِّر Apps Script
يفتح هذا الأمر مشروع نص برمجي في محرّر "برمجة تطبيقات Google". يتم تشغيل المحرِّر كعلامة تبويب جديدة في متصفّح الويب التلقائي.
clasp open
المساهمة في مشروع clasp المفتوح المصدر
يمكنك المساهمة في clasp على GitHub.