בדיקת תוסף לעריכה

מומלץ לבדוק היטב את התוספים לפני הפרסום שלהם, כדי לוודא שהם פועלים כמצופה. באמצעות Apps Script אפשר לבדוק תוספים לעורך שנמצאים בפיתוח בקבצים ספציפיים של Google Docs, ‏ Sheets, ‏ Forms או Slides. אפשר להשתמש באפשרות הזו כדי:

  • מוודאים שתוסף שנכתב בסקריפט עצמאי פועל כמצופה כשמחילים אותו על גיליון, מסמך, מצגת או טופס.
  • מוודאים שתהליך התקנת התוסף פועל כמצופה, במיוחד במצבים שונים של מחזור החיים של ההרשאה (מותקן, מופעל או שניהם).
  • מוודאים שהתוסף פועל כמצופה כשמבצעים פעולות במסמך מסוים ובתוכן שלו.
  • לבדוק ולהשוות בין הגרסה הנוכחית לבין הגרסה הקודמת של התוסף.

יצירת פריסה לבדיקה

פריסת בדיקה היא שילוב של תוסף ומסמך בדיקה. אחרי שפיתחתם גרסה של סקריפט ואתם רוצים לבדוק אותה כתוסף, עליכם לפעול לפי השלבים הבאים:

  1. אם עדיין אין לכם, יוצרים גיליון אלקטרוני, מסמך, מצגת או טופס כדי לבדוק את התוסף.
  2. פותחים את פרויקט הסקריפט שמכיל את התוסף.
  3. לוחצים על פריסה > בדיקת הפריסות.
  4. לצד בחירת סוג, לוחצים על 'הפעלת סוגי פריסה' ובוחרים באפשרות תוסף של עורך.
  5. לוחצים על Create new test (יצירת בדיקה חדשה) או על Add test (הוספת בדיקה).
  6. בוחרים גרסה של קוד או בוחרים באפשרות Latest Code (הקוד העדכני ביותר).
  7. בקטע Config, בוחרים את מצב ההרשאה הראשוני לבדיקה.
  8. בקטע מסמך לבדיקה, לוחצים על לא נבחר מסמך. בוחרים את הקובץ ב-Sheets, ב-Docs, ב-Slides או ב-Forms שבו רוצים להשתמש כדי לבדוק את התוסף, ולוחצים על הוספה.
  9. לוחצים על שמירת המבחן.

כל פריסות הבדיקה השמורות מופיעות בתיבת הדו-שיח Test deployments. כך תוכלו לחזור לאותה פריסה לבדיקה מאוחר יותר.

הרצת פריסה לבדיקה

אם יש לכם פריסה אחת או יותר של בדיקה שנשמרה, תוכלו להריץ אחת מהן באופן הבא:

  1. פותחים את פרויקט הסקריפט שמכיל את התוסף.
  2. לוחצים על פריסה > בדיקת הפריסות.
  3. בקטע Saved Tests, בוחרים בלחצן הבחירה לצד פריסת הבדיקה השמורה שרוצים להריץ ולוחצים על Execute.

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

פרטי הבדיקה

יש כמה דברים שכדאי לזכור כשבודקים תוספים ל-Editor בדרך הזו:

  • אי אפשר להשתמש בטריגרים שניתן להתקין במהלך הבדיקה. אי אפשר לבדוק פונקציונליות שמבוססת על טריגרים שניתן להתקין.
  • כשמריצים פריסה לבדיקה שמוגדרת לבדיקה עם הקוד העדכני ביותר, אפשר לראות את השינויים שנשמרו בסקריפט של התוסף על ידי רענון מסמך הבדיקה.
  • למסמך הבדיקה יש כתובת URL שאפשר לשתף עם עורכי מסמך הבדיקה המקורי. כך תוכלו לשתף פעולה בקלות רבה יותר עם אחרים בזמן הבדיקה והפיתוח.
  • אם התוסף משתמש בשירות המאפיינים, המאפיינים נשמרים ויישארו זמינים בפעם הבאה שתפעילו את פריסת הבדיקה.
  • בנוסף, לכל פריסה של בדיקה שמשתמשת באותה שילוב של תוסף ומסמך בדיקה יש גישה לאותו מידע על הנכס. לדוגמה, אם יוצרים שתי פריסות לבדיקה, המאפיינים שנשמרו במהלך הפעלת הפריסה הראשונה יהיו זמינים במהלך הפעלת הפריסה השנייה, ולהפך, אבל רק אם בפריסות נעשה שימוש באותו סקריפט ובאותו מסמך בדיקה.
  • אם מריצים פריסה לבדיקה, יכול להיות שתופיע בקשה לאישור אם לא הפעילתם את הסקריפט בעבר. חשוב לזכור שאישור סקריפט במהלך בדיקה מאשר אותו גם מחוץ לבדיקה.