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