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

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

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

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

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

    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.