שימוש בממשק שורת הפקודה עם 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. בקטע מזהים, מעתיקים את מזהה הסקריפט.

   שכפול של אבזם

הורדת פרויקט של סקריפט

הפקודה הזו מורידה את פרויקט Apps Script מ-Google Drive למערכת הקבצים במחשב.

clasp pull

העלאת פרויקט סקריפט

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

clasp push

הצגת רשימה של גרסאות הפרויקט

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

clasp versions

פריסת פרויקט שפורסם

פריסת פרויקטים של סקריפטים כאפליקציות אינטרנט, כתוספים ל-Google Workspace או כקבצים הפעלה. יוצרים פריסות בכלי לעריכת סקריפטים, במניפסט של הפרויקט או באמצעות clasp.

כדי לפרוס פרויקט באמצעות clasp, קודם צריך ליצור גרסה שלא ניתן לשנות של פרויקט Apps Script. גרסה היא "תמונת מצב" של פרויקט Script, והיא דומה לגרסה מסועפת לקריאה בלבד.

clasp version [description]

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

clasp deploy [version] [description]
clasp undeploy <deploymentId>

הפקודה הזו מעדכנת פריסה קיימת עם גרסה ותיאור חדשים:

clasp redeploy <deploymentId> <version> <description>

הצגת רשימת הפריסות

הפקודה הזו מציגה את מזהי הפריסה, הגרסאות והתיאורים שלהם בפרויקט הסקריפט.

clasp deployments

פתיחת הפרויקט בכלי לעריכת Apps Script

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

clasp open-script

תרומה לפרויקט הקוד הפתוח clasp

אתם מוזמנים לתרום ל-clasp ב-GitHub.