כשמפרסמים תוסף, המשתמשים יכולים להתקין אותו דרך אפליקציית המארח או דרך Google Workspace Marketplace. לפני שאתם מפרסמים תוספים שפיתחתם, אתם צריכים לבדוק אותם באפליקציות המארחות שהם מרחיבים.
בדף הזה מוסבר איך להתקין תוסף שנמצא בפיתוח (נקרא תוסף לא גלוי או תוסף למפתחים) לצורך בדיקה או שימוש אישי. אפשר גם לנפות באגים בתוספים באמצעות כלי לניפוי באגים ונקודות עצירה בסביבת הפיתוח המשולבת (IDE) של Apps Script.
דרישות מוקדמות
- צריכה להיות לכם הרשאת עריכה בפרויקט הסקריפט של התוסף.
- כדי לאפשר לאנשים אחרים בארגון לבדוק את התוסף, צריך לתת להם גישת עריכה לפרויקט הסקריפט. פרטים נוספים על מתן גישה זמינים במאמר שיתוף פעולה עם מפתחים אחרים.
התקנה של תוסף שלא פורסם
אפשר להתקין תוספים שלא פורסמו מתיבת הדו-שיח Deployments (פריסות) ב-Apps Script.
כדי להתקין תוסף ל-Google Workspace שלא פורסם לצורך בדיקה:
- פותחים את פרויקט הסקריפט בכלי לעריכת סקריפטים של Apps Script.
- לוחצים על פריסה > בדיקת פריסות.
- לוחצים על התקנה.
- למטה, לוחצים על סיום.
אתם יכולים לשתף את פרויקט Apps Script עם חשבון של משתמשים אחרים (נדרשת גישת עריכה) כדי לאפשר להם לבדוק את התוסף. לאחר מכן מבקשים מהמשתמשים לפעול לפי השלבים שלמעלה.
אחרי ההתקנה, התוסף זמין באופן מיידי באפליקציות המארחות שהוא מרחיב. יכול להיות שתצטרכו לרענן את הכרטיסייה של אפליקציית המארח לפני שהתוסף יופיע. בנוסף, צריך לתת הרשאה לתוסף לפני שמשתמשים בו. אם הפרויקט כבר קיבל הרשאה, אפשר להשתמש ב-ScriptApp.invalidateAuth כדי לבטל את ההרשאות הקיימות, וכך לבדוק את התכונה הרשאות מפורטות של OAuth בתוסף.
הסרת תוסף שלא פורסם
כדי להסיר פריסה של תוסף שלא פורסם:
- פותחים את פרויקט הסקריפט בכלי לעריכת סקריפטים של Apps Script.
- לוחצים על פריסה > בדיקת פריסות.
- לוחצים על הסרה.
- למטה, לוחצים על סיום.
השלבים האלה מסירים מיד את הפריסה, והתוסף לא מופיע יותר באף אפליקציית מארח. אפשר להתקין מחדש את הפריסה בכל שלב על ידי חזרה על תהליך ההתקנה.
שיטות מומלצות לבדיקות
במהלך הבדיקה של התוסף ל-Google Workspace, חשוב לפעול לפי השיטות המומלצות לפיתוח תוספים. בנוסף, חשוב לבצע את הפעולות הבאות:
חשוב לבדוק היטב את תהליכי הניווט בכרטיסים בכל האפליקציות המארחות שהתוסף מרחיב. מוודאים שההתנהגות של התוסף נכונה כשהמשתמש עובר מהקשר להקשר, ובין כרטיסים לא הקשריים לכרטיסים הקשריים.
משתמשים בנתוני בדיקה לדוגמה כדי להעריך את ההתנהגות של התוסף.
אם התוסף מתחבר ל-API או לשירות אחר של צד שלישי, צריך לוודא שאפשר לגשת לשירות והוא פועל כמצופה. חשוב לוודא שהתוסף מטפל בהרשאה ובפרטי הכניסה בצורה נכונה.
חשוב לוודא שכל תנאי השגיאה מטופלים בצורה נכונה. משתמשים בכרטיסי שגיאה במקרים שנדרש.
חשוב לשים לב לביצועים של התוסף. אם מבצעים שינוי בקוד והתוסף מתחיל לפעול לאט יותר, יכול להיות שצריך להסיר את התכונה הזו או לשנות אותה.