חשוב לבדוק את התוספים בקפידה לפני הפרסום כדי לוודא שהם פועלים באופן הרצוי. באמצעות Apps Script תוכלו לבדוק תוספי עריכה בפיתוח בקבצים ספציפיים ב-Google Docs Sheets, ב-Forms או ב-Slides. אפשר להשתמש בזה כדי:
- חשוב לוודא שתוסף שכתוב בסקריפט נפרד פועל כמצופה כשמחילים אותו על גיליון, מסמך, מצגת או טופס.
- מוודאים שתהליך התקנת התוסף פועל כמצופה, במיוחד במצבים ראשוניים שונים של מחזור החיים של ההרשאה (מותקנים, מופעלים או שניהם).
- חשוב לוודא שהתוסף פועל כראוי בזמן פעולה על מסמך מסוים ועל התוכן שלו.
- לבדוק את הגרסה הנוכחית ואת הגרסה הקודמת של התוסף ולהשוות ביניהן.
יצירת פריסה לבדיקה
פריסת בדיקה היא שילוב של תוסף ומסמך בדיקה. אחרי שפיתחתם גרסת סקריפט ואתם רוצים לבדוק אותה כתוסף, פועלים לפי השלבים הבאים:
- אם עדיין לא עשיתם זאת, צריך ליצור גיליון אלקטרוני, מסמך, מצגת או טופס כדי לבדוק את התוסף.
- פותחים את פרויקט הסקריפט שמכיל את התוסף.
- לוחצים על Deploy (פריסה) > Test installations (בדיקת פריסות).
- ליד Select type, לוחצים על EnableDeploy types (הפעלת סוגי פריסה) ובוחרים באפשרות Editor Add-on (תוסף עריכה).
- לוחצים על יצירת בדיקה חדשה או על הוספת בדיקה.
- בוחרים גרסת קוד או בוחרים באפשרות הקוד האחרון.
- בקטע תצורה, בוחרים את מצב ההרשאה הראשוני לבדיקה.
- בקטע מסמך בדיקה, לוחצים על לא נבחר מסמך. בוחרים את הקובץ ב-Sheets, ב-Docs, ב-Slides או ב-Forms שבו רוצים לבדוק את התוסף, ולוחצים על Insert.
- לוחצים על שמירת הבדיקה.
כל פריסות הבדיקה השמורות מופיעות בתיבת הדו-שיח בדיקת פריסות. כך תוכלו לחזור לאותה פריסה לבדיקה מאוחר יותר.
הרצת פריסה לבדיקה
אם יש לכם לפחות פריסת בדיקה שמורה אחת, אפשר להריץ אחת מהן באופן הבא:
- פותחים את פרויקט הסקריפט שמכיל את התוסף.
- לוחצים על Deploy (פריסה) > Test installations (בדיקת פריסות).
- בקטע Saved Tests, לוחצים על לחצן הבחירה ליד פריסת הבדיקה השמורה שרוצים להריץ ולוחצים על Execute.
מסמך הבדיקה ייפתח בכרטיסייה חדשה. התוסף נמצא במצב ההרשאה שצוין בפריסה לבדיקה. תוכלו לוודא שהתוסף פועל כמו שצריך על ידי אינטראקציה עם התפריט ורכיבי ממשק המשתמש שלו.
פרטי הבדיקה
יש כמה נקודות שחשוב לזכור כשבודקים את תוספי העריכה באופן הזה:
- טריגרים שניתנים להתקנה לא נתמכים במהלך הבדיקה. אי אפשר לבדוק פונקציונליות שתלויה בטריגרים שניתנים להתקנה.
- כשמריצים פריסת בדיקה שמוגדרת לבדיקה עם הקוד העדכני ביותר, אפשר לרענן את מסמך הבדיקה כדי לראות את השינויים שנשמרו בסקריפט של התוסף.
- למסמך הבדיקה יש כתובת URL שאפשר לשתף עם העורכים של מסמך הבדיקה המקורי. כך תוכלו לשתף פעולה בקלות רבה יותר עם אחרים בזמן הבדיקה והפיתוח.
- אם התוסף משתמש בשירות 'מאפיינים', המאפיינים נשארים זמינים ונשארים זמינים בפעם הבאה שמפעילים את הפריסה לבדיקה.
- בנוסף, לכל פריסה לבדיקה שמשתמשת באותו שילוב של תוסף ומסמך בדיקה יש גישה לאותו מאפיין. לדוגמה, אם יוצרים שתי פריסות לבדיקה, המאפיינים שנשמרו בזמן הרצה של הראשון יהיו זמינים גם בהרצה השנייה ולהיפך, אבל רק אם הפריסות משתמשות באותו סקריפט ומסמך בדיקה.
- אם מריצים פריסת בדיקה, יכול להיות שתוצג בקשה להרשאה אם לא הרצתם את הסקריפט בעבר. שימו לב שהרשאה לסקריפט במהלך הבדיקה מאשרת גם את הסקריפט מחוץ לבדיקה.