בדיקה וניפוי באגים של תוספי Apps Script של Google Workspace

כשמפרסמים תוסף, המשתמשים יכולים להתקין אותו באמצעות האפליקציה המארחת או ב-Google Workspace Marketplace. לפני הפרסום, מומלץ לבדוק את שאתם מפתחים באפליקציות המארחות, הם נמשכים.

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

דרישות מוקדמות

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

איך מתקינים תוסף שלא פורסם

אפשר להתקין תוספים שלא פורסמו בפריסות של Apps Script

כדי להתקין קובץ שלא פורסם, יש לפעול לפי השלבים הבאים תוסף Google Workspace לבדיקה:

  1. פותחים את פרויקט הסקריפט בעורך Apps Script.
  2. לוחצים על Deploy > (פריסה) > בדיקת הפריסות.
  3. לחץ על התקן.
  4. בחלק התחתון, לוחצים על סיום.

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

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

איך מסירים תוסף שלא פורסם

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

  1. פותחים את פרויקט הסקריפט בעורך Apps Script.
  2. לוחצים על פריסה > בדיקת הפריסות.
  3. לוחצים על הסרה.
  4. בחלק התחתון, לוחצים על סיום.

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

שיטות מומלצות לבדיקה

בזמן הבדיקה של התוסף ל-Google Workspace, חשוב לוודא לפעול לפי השיטות המומלצות לפיתוח תוספים. בנוסף, חשוב לפעול בהתאם להנחיות הבאות:

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

  2. שימוש בנתוני בדיקה לדוגמה כדי להעריך את ההתנהגות של התוסף.

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

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

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