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

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

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

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

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

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

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

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

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

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

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

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

פרטי הבדיקה

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

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