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