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

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

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

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

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

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

אפשר להתקין תוספים שלא פורסמו מתיבת הדו-שיח Deployments של Apps Script.

כדי להתקין תוסף ל-Google Workspace שלא פורסם לצורך בדיקה:

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

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

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

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

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

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

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

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

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

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

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

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

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

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