חשוב לבדוק תוספים באופן יסודי לפני הפרסום כדי לוודא שהם פועלים כמתוכנן. באמצעות Apps Script תוכלו לבדוק תוספים לעריכה בפיתוח של קבצים ספציפיים ב-Google Docs Sheets, Forms ו-Slides. אפשר להשתמש בו כדי:
- מוודאים שתוסף שנכתב בסקריפט עצמאי פועל באופן תקין כשמחילים אותו בגיליון, במסמך, במצגת או בטופס.
- ודאו שתהליך ההתקנה של התוסף פועל כמצופה, במיוחד למצבים שונים של מחזור החיים הראשוני של ההרשאות (מותקנים, מופעלים או שניהם).
- מוודאים שהתוסף פועל כמצופה כשהוא פועל על מסמך מסוים והתוכן שלו.
- בדיקה והשוואה של הגרסה הנוכחית והגרסאות הקודמות של התוסף.
יצירה של פריסת בדיקה
פריסת בדיקה היא שילוב של תוסף ומסמך לבדיקה. אחרי שמפתחים גרסת סקריפט ורוצים לבדוק אותה כתוסף:
- אם אין לך עדיין חשבון, צריך ליצור גיליון אלקטרוני, מסמך, מצגת או טופס כדי לבדוק את התוסף.
- פותחים את פרויקט הסקריפט שמכיל את התוסף.
- לוחצים על פריסה > בדיקת פריסות.
- ליד בחירת סוג, לוחצים על 'הפעלת סוגי פריסה' ובוחרים באפשרות תוסף עריכה.
- לוחצים על יצירת בדיקה חדשה או על הוספת בדיקה.
- בוחרים גרסת קוד או בוחרים באפשרות הקוד האחרון.
- בקטע Config (הגדרה), בוחרים את מצב ההרשאה הראשוני לבדיקה.
- בקטע מסמך בדיקה, לוחצים על לא נבחר מסמך. בוחרים את הקובץ ב-Sheets, ב-Docs, ב-Slides או ב-Forms שבו רוצים להשתמש כדי לבדוק את התוסף, ולוחצים על הוספה.
- לוחצים על שמירת הבדיקה.
כל הפריסות השמורות לבדיקה מופיעות בתיבת הדו-שיח בדיקת פריסות. כך תוכלו לחזור על אותה פריסת בדיקה בשלב מאוחר יותר.
הרצת בדיקה של הפריסה
אם יש לכם פריסת בדיקה שמורה אחת או יותר, תוכלו להריץ אחת מהן באמצעות הפעולות הבאות:
- פותחים את פרויקט הסקריפט שמכיל את התוסף.
- לוחצים על פריסה > בדיקת פריסות.
- בקטע Saved Tests, לוחצים על לחצן הבחירה שלצד פריסת הבדיקה השמורה שרוצים להפעיל ולוחצים על Execute.
מסמך הבדיקה ייפתח בכרטיסייה חדשה. התוסף נמצא במצב ההרשאה שצוין בפריסה לבדיקה. כדי לוודא שהתוסף פועל באופן מכוון, אפשר לעשות זאת על ידי אינטראקציה עם רכיבי התפריט ורכיבי ממשק המשתמש שלו.
פרטי הבדיקה
יש כמה דברים שחשוב לזכור כשבודקים תוספים של Editor באופן הזה:
- במהלך הבדיקה אין תמיכה בטריגרים שניתנים להתקנה. לא ניתן לבדוק את הפונקציונליות שתלויה בטריגרים שניתנים להתקנה.
- בזמן הרצה של פריסת בדיקה שמוגדרת לבדיקה עם הקוד העדכני ביותר, אפשר לרענן את מסמך הבדיקה כדי לראות את השינויים שנשמרו בסקריפט של התוסף.
- למסמך הבדיקה יש כתובת URL שאותה אפשר לשתף עם העורכים של מסמך הבדיקה המקורי. כך קל יותר לשתף פעולה עם אחרים בזמן הבדיקה והפיתוח.
- אם התוסף משתמש בשירות Properties, המאפיינים נשארים זמינים ונשארים זמינים בפעם הבאה שפריסת הבדיקה תרוץ.
- בנוסף, בכל פריסת בדיקה עם אותו שילוב של תוסף ומסמך בדיקה יש גישה לאותם פרטי נכס. לדוגמה, אם יוצרים שתי פריסות לבדיקה, המאפיינים שנשמרים בזמן הפעלת התוסף הראשון יהיו זמינים כשמפעילים את השנייה ולהיפך, אבל רק אם בפריסות נעשה שימוש באותו סקריפט ובאותו מסמך בדיקה.
- אם אתם מריצים פריסת בדיקה, יכול להיות שתתבקשו להעניק הרשאה אם לא הפעלתם את הסקריפט בעבר. חשוב לזכור שמתן הרשאה לסקריפט בזמן הבדיקה נותן הרשאה לסקריפט גם מחוץ לבדיקה.