از رابط خط فرمان با clasp استفاده کنید

برای توسعه و مدیریت پروژه های 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 شما به اشتراک گذاشته شود. شما پروژه اسکریپت را برای شبیه سازی با ارائه شناسه اسکریپت آن مشخص می کنید.

برای یافتن شناسه اسکریپت پروژه، مراحل زیر را دنبال کنید:

  1. پروژه Apps Script را باز کنید.
  2. در سمت چپ، روی تنظیمات پروژه کلیک کنید.
  3. در قسمت شناسه ها، شناسه اسکریپت را کپی کنید.

     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 مشارکت کنید.