تطوير برمجة التطبيقات باستخدام TypeScript

TypeScript هي مجموعة شاملة مكتوبة من لغة JavaScript يمكن تجميعها إلى لغة برمجة تطبيقات عادية. عند استخدام TypeScript في تطوير مشروع لبرمجة التطبيقات، ستحصل على المزايا التالية:

يتناول هذا الدليل بعض المهام الشائعة لتطوير مشروع "برمجة تطبيقات Google" باستخدام TypeScript.

المتطلّبات

إذا لم تكن معتادًا على استخدام TypeScript، يُرجى مراجعة وثائق النوع والبدء السريع لـ TypeScript للتعرف على المفاهيم الأساسية قبل محاولة تنفيذ أي من الإجراءات الموضحة في هذا الدليل.

الأدوات التالية مطلوبة لاستخدام TypeScript في مشاريع برمجة التطبيقات مع clasp. على الرغم من أن استخدام clasp ليس ضروريًا بشكل صارم لتفعيل استخدام TypeScript في لغة برمجة التطبيقات، إلا أنه يُنصح به بشدة لأنه يبسط الإجراءات إلى حد كبير.

قبل محاولة تنفيذ أي من العمليات الموضَّحة أدناه، تأكَّد من تثبيت ما يلي لتفعيل بيئة التطوير المحلية:

احرص على الاطّلاع على مستندات 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.