TypeScript هي مجموعة شاملة مكتوبة من لغة JavaScript يمكن تجميعها إلى لغة برمجة تطبيقات عادية. عند استخدام TypeScript في تطوير مشروع لبرمجة التطبيقات، ستحصل على المزايا التالية:
- الإكمال التلقائي لـ IDE المحلي
- الكتابة الهيكلية الاختيارية
- استنتاج الكتابة والواجهات
- ميزات ES6 مثل classes ودوال الأسهم.
يتناول هذا الدليل بعض المهام الشائعة لتطوير مشروع "برمجة تطبيقات Google" باستخدام TypeScript.
المتطلّبات
إذا لم تكن معتادًا على استخدام TypeScript، يُرجى مراجعة وثائق النوع والبدء السريع لـ TypeScript للتعرف على المفاهيم الأساسية قبل محاولة تنفيذ أي من الإجراءات الموضحة في هذا الدليل.
الأدوات التالية مطلوبة لاستخدام TypeScript في مشاريع برمجة التطبيقات
مع clasp
. على الرغم من أن استخدام clasp
ليس ضروريًا بشكل صارم لتفعيل استخدام TypeScript في لغة برمجة التطبيقات، إلا أنه يُنصح به بشدة لأنه يبسط الإجراءات إلى حد كبير.
قبل محاولة تنفيذ أي من العمليات الموضَّحة أدناه، تأكَّد من تثبيت ما يلي لتفعيل بيئة التطوير المحلية:
- العقدة وnpm
clasp
:npm install -g @google/clasp
- تعريفات أنواع "برمجة التطبيقات":
npm i -S @types/google-apps-script
- Visual Studio Code (للإكمال التلقائي لـ TypeScript IDE)
احرص على الاطّلاع على مستندات clasp
إذا لم يسبق لك استخدام clasp
.
استخدام TypeScript في مشروع Clasp
يمكنك استخدام clasp
لإنشاء مشروع جديد لبرمجة تطبيقات Google بسرعة.
يؤدي هذا الأمر إلى إنشاء appsscript.json
وCode.gs
، وهي قاعدة لمشروع "برمجة تطبيقات Google".
لاستخدام TypeScript في ملف "برمجة تطبيقات Google"، ما عليك سوى إعادة تسمية امتداد الملف من
gs
إلى ts
.
تعديل ملفات TypeScript المحلية
باستخدام المحرِّر المفضّل لديك، يمكنك كتابة ملفات TypeScript محلية كملفات .ts
في مجلد المشروع.
على سبيل المثال، يمكن أن يتضمّن ملف باسم index.ts
رمز TypeScript التالي:
const greeter = (person: string) => {
return `Hello, ${person}!`;
}
let user = 'Grant';
Logger.log(greeter(user));
يمكنك كتابة TypeScript باستخدام ميزات ES6 والإصدارات الأحدث، مثل
دوال الأسهم
واستيفاء السلسلة (${var}
). ويتم تحويل هذه الملفات إلى بُنى "برمجة التطبيقات"
عند إرسال المشروع إلى خادم "برمجة التطبيقات".
تحميل مشروع "برمجة تطبيقات Google" محلي يستخدم TypeScript
عند الانتهاء من تعديل ملفات TypeScript وبرمجة التطبيقات المحلية، يمكنك تحميل الملفات المحلية إلى Google Drive باستخدام الأمر clasp
التالي:
clasp push --watch
يرصد هذا الأمر التغييرات في ملف TypeScript ويستخدم typescript
لتجميع الرمز وclasp
لتحميل المشروع إلى Google Drive.
الإبلاغ عن مشاكل أو طلب ميزة ملف
إذا واجهت مشكلة في أداة clasp
، يمكنك الإبلاغ عنها من خلال GitHub.
إذا واجهت مشكلة أو خللاً في TypeScript نفسها، يمكنك الإبلاغ عنه في مستودع GitHub الخاص بـ TypeScript.