כדי ליצור תוסף לעריכה, פועלים לפי התהליך הכללי הבא:
- יוצרים פרויקט Apps Script.
- כותבים קוד כדי להגדיר את המראה וההתנהגות של התוסף, באמצעות שירות ה-HTML המובנה של Apps Script.
- בודקים את התוסף.
- מפרסמים את התוסף.
יצירת פרויקט סקריפט
תוסף ל-Editor הוא פרויקט נפרד של Apps Script. במדריך ל-Script עצמאי מפורטות הוראות ליצירת פרויקטים חדשים.
אפשר גם לפתוח סקריפט חדש.
אם תעשו זאת, קובץ הפרויקט (שנקרא בהתחלה Untitled project) יופיע בתיקיית השורש שלכם ב-Drive.
שיתוף פעולה
כשעובדים בשיתוף עם אחרים על פיתוח תוסף, חשבון משתמש אחד הוא הבעלים של פרויקט התוסף. כשמפרסמים תוסף, חשבון משתמש אחד משמש כבעלים של התוסף. לחשבון הפרסום צריכה להיות הרשאת עריכה לפרויקט הסקריפט של התוסף, אבל הוא לא חייב להיות הבעלים של הפרויקט.
חשוב מאוד להימנע ממצבים שבהם אתם עלולים לאבד את הגישה לקוד או להגדרות של תוסף כי הבעלים של הפרויקט עזב את הארגון.
כדי למנוע אובדן גישה לקוד של התוסף, מומלץ להשתמש באחסון משותף כשעובדים על תוסף בשיתוף פעולה. שמירת קובץ הסקריפט של התוסף באחסון שיתופי מבטיחה שאף חשבון לא יהיה הבעלים היחיד של הפרויקט.
מומלץ גם להוסיף שותפים לפרויקט Cloud Platform (GCP) של סקריפט. כך תמיד יהיה מישהו בצוות שלכם עם גישה להגדרות Cloud של התוסף.
כתיבת הקוד של התוסף
אחרי שיוצרים פרויקט סקריפט, אפשר להתחיל לכתוב קוד כדי להגדיר את המראה וההתנהגות של התוסף. משתמשים ב-HtmlService של Apps Script כדי ליצור את ממשק המשתמש של התוסף – תיבות דו-שיח וסרגלי צד – באמצעות HTML ו-CSS רגילים. תוספי העריכה יכולים גם להגדיר פריטי תפריט בהתאמה אישית.
בזמן הכתיבה, כדאי לעיין במדריך הסגנון של התוספים ל-Editor כדי לקבל הנחיות לעיצוב חוויית המשתמש של התוסף. בנוסף, חשוב להבין את המצבים השונים במחזור החיים של ההרשאה שהתוסף עשוי להיתקל בהם, ולתכנת בהתאם.
בדיקת התוסף
אתם יכולים לבדוק תוספים ל-Editor לפני הפרסום שלהם כדי לוודא שהם פועלים כצפוי. כדי לבצע בדיקה, צריך ליצור הגדרת בדיקה ולהשתמש במסמך, בגיליון אלקטרוני, בטופס או במצגת לצורך בדיקה.
פרטים נוספים זמינים במאמר בדיקת תוסף ל-Editor.
פרסום התוסף
פרסום התוסף יאפשר לאחרים להשתמש בו, באופן ציבורי או רק למשתמשים בדומיין שלכם. לפני שמתחילים בתהליך הפרסום, חשוב לעיין בסקירה הכללית על אתר החדשות.
תוספים לעורכים מתפרסמים ב-Google Workspace Marketplace. תוספים שזמינים לכולם חייבים לעבור בדיקה לפני הפרסום.
פרטים נוספים זמינים במאמר פרסום תוסף לעריכה.