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