لتطوير مشاريع "برمجة تطبيقات 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.