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

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

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

  1. פותחים את פרויקט Apps Script.
  2. בצד ימין, לוחצים על הגדרות הפרויקט .
  3. מעתיקים את מזהה הסקריפט בקטע 'מזהים'.

     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.