TypeScript یک ابر مجموعه تایپ شده از جاوا اسکریپت است که می تواند در Apps Script ساده کامپایل شود. وقتی از TypeScript در توسعه یک پروژه Apps Script استفاده می کنید، مزایای زیر را به دست می آورید:
- تکمیل خودکار IDE محلی
- تایپ ساختاری اختیاری
- نوع استنتاج ، رابط ها
- ویژگی‌های ES6 مانند کلاس‌ها و عملکردهای پیکان .
این راهنما برخی از وظایف رایج برای توسعه یک پروژه 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 - کد ویژوال استودیو (برای تکمیل خودکار IDE TypeScript)
اگر قبلاً 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+ مانند توابع پیکان و درون یابی رشته ای ( ${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 گزارش دهید.
خواندن مرتبط
،TypeScript یک ابر مجموعه تایپ شده از جاوا اسکریپت است که می تواند در Apps Script ساده کامپایل شود. وقتی از TypeScript در توسعه یک پروژه Apps Script استفاده می کنید، مزایای زیر را به دست می آورید:
- تکمیل خودکار IDE محلی
- تایپ ساختاری اختیاری
- نوع استنتاج ، رابط ها
- ویژگی‌های ES6 مانند کلاس‌ها و عملکردهای پیکان .
این راهنما برخی از وظایف رایج برای توسعه یک پروژه 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 - کد ویژوال استودیو (برای تکمیل خودکار IDE TypeScript)
اگر قبلاً 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+ مانند توابع پیکان و درون یابی رشته ای ( ${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 گزارش دهید.