برای توسعه و مدیریت پروژه های Apps Script از ترمینال خود به جای ویرایشگر Apps Script، می توانید از یک ابزار منبع باز به نام clasp استفاده کنید.
clasp codelab یک نمای کلی از تمام ویژگی های clasp ارائه می دهد.
ویژگی ها
به صورت محلی توسعه دهید
clasp به شما امکان می دهد پروژه های Apps Script خود را به صورت محلی توسعه دهید. می‌توانید روی رایانه شخصی خود کد بنویسید و پس از اتمام کار، آن را در Apps Script آپلود کنید. همچنین می‌توانید پروژه‌های Apps Script موجود را دانلود کنید تا بتوانید وقتی آفلاین هستید آنها را ویرایش کنید. از آنجایی که کد محلی است، می توانید از ابزارهای توسعه مورد علاقه خود مانند git هنگام ساخت پروژه های Apps Script استفاده کنید.
مدیریت نسخه های استقرار
چندین استقرار پروژه خود را ایجاد، به روز رسانی و مشاهده کنید.
کد ساختار
clasp به شما امکان می دهد کدهای خود را در دایرکتوری ها سازماندهی کنید، که وقتی آنها را در script.google.com آپلود می کنید حفظ می شوند. به عنوان مثال:
# On script.google.com: ├── tests/slides.gs └── tests/sheets.gs # Locally: ├── tests/ │ ├─ slides.gs │ └─ sheets.gs
الزامات
clasp در Node.js نوشته شده و از طریق ابزار npm توزیع می شود. قبل از استفاده از clasp ، باید Node.js نسخه 4.7.4 یا بالاتر را نصب کرده باشید. نصب Node.js به امتیازات مدیریتی نیاز دارد.
نصب و راه اندازی
هنگامی که Node.js را نصب کردید، می توانید از دستور npm زیر برای نصب clasp استفاده کنید:
npm install @google/clasp -g
پس از نصب، می توانید از دستور clasp از هر دایرکتوری در رایانه خود استفاده کنید.
با استفاده از clasp
شما می توانید از clasp برای انجام انواع وظایف از خط فرمان استفاده کنید. این بخش عملیات های رایجی را که می توانید هنگام توسعه با clasp استفاده کنید، توضیح می دهد.
وارد شوید
این فرمان به سیستم وارد می شود و مدیریت پروژه های Apps Script حساب Google شما را مجاز می کند. پس از اجرا، از شما خواسته می شود که به یک حساب Google وارد شوید که در آن پروژه های Apps Script شما ذخیره می شود.
clasp login
خروج از سیستم
این دستور از ابزار خط فرمان خارج می شود. قبل از ادامه استفاده از clasp باید دوباره با استفاده از clasp login برای احراز هویت مجدد با Google وارد شوید.
clasp logout
یک پروژه Apps Script جدید ایجاد کنید
این دستور یک اسکریپت جدید در فهرست فعلی با عنوان اسکریپت اختیاری ایجاد می کند.
clasp create [scriptTitle]
این دستور همچنین دو فایل را در دایرکتوری فعلی ایجاد می کند:
- یک فایل
.clasp.jsonکه شناسه اسکریپت را ذخیره می کند. - فایل مانیفست پروژه
appsscript.jsonحاوی فراداده پروژه.
یک پروژه موجود را شبیه سازی کنید
این دستور یک پروژه موجود در دایرکتوری فعلی را شبیه سازی می کند. اسکریپت باید ایجاد شود یا با حساب Google شما به اشتراک گذاشته شود. شما پروژه اسکریپت را برای شبیه سازی با ارائه شناسه اسکریپت آن مشخص می کنید.
برای یافتن شناسه اسکریپت پروژه، مراحل زیر را دنبال کنید:
- پروژه Apps Script را باز کنید.
- در سمت چپ، روی تنظیمات پروژه کلیک کنید.
در قسمت شناسه ها، شناسه اسکریپت را کپی کنید.
clasp clone <scriptId>
دانلود پروژه اسکریپت
این دستور پروژه Apps Script را از Google Drive به سیستم فایل رایانه شما دانلود می کند.
clasp pull
یک پروژه اسکریپت بارگذاری کنید
این دستور همه فایل های پروژه اسکریپت را از رایانه شما در Google Drive آپلود می کند.
clasp push
لیست نسخه های پروژه
این دستور تعداد و توضیحات هر یک از نسخه های پروژه اسکریپت را فهرست می کند.
clasp versions
استقرار یک پروژه منتشر شده
می‌توانید پروژه‌های اسکریپت را به‌عنوان برنامه‌های وب، افزونه‌ها یا فایل‌های اجرایی اجرا کنید. می‌توانید در ویرایشگر اسکریپت، در مانیفست پروژه یا با استفاده از clasp پیاده‌سازی ایجاد کنید.
برای استقرار یک پروژه با clasp ، ابتدا یک نسخه تغییرناپذیر از پروژه Apps Script ایجاد کنید. یک نسخه یک "عکس فوری" از یک پروژه اسکریپت است و شبیه به یک نسخه منشعب فقط خواندنی است.
clasp version [description]
این دستور شماره نسخه جدید ایجاد شده را نمایش می دهد. با استفاده از آن شماره، می‌توانید نمونه‌های پروژه خود را مستقر و بازگشایی کنید:
clasp deploy [version] [description]
clasp undeploy <deploymentId>
این دستور یک استقرار موجود را با یک نسخه و توضیحات جدید به روز می کند:
clasp redeploy <deploymentId> <version> <description>
فهرست استقرارها
این دستور شناسه های استقرار پروژه اسکریپت، نسخه ها و توضیحات آنها را فهرست می کند.
clasp deployments
پروژه را در ویرایشگر Apps Script باز کنید
این دستور یک پروژه اسکریپت را در ویرایشگر Apps Script باز می کند. ویرایشگر به عنوان یک برگه جدید در مرورگر وب پیش فرض شما راه اندازی می شود.
clasp open
در پروژه منبع باز clasp مشارکت کنید
در clasp در GitHub مشارکت کنید.