כדי לפתח ולנהל פרויקטים של 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.
- בצד ימין, לוחצים על Project Settings (הגדרות הפרויקט) .
בקטע 'מזהים', מעתיקים את מזהה הסקריפט.
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. Editor מופעל ככרטיסייה חדשה בדפדפן האינטרנט שמוגדר כברירת מחדל.
clasp open
לתרום תוכן לפרויקט הקוד הפתוח של clasp
תוכלו לתרום ל-clasp
ב-GitHub.