ממשק שורת פקודה עם אבזם

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

clasp logout

יצירה של פרויקט סקריפט חדש של אפליקציה

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

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. גרסה היא "snapshot&ציטוט; של פרויקט סקריפט, והיא דומה לגרסה של גרסה לקריאה בלבד.

clasp version [description]

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

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

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

clasp redeploy <deploymentId> <version> <description>

פריסות של רשימות

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

clasp deployments

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

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

clasp open

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

הוספת תוכן ל-clasp ב-GitHub.