שימוש בממשק שורת הפקודה עם clasp

כדי לפתח ולנהל פרויקטים של Google Apps Script מהטרמינל ולא מהכלי לעריכת סקריפטים של Apps Script, אפשר להשתמש בכלי clasp בקוד פתוח.

ב-clasp codelab יש סקירה כללית של כל התכונות של clasp.

תכונות

‫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 כדי לנהל פרויקטים של סקריפטים עצמאיים ופרויקטים של סקריפטים שמשויכים למאגר.

פרויקטים עצמאיים

פרויקט עצמאי מופיע כקובץ נפרד ב-Google Drive. אפשר ליצור סקריפט חדש ועצמאי באמצעות הפקודה clasp create.

פרויקטים שמשויכים למאגר

פרויקט שקשור למאגר נתונים מצורף לקובץ ב-Google Docs, ב-Sheets, ב-Slides או ב-Google Forms. אפשר ליצור סקריפט חדש שמשויך לקובץ חדש באמצעות הפקודה clasp create. אפשר גם לצרף סקריפט חדש לקובץ קיים באמצעות הדגל --parentId.

סוגי פרויקטים אחרים

‫clasp תומך גם ביצירת סקריפטים לאפליקציות ולאתרי אינטרנט.

דרישות

‫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 בחשבון Google שלכם. אחרי שמריצים אותו, מתבקשים להיכנס לחשבון Google שבו מאוחסנים פרויקטים של Apps Script.

clasp login

יציאה

פקודה זו מוציאה אתכם מכלי שורת הפקודה. צריך להתחבר מחדש באמצעות clasp login כדי לבצע אימות מחדש ב-Google לפני שממשיכים להשתמש ב-clasp.

clasp logout

יצירת פרויקט חדש ב-Apps Script

הפקודה הזו יוצרת סקריפט חדש בספרייה הנוכחית עם שם סקריפט אופציונלי.

clasp create [scriptTitle] [--type <projectType>] [--parentId <parentId>]

הפקודה הזו כוללת את הפרמטרים האופציונליים הבאים:

  • ‫scriptTitle: השם של פרויקט ה-Apps Script.
  • ‫--type <projectType>: סוג הפרויקט שרוצים ליצור. הערכים המותרים הם standalone,‏ docs,‏ sheets,‏ slides,‏ forms,‏ webapp ו-api.
  • ‫--parentId <parentId>: המזהה של הקובץ הקיים ב-Google Drive (Docs,‏ Sheets,‏ Slides או Forms) שאליו צריך לקשר את פרויקט הסקריפט החדש.

הפקודה הזו יוצרת גם שני קבצים בספרייה הנוכחית:

  • קובץ .clasp.json שבו מאוחסן מזהה הסקריפט.
  • קובץ מניפסט של פרויקט appsscript.json שמכיל מטא-נתונים של הפרויקט.

שכפול פרויקט קיים

הפקודה הזו משכפלת פרויקט קיים בספרייה הנוכחית. הסקריפט צריך להיות משותף עם חשבון Google שלכם או שאתם צריכים ליצור אותו בעצמכם. מציינים את פרויקט הסקריפט לשכפול על ידי הזנת מזהה הסקריפט. אפשר לשכפל פרויקטים עצמאיים ופרויקטים שמשויכים למאגר תגים.

כדי למצוא את מזהה הסקריפט של הפרויקט:

  1. פותחים את פרויקט Apps Script.
  2. בצד ימין, לוחצים על הגדרות הפרויקט .

  3. בקטע מזהים, מעתיקים את מזהה הסקריפט.

    שכפול של אבזם