لتطوير مشاريع "برمجة تطبيقات 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
"، يجب أن يكون لديك
تثبيت الإصدار 4.7.4 أو إصدار أحدث من Node.js.
يتطلب تثبيت Node.js الحصول على امتيازات إدارية.
تثبيت
بعد تثبيت Node.js، يمكنك استخدام الأمر npm
التالي من أجل
تثبيت clasp
:
npm install @google/clasp -g
بعد التثبيت، يمكنك استخدام الأمر clasp
من أي دليل على
جهاز الكمبيوتر.
جارٍ استخدام clasp
يمكنك استخدام clasp
للتعامل مع مجموعة متنوعة من المهام من سطر الأوامر. هذا النمط
العمليات الشائعة التي يمكنك استخدامها عند تطوير البرامج باستخدام clasp
.
تسجيل الدخول
يقوم هذا الأمر بتسجيل الدخول والسماح بإدارة حساب 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.