1. مقدمة
واجهة سطر الأوامر في "برمجة تطبيقات Google"، أو clasp، هي أداة تتيح لك إنشاء مشاريع برمجة تطبيقات Google وتعديلها ونشرها محليًا. تتيح لك إنشاء تطبيقات ويب وإضافات ونشرها لمنتجات مثل "جداول بيانات Google" و"مستندات Google" و"نماذج Google" و"العروض التقديمية من Google" من سطر الأوامر. يمكنك تطوير "برمجة تطبيقات Google" بطريقتَين، إما باستخدام script.google.com أو محليًا على جهاز الكمبيوتر. سنتعرّف على الأداة الأخيرة، أي كيفية استخدام 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
أهداف الدورة التعليمية
سيوضّح لك هذا الدرس التطبيقي حول الترميز كيفية تنفيذ 3 أنشطة رئيسية باستخدام clasp:
- كيفية إنشاء مشاريع جديدة في "برمجة تطبيقات Google"
- كيفية استنساخ المشاريع الحالية وسحبها ودفعها
- كيفية إدارة عمليات نشر النصوص البرمجية
2. البدء
تنزيل واجهة سطر الأوامر
يتطلّب استخدام واجهة سطر الأوامر (CLI) في برمجة تطبيقات (clasp) تثبيت Node.js. ثبِّت Node.js من هنا.
بعد تثبيت Node، ثبِّت واجهة سطر الأوامر على مستوى العالم (الاسم المستعار clasp):
npm i @google/clasp -g
3- تفعيل Apps Script API
قبل أن تتمكّن من استخدام Clasp، يجب تفعيل واجهة برمجة التطبيقات Apps Script API من Google في بيئة تطوير Apps Script المتكاملة.
4. تسجيل الدخول
تسجيل الدخول
لنجرّب clasp. الأمر الوحيد الذي عليك تذكّره هو clasp.
clasp
قبل بدء استخدام أداة سطر الأوامر، يجب تسجيل الدخول. نفِّذ الأمر التالي:
clasp login
أو إذا كنت تستخدم SSH:
clasp login --no-localhost
في هذه المرحلة، سيُطلب منك تسجيل الدخول إلى Google. يتم ربط أي مشاريع تنشئها باستخدام واجهة سطر الأوامر بحساب Google هذا.
5- إنشاء مشروع جديد
إنشاء مشروع مستقل
ابدأ بإنشاء مشروع مستقل في "برمجة تطبيقات Google" باستخدام الأمر التالي:
mkdir clasp_codelab;
cd clasp_codelab;
clasp create --title "Clasp Codelab" --type standalone;
لقد أنشأت للتو مشروع "برمجة تطبيقات Google" في المجلد "clasp_codelab".
(بديل اختياري) استنساخ مشروع حالي
لنجرّب إنشاء نص برمجي مرتبط بحاوية لإضافة Google Slides.
لإجراء ذلك، انتقِل إلى slides.google.com وأنشئ عرضًا تقديميًا جديدًا. غيِّر اسم العرض التقديمي إلى "clasp Codelab Test". في شريط قائمة "العروض التقديمية من Google"، في قائمة الإضافات، اختَر برمجة التطبيقات.
سيؤدي ذلك إلى فتح مشروع "برمجة التطبيقات" على script.google.com.
أنشئ دليلاً جديدًا لمشروعك، ثم انتقِل إليه باستخدام الأمر cd.
mkdir clasp_codelab_test
cd clasp_codelab_test
لاستنساخ مشروع، نحتاج إلى Script ID. يمكنك العثور على رقم التعريف هذا في عنوان URL لمشروع "برمجة التطبيقات" بعد /projects/. انسخ القيمة والصقها في الأمر التالي:
clasp clone <scriptID>
يجب أن تبدو النتيجة على النحو التالي...
بعد ذلك، تكون قد نزّلت المشروع في الدليل الحالي. استخدِم المحرّر المفضّل لديك لعرض محتوى Code.gs (دالة فارغة).
6. سحب الملفات ودفعها
تعديل الرمز على script.google.com
بعد أن أصبح بإمكانك استنساخ مشروع، لننتقل إلى كيفية سحب الملفات ودفعها. سنرشدك خلال خطوات التعديل على السحابة الإلكترونية من خلال script.google.com وسحب الملف إلى جهاز الكمبيوتر. لنفتح النص البرمجي في السحابة الإلكترونية:
clasp open-script
بعد أن انتقلنا إلى المحرّر على الإنترنت، سنعدّل بعض الرموز على الإنترنت التي سنسترجعها لاحقًا باستخدام clasp.
لإنشاء ملف "برمجة تطبيقات Google" جديد، انقر على "إضافة ملف" 
> نص برمجي على يمين المحرِّر بجانب الملفات. أدخِل الاسم utils/strings. في الملف الذي تم إنشاؤه حديثًا، utils/strings.gs، استبدِل الرمز بما يلي:
var world = "世界";
في Code.gs، استبدِل الرمز الحالي بالرمز التالي:
function hello() {
Logger.log("Hello, " + world);
}
في أعلى الشاشة، انقر على "حفظ" 
.
لتشغيل الدالة، اختَر hello من القائمة المنسدلة للدالة في أعلى المحرّر، ثم انقر على تشغيل.
يظهر الترحيب في أسفل سجل التنفيذ.
تعديل الرمز البرمجي محليًا
لنرجع إلى سطر الأوامر حيث استنسخنا المشروع آخر مرة. قد تلاحظ أنّ الرمز الخاص بنا لم يعُد متزامنًا مع المحرّر على الإنترنت. لحلّ هذه المشكلة، لنستردّ الرمز من مشروعنا على الإنترنت.
clasp pull
الآن، ارجع إلى التعليمات البرمجية. ستلاحظ وجود مجلد للأدوات المساعدة. تحوّل واجهة سطر الأوامر clasp تلقائيًا الشرطة المائلة / إلى مجلدات في نظام الملفات المحلي.
في برنامج تعديل النصوص المفضّل لديك، انتقِل إلى util/strings.gs واستبدِل اسم المتغيّر world بـ mondo. عدِّل أيضًا ملف Code.gs من خلال استبدال world بـ mondo. لتعديل الرمز المعدَّل على script.google.com، عليك إرسال الرمز المعدَّل.
clasp push
هذا كل ما في الأمر! تم تعديل الرمز الآن في script.google.com.
7. تحديد الإصدار والنشر
تتيح لك clasp إدارة الإصدارات وعمليات النشر. أولاً، إليك بعض المصطلحات:
- الإصدار: هو "لقطة" لمشروع نص برمجي. يمكن اعتبار الإصدار فرعًا للقراءة فقط يُستخدم في عمليات النشر.
- النشر: إصدار منشور لمشروع نص برمجي (غالبًا كإضافة أو تطبيق ويب) يجب إدخال رقم إصدار.
لننشئ نسخة من النص البرمجي:
clasp create-version "First version"
باستخدام سلسلة إصدار السجلّ التي أنشأناها بدلاً من [version]، يمكننا نشر النص البرمجي:
clasp create-deployment 1 "First deployment"
يبحث الأمر clasp deploy في ملف البيان وينشئ عملية نشر جديدة تتضمّن إصدارًا. تم الآن نشر الرمز كملف تنفيذي. يمكنك الاطّلاع على مزيد من المعلومات حول هذا الموضوع في دليل عمليات النشر.
8. هذا كل شيء!
نأمل أن تكون واجهة سطر الأوامر في "برمجة تطبيقات Google" أداة بسيطة تساعدك في إدارة مشاريع "برمجة تطبيقات Google".
المواضيع التي تناولناها
- كيفية إنشاء مشاريع جديدة في "برمجة تطبيقات Google"
- كيفية استنساخ المشاريع الحالية ونقلها وسحبها
- كيفية إدارة عمليات نشر النصوص البرمجية
يتوفّر Clasp على GitHub، ونرحّب بالميزات والتصحيحات الجديدة.
نحن متحمّسون لرؤية ما ستصمّمه.