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

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

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

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

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

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

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

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

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

1. פותחים את פרויקט הסקריפט שמכיל את התוסף.
2. לוחצים על Deploy (פריסה) > Test installations (בדיקת פריסות).
3. בקטע בדיקות שמורות, לוחצים על לחצן הבחירה לצד הבדיקה שנשמרה. הפריסה שרוצים להריץ, ולוחצים על Execute.

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

פרטי הבדיקה

יש כמה נקודות שכדאי לזכור במהלך הבדיקה של תוספי העריכה ככה:

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