תיאור
משתמשים ב-API chrome.app.runtime
כדי לנהל את מחזור החיים של האפליקציה. סביבת זמן הריצה של האפליקציה מנהלת את התקנת האפליקציה, שולטת בדף האירוע ויכולה לכבות את האפליקציה בכל שלב.
סוגים
ActionData
תכונות
-
actionType
"new_note"
ActionType
ניתן להפעיל אפליקציה מסוימת מתוך מחשבה על פעולה ספציפית, לדוגמה, יצירת הערה חדשה. סוג הפעולה שאיתה האפליקציה הופעלה זמין בתוך השדה actionData
במופע של LaunchData.
ערך
"new_note"
EmbedRequest
תכונות
-
נתונים
כל אופציונלי
נתונים אופציונליים שצוינו על ידי המפתח, שבהם האפליקציה להטמעה יכולה להשתמש כדי לקבל החלטה בנוגע להטמעה.
-
embedderId
string
-
לאפשר
void
מאפשרת ל-
embedderId
להטמיע את האפליקציה הזו ברכיב <appview>. השדהurl
מציין את התוכן להטמעה.הפונקציה
allow
נראית כך:(url: string) => {...}
-
כתובת אתר
string
-
-
דחייה
void
embedderId
לא יוכל להטמיע את האפליקציה הזו ברכיב <appview>.הפונקציה
deny
נראית כך:() => {...}
LaunchData
תכונות
-
actionData
ActionData אופציונלי
Chrome 54 ואילךמכילה נתונים שמציינים את ה
ActionType
שאיתם האפליקציה הושקה. הערך הזה הוא null אם האפליקציה לא הושקה עם כוונה ספציפית לפעולה. -
id
מחרוזת אופציונלי
המזהה של הקובץ או ה-handler של כתובת ה-URL שאיתו האפליקציה מופעלת. מזהי handler הם המפתחות ברמה העליונה במילונים
file_handlers
אוurl_handlers
במניפסט. -
isKioskSession
ערך בוליאני אופציונלי
האם האפליקציה מופעלת בסשן קיוסק של Chrome OS.
-
isPublicSession
ערך בוליאני אופציונלי
Chrome מגרסה 47 ואילךהאם האפליקציה מופעלת בסשן ציבורי של Chrome OS.
-
פריטים
LaunchItem[] אופציונלי (אופציונלי)
רשומות הקובץ של האירוע
onLaunched
שהופעלו על ידי handler תואם של קבצים במפתח המניפסטfile_handlers
. -
referrerUrl
מחרוזת אופציונלי
כתובת ה-URL של הגורם המפנה לאירוע
onLaunched
, שהופעלה על ידי handler תואם של כתובת URL במפתח המניפסטurl_handlers
. -
source
LaunchSource אופציונלי
המקום שבו האפליקציה מופעלת.
-
כתובת אתר
מחרוזת אופציונלי
כתובת ה-URL של האירוע
onLaunched
שהופעל על ידי handler תואם של כתובת URL במפתח המניפסטurl_handlers
.
LaunchItem
תכונות
-
ערך
הערך
רשומה עבור הפריט.
-
סוג
מחרוזת אופציונלי
סוג ה-MIME של הקובץ.
LaunchSource
ספירת מקורות של הפעלות של אפליקציות. צריך לסנכרן את הנתונים האלה עם AppLaunchSource ברכיבים/services/app_service/public/mojom/types.mojom, ועם GetLaunchSourceEnum() בתוספים/browser/api/app_runtime/app_runtime_api.cc. שימו לב שהספירה משמשת בהיסטוגרמה של UMA, ולכן אין לסדר מחדש או להסיר רשומות.
טיפוסים בני מנייה (enum)
"untracked"
"new_tab_page"
"restart"
"load_and_launch"
"command_line"
"file_handler"
"url_handler"
"system_tray"
"about_page"
"extensions_page"
"management_api"
"ephemeral_app"
"chrome_internal"
"test"
"context_menu"
"arc"
"intent_url"
"app_home_page"
"focus_mode"
אירועים
onEmbedRequested
chrome.app.runtime.onEmbedRequested.addListener(
callback: function,
)
האירוע הזה מופעל כשאפליקציה מטמיעה מבקשת להטמיע את האפליקציה הזו. האירוע הזה זמין רק בערוץ פיתוח עם הדגל --enable-app-view.
פרמטרים
-
קריאה חוזרת (callback)
פונקציה
הפרמטר
callback
נראה כך:(request: EmbedRequest) => void
-
בקשה
-
onLaunched
chrome.app.runtime.onLaunched.addListener(
callback: function,
)
מופעל כשאפליקציה מופעלת ממרכז האפליקציות.
פרמטרים
-
קריאה חוזרת (callback)
פונקציה
הפרמטר
callback
נראה כך:(launchData?: LaunchData) => void
-
launchData
LaunchData אופציונלי
-
onRestarted
chrome.app.runtime.onRestarted.addListener(
callback: function,
)
הופעלו במהלך ההפעלה של Chrome לאפליקציות שרצו בפעם האחרונה ש-Chrome נסגר, או כשנשלחה בקשה להפעלה מחדש של אפליקציות מהמצב הקודם שלהן מסיבות אחרות (למשל, אם המשתמש מבטל את הגישה לקבצים שנשמרו באפליקציה, בזמן הריצה האפליקציה תופעל מחדש). במצבים האלה, אם לאפליקציות אין handler של onRestarted
, הם יקבלו אירוע onLaunched
במקום זאת.
פרמטרים
-
קריאה חוזרת (callback)
פונקציה
הפרמטר
callback
נראה כך:() => void