פיתוח מקומי

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

‫dscc-gen הוא כלי שנועד לטפל במשימות חוזרות כאלה, כדי שתוכלו להתמקד בפתרון הבעיה העסקית במקום בשגיאות שאפשר להימנע מהן באמצעות אוטומציה.

דרישות

שימוש ב-dscc-gen

dscc-gen יכול ליצור פרויקטים חדשים של מחברים לקהילה או לשמש עם פרויקטים קיימים.

מחברים קיימים

אפשר להשתמש ב-dscc-gen גם בפרויקטים קיימים. קודם כל, מעתיקים את scriptId, ואז מריצים את הפקודה הבאה (מחליפים את YOUR_SCRIPT_ID ב-scriptId):

npx @google/dscc-gen connector --script_id YOUR_SCRIPT_ID

תתבקשו לציין כמה פרטים לגבי המחבר. אם עדיין אין לכם פריסה בשם Production, אנחנו ניצור אותה בשבילכם. אף אחד מהקודים הקיימים לא ישתנה, אבל תהיה לכם גישה לכל מה ש-dscc-gen יכול לעשות.

מחברים חדשים

כדי ליצור מחבר חדש לקהילה באמצעות dscc-gen, מריצים את הפקודה הבאה:

npx @google/dscc-gen connector

תתבקשו לציין כמה פרטים לגבי מחבר חדש. משתמשים חדשים יתבקשו לבצע אימות clasp. ‫clasp הוא כלי ליצירה ולשינוי של פרויקטים של Apps Script משורת הפקודה.

אחרי שממלאים את ההנחיות, dscc-gen יוצר פרויקט חדש ב-Apps Script ומדפיס את כל מה שהוא יכול לעשות.

מה אפליקציית dscc-gen יכולה לעשות

פקודה תיאור
npm run open פותחים את הפרויקט ב-Apps Script.
npm run push מעבירים את השינויים המקומיים ל-Apps Script.
npm run watch לעקוב אחרי שינויים מקומיים ולדחוף אותם ל-Apps Script.
npm run prettier מעצבים את הקוד לפי הסטנדרטים של הקהילה.
npm run try_latest פותחים את הפריסה עם הקוד העדכני ב-Data Studio.
npm run try_production פותחים את פריסת הייצור ב-Data Studio.
npm run update_production מעדכנים את פריסת הייצור כדי להשתמש בקוד העדכני.

איך משתמשים בו?

השימוש בתכונות dscc-gen בדרך כלל נראה כך:

  1. מזהים תכונה שרוצים להוסיף למחבר.
  2. מריצים את הפקודה npm run watch כדי שהשינויים המקומיים יידחפו ל-Apps Script.
  3. מבצעים את השינויים בקוד באמצעות עורך JavaScript המועדף.
  4. מריצים את הפקודה npm run tryLatest ומוודאים שהתכונה החדשה פועלת כמצופה.
  5. מריצים את הפקודה npm run updateProduction כדי לעדכן את פריסת הייצור כך שתכלול את התכונה החדשה.
  6. מריצים את npm run tryProduction ומוודאים שהתכונה החדשה פועלת.

איך מוצאים את מזהה הסקריפט

כדי לקבל את scriptId, עוברים לפרויקט הקיים ומעתיקים את החלק של כתובת ה-URL אחרי /d/ ולפני /edit. לדוגמה: כתובת ה-URL הבאה:

  • כתובת URL מקורית: https://script.google.com/a/google.com/d/example-script-id/edit
  • מזהה הסקריפט: example-script-id