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