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