لتطوير مشاريع Apps Script وإدارتها من وحدة التحكّم بدلاً من
محرر Apps Script، يمكنك استخدام أداة مفتوحة المصدر تُسمى clasp.
يوفّر clasp codelab نظرة عامة على جميع ميزات
clasp.
الميزات
التطوير محليًا
يتيح لك clasp تطوير مشاريعك في "برمجة تطبيقات Google" على الجهاز. يمكنك
كتابة الرمز البرمجي على جهاز الكمبيوتر الخاص بك وتحميله إلى Apps Script عند الانتهاء. يمكنك أيضًا تنزيل مشاريع "برمجة تطبيقات 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 حيث يتم تخزين مشاريعك في "برمجة تطبيقات Google".
clasp login
تسجيل الخروج
يؤدي هذا الأمر إلى تسجيل الخروج من أداة سطر الأوامر. عليك إعادة تسجيل الدخول باستخدام
clasp login لإعادة المصادقة مع Google قبل مواصلة استخدام clasp.
clasp logout
إنشاء مشروع جديد في Apps Script
ينشئ هذا الأمر نصًا برمجيًا جديدًا في الدليل الحالي باستخدام عنوان ملف برمجي اختياري.
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.