TypeScript یک مجموعه بزرگ از جاوا اسکریپت است که میتواند به Apps Script ساده کامپایل شود. وقتی از TypeScript در توسعه یک پروژه Apps Script استفاده میکنید، مزایای زیر را به دست میآورید:
- تکمیل خودکار IDE محلی
- تایپ ساختاری اختیاری
- استنتاج نوع ، رابطها
- ویژگیهای ES6 مانند کلاسها و توابع arrow .
این راهنما برخی از وظایف رایج برای توسعه یک پروژه Apps Script با TypeScript را پوشش میدهد.
الزامات
اگر با TypeScript آشنا نیستید، قبل از انجام هر یک از مراحل شرح داده شده در این راهنما، مستندات TypeScript و راهنمای سریع TypeScript را مرور کنید تا با مفاهیم اولیه آشنا شوید.
ابزارهای زیر برای استفاده از TypeScript در پروژههای Apps Script با clasp مورد نیاز هستند. اگرچه استفاده از clasp برای فعال کردن استفاده از TypeScript در Apps Script کاملاً ضروری نیست، اما اکیداً توصیه میشود زیرا رویهها را تا حد زیادی ساده میکند.
قبل از انجام هر یک از فرآیندهای شرح داده شده در زیر، مطمئن شوید که موارد زیر را برای فعال کردن محیط توسعه محلی خود نصب کردهاید:
- گره و npm
-
clasp:npm install -g @google/clasp - تعریف نوع برای Apps Script :
npm i -S @types/google-apps-script - ویژوال استودیو کد (برای تکمیل خودکار TypeScript IDE)
اگر قبلاً clasp استفاده نکردهاید، حتماً با مستندات clasp آشنا شوید.
استفاده از TypeScript در یک پروژه Clasp
شما میتوانید clasp برای ایجاد سریع یک پروژه محلی جدید Apps Script استفاده کنید. این دستور یک 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+ مانند توابع arrow و میانیابی رشته ( ${var} ) بنویسید. این فایلها هنگام ارسال پروژه به سرور Apps Script به ساختارهای Apps Script منتقل میشوند.
یک پروژه محلی Apps Script که از TypeScript استفاده میکند را آپلود کنید
وقتی ویرایش فایلهای محلی TypeScript و Apps Script را تمام کردید، میتوانید فایلهای محلی را با استفاده از دستور clasp زیر در Google Drive آپلود کنید:
clasp push --watch
این دستور تغییرات فایل TypeScript را زیر نظر میگیرد و از typescript برای کامپایل کد و clasp برای آپلود پروژه در Google Drive استفاده میکند.
گزارش مشکلات یا ثبت درخواست ویژگی
اگر با ابزار clasp به مشکلی برخوردید، میتوانید آن را در GitHub گزارش دهید.
اگر با خود TypeScript با مشکل یا باگی مواجه شدید، میتوانید آن را در مخزن GitHub TypeScript گزارش دهید.