TypeScript هي مجموعة شاملة من JavaScript يمكن تجميعها في "برمجة التطبيقات". عند استخدام TypeScript في تطوير مشروع Apps Script، ستستفيد من المزايا التالية:
- الإكمال التلقائي في بيئة التطوير المتكاملة المحلية
- الكتابة البنيوية الاختيارية
- استنتاج النوع، الواجهات
- ميزات ES6، مثل الفئات و الدوال السهمية
يتناول هذا الدليل بعض المهام الشائعة لتطوير مشروع "برمجة تطبيقات Google" باستخدام TypeScript.
المتطلبات
إذا لم تكن على دراية بلغة TypeScript، راجِع مستندات TypeScript والبدء السريع في TypeScript للتعرّف على المفاهيم الأساسية قبل محاولة تنفيذ أي من الإجراءات الموضّحة في هذا الدليل.
يجب توفّر الأدوات التالية لاستخدام TypeScript في مشاريع "برمجة التطبيقات" مع clasp. مع أنّ استخدام clasp ليس ضروريًا
تمامًا لتفعيل استخدام TypeScript في "برمجة التطبيقات"، ننصحك بشدة
باستخدامه لأنّه يسهّل الإجراءات بشكل كبير.
قبل محاولة تنفيذ أي من العمليات الموضّحة أدناه، تأكَّد من تثبيت ما يلي لتفعيل بيئة التطوير المحلية:
- Node وnpm
clasp:npm install -g @google/clasp- تعريفات الأنواع في Apps Script:
npm i -S @types/google-apps-script - Visual Studio Code (للإكمال التلقائي في بيئة تطوير متكاملة (IDE) للغة TypeScript)
ننصحك بالاطّلاع على clasp المستندات
إذا لم يسبق لك استخدام clasp.
استخدام TypeScript في مشروع Clasp
يمكنك استخدام clasp لإنشاء
مشروع جديد محلي في "برمجة تطبيقات Google" بسرعة.
ينشئ هذا الأمر appsscript.json وCode.gs، وهما أساس مشروع Apps Script.
لاستخدام TypeScript في ملف App Script، ما عليك سوى إعادة تسمية امتداد الملف من
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"
عند إرسال المشروع إلى خادم "برمجة تطبيقات Google".
تحميل مشروع "برمجة تطبيقات Google" محلي يستخدم TypeScript
عند الانتهاء من تعديل ملفات TypeScript وApps Script المحلية، يمكنك تحميل الملفات المحلية إلى Google Drive باستخدام الأمر التالي: clasp
clasp push --watch
يراقب هذا الأمر التغييرات التي تطرأ على ملفات TypeScript ويستخدم typescript لتجميع الرمز وclasp لتحميل المشروع إلى Google Drive.
الإبلاغ عن مشاكل أو طلب ميزات
إذا واجهت مشكلة في أداة clasp، يمكنك الإبلاغ عنها على GitHub.
إذا واجهت مشكلة أو خطأ في TypeScript نفسها، يمكنك الإبلاغ عنه في مستودع GitHub الخاص بـ TypeScript.