برای توسعه و مدیریت پروژههای اسکریپت گوگل اپس از طریق ترمینال خود به جای ویرایشگر اسکریپت اپس، از ابزار متنباز clasp استفاده کنید.
آزمایشگاه کد clasp ، مروری کلی بر تمام ویژگیهای clasp ارائه میدهد.
clasp شامل ویژگیهای زیر است:
clasp به شما امکان میدهد پروژههای Apps Script خود را به صورت محلی توسعه دهید. کد را روی رایانه خود بنویسید و پس از اتمام، آن را در Apps Script آپلود کنید. همچنین میتوانید پروژههای Apps Script موجود را دانلود کنید تا آنها را به صورت آفلاین ویرایش کنید. هنگام ساخت پروژههای Apps Script از ابزارهای توسعه مورد علاقه خود مانند git استفاده کنید.
چندین نسخه از پروژه خود را ایجاد، بهروزرسانی و مشاهده کنید.
clasp به شما امکان میدهد کدهای خود را در دایرکتوریهایی سازماندهی کنید که هنگام آپلود آنها در script.google.com حفظ میشوند. برای مثال:
# On script.google.com: ├── tests/slides.gs └── tests/sheets.gs # Locally: ├── tests/ │ ├─ slides.gs │ └─ sheets.gs
شما میتوانید از clasp برای مدیریت پروژههای اسکریپت مستقل و پروژههای اسکریپت وابسته به کانتینر استفاده کنید.
یک پروژه مستقل به عنوان یک فایل جداگانه در گوگل درایو شما ظاهر میشود. میتوانید با استفاده از دستور clasp create یک اسکریپت مستقل جدید ایجاد کنید.
یک پروژه متصل به کانتینر به یک فایل Google Docs، Sheets، Slides یا Google Forms متصل میشود. میتوانید با استفاده از دستور clasp create یک اسکریپت متصل به کانتینر جدید ایجاد کنید که به یک فایل جدید متصل شده باشد. همچنین میتوانید با استفاده از پرچم --parentId یک اسکریپت جدید را به یک فایل موجود متصل کنید.
clasp همچنین از ایجاد اسکریپت برای برنامههای وب و APIها پشتیبانی میکند.
clasp با Node.js نوشته شده و با استفاده از ابزار npm توزیع شده است. قبل از استفاده از clasp ، باید Node.js نسخه 20.0.0 یا بالاتر را نصب کرده باشید. نصب Node.js نیاز به دسترسی ادمین دارد.
پس از نصب Node.js، از دستور npm زیر برای نصب clasp استفاده کنید:
npm install @google/clasp -g
پس از نصب، از دستور clasp در هر دایرکتوری روی رایانه خود استفاده کنید.
clasp استفاده کنید clasp برای انجام وظایف مختلف از خط فرمان استفاده کنید. این بخش عملیات رایج مورد استفاده هنگام توسعه با clasp را شرح میدهد.
این دستور به حساب کاربری گوگل شما وارد میشود و مدیریت پروژههای Apps Script را مجاز میکند. پس از اجرا، از شما خواسته میشود وارد حساب گوگلی شوید که پروژههای Apps Script شما در آن ذخیره شدهاند.
clasp login
این دستور از ابزار خط فرمان خارج میشود. قبل از ادامه استفاده clasp دوباره با استفاده clasp login وارد سیستم شوید تا دوباره با گوگل احراز هویت شوید.
clasp logout
این دستور یک اسکریپت جدید در دایرکتوری فعلی با عنوان اسکریپت اختیاری ایجاد میکند.
clasp create [scriptTitle] [--type <projectType>] [--parentId <parentId>]
این دستور از پارامترهای اختیاری زیر استفاده میکند:
-
scriptTitle: عنوان پروژه اسکریپت. -
--type <projectType>: نوع پروژهای که باید ایجاد شود. مقادیر مجاز عبارتند ازstandalone،docs،sheets،slides،forms،webappوapi. -
--parentId <parentId>: شناسه فایل موجود در گوگل درایو (اسناد، برگهها، اسلایدها یا فرمها) که پروژه اسکریپت جدید باید به آن متصل شود.
این دستور همچنین دو فایل در دایرکتوری فعلی ایجاد میکند:
- یک فایل
.clasp.jsonکه شناسه اسکریپت را ذخیره میکند. - یک فایل مانیفست پروژه
appsscript.jsonکه شامل فرادادههای پروژه است.
این دستور یک پروژه موجود در دایرکتوری فعلی را کپی میکند. اسکریپت باید با حساب گوگل شما ایجاد یا به اشتراک گذاشته شود. شما با ارائه شناسه اسکریپت، پروژه اسکریپت مورد نظر برای کپی کردن را مشخص میکنید. میتوانید هم پروژههای مستقل و هم پروژههای متصل به کانتینر را کپی کنید.
برای پیدا کردن شناسه اسکریپت پروژه:
- پروژه Apps Script را باز کنید.
- در سمت چپ، روی پروژه کلیک کنید.
در قسمت شناسهها ، شناسه اسکریپت را کپی کنید.
کلون قلاب