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