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