ספרייה היא פרויקט סקריפט שאפשר לעשות בו שימוש חוזר בפונקציות בסקריפטים אחרים.
קבלת גישה לספרייה
כדי לכלול ספרייה בפרויקט, צריכה להיות לכם לפחות רמת תצוגה ברמת התצוגה לגשת אליו. אם אתם לא המחברים של הספרייה שאתם רוצים כוללים, יש לפנות למחבר ולבקש גישה.
צריך לדעת את מזהה הסקריפט של הספרייה שרוצים לכלול. אחרי שיש לך לספרייה. מזהה הסקריפט זמין בהגדרות הפרויקט דף
.הוספת ספרייה לפרויקט הסקריפטים
- מימין לעורך Apps Script, לצד 'ספריות'. לוחצים על 'הוספה לספרייה.
- בקטע 'מזהה סקריפט' בשדה, מדביקים את מזהה הסקריפט של הספרייה.
- לוחצים על חיפוש.
- לוחצים על התפריט הנפתח גרסה ובוחרים את גרסת הספרייה. לשימוש.
- בודקים אם ערך ברירת המחדל של 'מזהה' הוא הוא השם שרוצים
לשימוש בספרייה הזו. זה השם שבו הסקריפט משתמש כדי
להתייחס לספרייה. לדוגמה, אם הגדרת את הערך
Test
, תוכל קוראים ל-method של הספרייה הזו, באופן הבא:Test.libraryMethod()
. - לוחצים על הוספה.
שימוש בספרייה
משתמשים בספרייה הכלולה כמו שמשתמשים בשירות ברירת מחדל. עבור
לדוגמה, אם Test
הוא המזהה של הספרייה, צריך להקליד
Test
ומיד אחריה נקודה כדי לראות את רשימת השיטות בספרייה.
ניתן לפתוח את מאמרי העזרה של ספרייה כלולה באמצעות הפעולות הבאות: את השלבים הבאים:
בצד ימין של עורך הסקריפטים, לצד שם הספרייה, לוחצים על סמל האפשרויות הנוספות
> פתיחה בכרטיסייה חדשה.הסרת ספרייה
בצד ימין של עורך הסקריפטים, לצד שם הספרייה, לוחצים על סמל האפשרויות הנוספות
> הסרה > הסרת הספרייהעדכון ספרייה
אפשר לשנות את גרסת הספרייה או לעדכן את המזהה שלה.
- מימין לעורך, בקטע 'ספריות', לוחצים על שם הספרייה.
- מבצעים את השינויים הרצויים ולוחצים על שמירה.
יצירה ושיתוף של ספרייה
כדי להשתמש בפרויקט הסקריפט ולשתף אותו כספרייה, צריך לפעול לפי השלבים הבאים.
- יצירת פריסה עם גרסאות של הסקריפט.
- כדאי לשתף גישה ברמת תצוגה לפחות עם כל המשתמשים הפוטנציאליים בספרייה.
- נותנים למשתמשים האלה את מזהה הסקריפט, שמופיע בפרויקט הגדרות .
שיטות מומלצות
הנה כמה הנחיות לכתיבת ספרייה:
- לבחור שם בעל משמעות לפרויקט כי הוא משמש כברירת מחדל, כשהספרייה שלכם כלולה על ידי אחרים.
- אם רוצים שאחת או יותר מהשיטות של הסקריפט לא יהיו גלויות (וגם
שימושי) למשתמשי הספרייה, תוכל לסיים את שם ה-method באמצעות
קו תחתון. לדוגמה,
myPrivateMethod_()
. - רק נכסים גלובליים שניתנים לספירה גלויים למשתמשי הספרייה. זה כולל פונקציה
הצהרות, משתנים שנוצרו מחוץ לפונקציה עם
var
ומאפיינים שהוגדרו במפורש על האובייקט הגלובלי. לדוגמה,Object.defineProperty()
עםenumerable
מוגדר ל-false
יוצר סמל שבו ניתן להשתמש בספרייה, אבל המשתמשים לא יכולים לגשת לסמל. אם ברצונך שמשתמשי הספרייה שלך ישתמשו בהשלמה אוטומטית של עורך הסקריפטים התיעוד שנוצר באופן אוטומטי, נדרש בסגנון JSDoc תיעוד של כל הפונקציות. לדוגמה:
/** * Raises a number to the given power, and returns the result. * * @param {number} base the number we're raising to a power * @param {number} exp the exponent we're raising the base to * @return {number} the result of the exponential calculation */ function power(base, exp) { ... }
קביעת היקף המשאבים
יש שני סוגי משאבים בעבודה עם ספריות: משותפות ולא בשיתוף. המשמעות של משאב משותף היא שגם הספרייה וגם לסקריפט יש גישה מובנית לאותו מופע של המשאב. התרשים הבא מדגים משאב משותף באמצעות הדוגמה מאפייני משתמש:
המשמעות של משאב לא-משותף היא שגם הספרייה וגם הסקריפט הכלול בו יש גישה מובנית רק למופע של המשאב. אבל הספרייה יכולה נותנת גישה למשאבים שלא משותפים באמצעות פונקציות מפורשות לפעול לפיהם. דוגמה לפונקציה שצריך לכלול הספרייה כדי לחשוף את מאפייני הסקריפטים שלה:
function getLibraryProperty(key) {
return ScriptProperties.getProperty(key);
}
בתרשים הבא מוצג משאב לא משותף, באמצעות הדוגמה של מאפייני סקריפט:
בטבלה הזו מפורטים המשאבים המשותפים והמשאבים שלא משותפים לעיונך:
משאב | משותף* | לא משותף** | הערות |
---|---|---|---|
נעילה | אותו מופע גלוי לכל, כולל הסקריפטים כשהם נוצרים ב- בספרייה. | ||
מאפייני הסקריפט | אותו מופע גלוי לכל, כולל הסקריפטים כשהם נוצרים ב- בספרייה. | ||
מטמון | אותו מופע גלוי לכל, כולל הסקריפטים כשהם נוצרים ב- בספרייה. | ||
טריגרים | טריגרים פשוטים שנוצרים בספרייה לא מופעלים על ידי הכלל סקריפט. | ||
ScriptApp | |||
UiApp |
|
||
מאפייני המשתמש | |||
תמליל ותמליל הביצוע | |||
Google Sites, Sheets ומאגרים אחרים | קריאה ל-getActive() מחזירה את הקונטיינר של
כולל סקריפט. |
||
MailApp ו-GmailApp | |||
* המשמעות היא שלספרייה אין מופע משלה
ובמקום זאת הוא משתמש במשאב שנוצר על ידי הסקריפט
שהפעיל אותה.
** כלומר, לספרייה יש מופע משלה של המשאב או התכונה ושכל הסקריפטים שמשתמשים בספרייה משתפים ויש להם גישה אותו מופע. |
בדיקת ספרייה
כדי לבדוק את הספרייה, צריך להשתמש בפריסת הראש. כל מי שיש לו הרשאת עריכה גישה לסקריפט יכולה להשתמש בפריסת כותרת.
ניפוי באגים בספרייה
כשמשתמשים בכלי לניפוי באגים בפרויקט שכולל ספרייה יכול להיכנס לפונקציה של הספרייה הכלולה. הקוד מופיע את הכלי לניפוי באגים במצב תצוגה בלבד ובגרסה הנכונה.