TypeScript هي مجموعة فرعية مكتوبة من JavaScript يمكن تجميعها في "برمجة التطبيقات" العادية. عند استخدام TypeScript في تطوير مشروع Apps Script، يمكنك الاستفادة من المزايا التالية:
- الإكمال التلقائي في بيئة التطوير المتكاملة المحلية
- الكتابة البنيوية الاختيارية
- استنتاج النوع،الواجهات
- ميزات ES6، مثل الفئات و الدوال السهمية
يتناول هذا الدليل بعض المهام الشائعة لتطوير مشروع "برمجة تطبيقات Google" باستخدام TypeScript.
المتطلبات
إذا لم تكن على دراية بلغة TypeScript، راجِع مستندات TypeScript والبدء السريع في TypeScript للتعرّف على المفاهيم الأساسية قبل محاولة تنفيذ أي من الإجراءات الموضّحة في هذا الدليل.
يجب توفّر الأدوات التالية لاستخدام TypeScript في مشاريع "برمجة التطبيقات" مع clasp. مع أنّ استخدام clasp ليس ضروريًا
لإتاحة استخدام TypeScript في "برمجة تطبيقات Google"، ننصحك بشدة
باستخدامه لأنّه يسهّل الإجراءات إلى حدّ كبير.
قبل محاولة تنفيذ أي من العمليات الموضّحة أدناه، تأكَّد من تثبيت ما يلي لتفعيل بيئة التطوير المحلية:
- 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، وهما أساس مشروع في "برمجة تطبيقات Google".
لاستخدام 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}). يتم تحويل هذه الملفات إلى بنى Apps Script
عند إرسال المشروع إلى خادم Apps Script.
تحميل مشروع "برمجة تطبيقات Google" محلي يستخدم TypeScript
عند الانتهاء من تعديل ملفات TypeScript وApps Script المحلية، يمكنك تحميل الملفات المحلية إلى Google Drive باستخدام الأمر التالي: clasp
clasp push --watch
يراقب هذا الأمر التغييرات التي تطرأ على ملفات TypeScript ويستخدم typescript لتجميع الرمز وclasp لتحميل المشروع إلى Google Drive.
الإبلاغ عن مشاكل أو طلب ميزة
إذا واجهت مشكلة في أداة clasp، يمكنك الإبلاغ عنها على
GitHub.
إذا واجهت مشكلة أو خطأ في TypeScript نفسها، يمكنك الإبلاغ عنه في مستودع GitHub الخاص بـ TypeScript.