לפתח ולנהל פרויקטים של 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.
התחברות
פקודה זו מתחברת ומאשרת את הניהול של חשבון Google שלך פרויקטים ב-Apps Script. לאחר ההפעלה, תתבקש להיכנס לחשבון Google החשבון שבו מאוחסנים הפרויקטים שלך ב-Apps Script.
clasp login
יציאה
הפקודה הזו מתנתקת מכלי שורת הפקודה. עליך להתחבר מחדש באמצעות
clasp login כדי לבצע אימות מחדש מול Google לפני שממשיכים להשתמש ב-clasp.
clasp logout
יצירת פרויקט חדש ב-Apps Script
הפקודה הזו יוצרת סקריפט חדש בספרייה הנוכחית עם אפשרות כותרת התסריט.
clasp create [scriptTitle]
הפקודה הזו גם יוצרת שני קבצים בספרייה הנוכחית:
- קובץ
.clasp.jsonשמאחסן את מזהה הסקריפט. - קובץ מניפסט של פרויקט
appsscript.jsonשמכיל את המטא-נתונים של הפרויקט.
שכפול של פרויקט קיים
הפקודה הזו משכפלת פרויקט קיים בספרייה הנוכחית. התסריט צריך ליצור או לשתף אותם עם חשבון Google. אתם מציינים את הסקריפט לפרויקט לשכפול על ידי מתן מזהה הסקריפט שלו.
כדי למצוא את מזהה הסקריפט של הפרויקט, פועלים לפי השלבים הבאים:
- פותחים את פרויקט Apps Script.
- בצד ימין, לוחצים על הגדרות הפרויקט .
מעתיקים את מזהה הסקריפט בקטע 'מזהים'.
clasp clone <scriptId>
הורדת פרויקט סקריפט
פקודה זו מורידה את פרויקט Apps Script מ-Google Drive אל למערכת הקבצים במחשב.
clasp pull
העלאת פרויקט סקריפט
פקודה זו מעלה את כל הקבצים של פרויקט סקריפט מהמחשב שלך אל Google Drive.
clasp push
הצגת רשימה של גרסאות פרויקט
פקודה זו מפרטת את המספר והתיאור של כל אחד גרסאות שונות.
clasp versions
פריסה של פרויקט שפורסם
ניתן לפרוס פרויקטים של סקריפטים כאפליקציות אינטרנט, תוספים או קובצי הפעלה. אפשר
יוצרים פריסות בעורך הסקריפטים,
במניפסט הפרויקט, או באמצעות clasp.
כדי לפרוס פרויקט באמצעות clasp, קודם צריך ליצור גרסה שלא ניתנת לשינוי של האפליקציות
פרויקט סקריפט. גרסה היא "תמונת מצב" של פרויקט סקריפט שדומה ל-
גרסה הסתעפות לקריאה בלבד.
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.